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