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