แม้ว่าบริการส่วนใหญ่จะมี API แบบซิงโครนัสที่กำหนดให้คุณต้องส่งคำขอ
แล้วรอการตอบกลับ แต่ BatchJobService
มีวิธีดำเนินการเป็นกลุ่มในหลายบริการโดยไม่ต้อง
รอให้การดำเนินการเสร็จสมบูรณ์แบบซิงโครนัส
การดำเนินการเปลี่ยนแปลงใน BatchJobService
จะทำงานกับคอลเล็กชันแบบผสมของแคมเปญ กลุ่มโฆษณา โฆษณา เกณฑ์ ป้ายกำกับ และรายการฟีดได้ ซึ่งแตกต่างจากการดำเนินการเปลี่ยนแปลงที่เฉพาะเจาะจงบริการ
งานที่ส่งจะทำงานแบบขนาน และ BatchJobService
จะลองอีกครั้งโดยอัตโนมัติ
สำหรับการดำเนินการที่ไม่สำเร็จเนื่องจากข้อผิดพลาดชั่วคราว เช่น ข้อผิดพลาดเกี่ยวกับโควต้า
Google Ads API ยังคงนับการดำเนินการแต่ละรายการตามขีดจํากัดการดําเนินการรายวัน
ตามวิธีการนับการดําเนินการของ API
BatchJobService
ยังช่วยให้คุณใช้รหัสชั่วคราวภายในคำขอได้ด้วย
เพื่อให้คุณส่งการดำเนินการที่ขึ้นต่อกันในงานเดียวได้
การดำเนินการ
BatchJobService
รองรับการดำเนินการทั้งหมดที่ระบุไว้ใน
MutateOperation
โดยมีข้อยกเว้นที่สำคัญ
บางประการ
เนื่องจาก Google Ads API ดำเนินการทั้งหมดในงานโดยเปิดใช้การล้มเหลวบางส่วน หากมีการยกเลิกงานหรือการดำเนินการแต่ละรายการล้มเหลว ระบบจะไม่ย้อนกลับการดำเนินการที่สำเร็จ
การดำเนินการต่อไปนี้ใน MutateOperation
ต้องเป็นแบบอะตอม ดังนั้นจึงไม่รองรับการทำงานล้มเหลวบางส่วน
และไม่รองรับภายในงานแบบกลุ่ม หลีกเลี่ยงการเพิ่มการดำเนินการเหล่านี้ลงใน
งาน ตั้งค่า partial_failure
เป็น false
ในคำขอ และใช้วิธี mutate
ใน GoogleAdsService
แทน
การดำเนินการที่ไม่รองรับใน BatchJobService
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation