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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

ฟีเจอร์ที่มีประสิทธิภาพของ 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 นั้นไม่จําเป็นเนื่องจากไม่มีการดำเนินการเพิ่มเติมที่อ้างอิงถึง