การใช้รหัสชั่วคราว

ฟีเจอร์ที่ทรงพลังของ BatchJobService คือ รองรับการใช้รหัสชั่วคราว

คุณทำได้โดยการระบุ resource_name ของทรัพยากรใหม่ให้ใช้รหัสติดลบ เช่น สมมติว่าคุณสร้างแคมเปญและระบุชื่อทรัพยากรเป็น customers/<YOUR_CUSTOMER_ID>/campaigns/-1 เมื่อสร้าง กลุ่มโฆษณาในการดำเนินการในภายหลัง คุณจะอ้างอิงกลุ่มโฆษณานั้นตามชื่อทรัพยากร และ -1 ที่ระบุไว้ได้ โดยระบบจะแทนที่ด้วยรหัสจริงของแคมเปญที่สร้างขึ้น โดยอัตโนมัติ

สิ่งที่ควรคำนึงถึงเมื่อใช้ชื่อทรัพยากรชั่วคราวมีดังนี้

• ชื่อทรัพยากรชั่วคราวจะใช้ได้ก็ต่อเมื่อม��การกำหนดไว้ใน ทรัพยากรแล้ว ในตัวอย่างต่อไปนี้ การดำเนินการกลุ่มโฆษณาจะต้อง ปรากฏหลังการดำเนินการแคมเปญในรายการการดำเนินการ
• ระบบจะไม่จดจำชื่อทรัพยากรชั่วคราวในงานหรือคำขอเปลี่ยนแปลง หากต้องการอ้างอิงทรัพยากรที่สร้างขึ้นในงานหรือคำขอเปลี่ยนแปลงก่อนหน้า ให้ใช้ชื่อทรัพยากรจริง
• สำหรับคำขอเดียวหรือคำขอเปลี่ยนแปลง ชื่อทรัพยากรชั่วคราวแต่ละชื่อต้องใช้ ตัวเลขลบที่ไม่ซ้ำกัน แม้ว่าจะเป็นทรัพยากรประเภทต่างๆ ก็ตาม หากมีการนำรหัสชั่วคราวมาใช้ซ้ำในงานเดียวหรือคำขอเปลี่ยนแปลง ระบบจะแสดงข้อผิดพลาด

ตัวอย่าง

สมมติว่าคุณต้องการเพิ่มแคมเปญ กลุ่มโฆษณา และโฆษณาในคำขอ API เดียว คุณจะสร้างโครงสร้างสำหรับคำขอในลักษณะเดียวกับ ต่อไปนี้

mutate_operations: [
  {
    campaign_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1",
        ...
      }
    }
  },
  {
    ad_group_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2",
        campaign: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1"
        ...
      }
    }
  },
  {
    ad_group_ad_operation: {
      create: {
        ad_group: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2"
        ...
      }
    }
  },
]

ระบบจะใช้รหัสชั่วคราวใหม่สำหรับกลุ่มโฆษณา เนื่องจากเราไม่สามารถนำ -1 ที่ใช้กับแคมเปญมาใช้ซ้ำได้ นอกจากนี้ เรายังอ้างอิงกลุ่มโฆษณานี้เมื่อสร้างโฆษณากลุ่มโฆษณาด้วย กลุ่มโฆษณาอ้างอิงชื่อทรัพยากรที่เราสร้างขึ้นสำหรับ แคมเปญในการดำเนินการก่อนหน้านี้ในคำขอ ส่วน resource_name ใน ad_group_ad_operation ไม่จำเป็นเนื่องจากไม่มีการดำเนินการเพิ่มเติม ที่อ้างอิงถึง