การประมวลผลแบบกลุ่ม

แม้ว่าบริการส่วนใหญ่จะมี API แบบซิงโครนัสที่กำหนดให้คุณต้องส่งคำขอ แล้วรอการตอบกลับ แต่ BatchJobService มี วิธีดำเนินการเป็นชุดๆ กับบริการหลายรายการโดยไม่ต้องรอให้การดำเนินการเสร็จสมบูรณ์แบบซิงโครนัส

` BatchJobService` สามารถดำเนินการกับคอลเล็กชันแบบผสมของ แคมเปญ กลุ่มโฆษณา โฆษณา เกณฑ์ ป้ายกำกับ และชิ้นงานได้ ซึ่งแตกต่างจากการดำเนินการเปลี่ยนแปลงที่เฉพาะเจาะจงกับบริการ งานที่ส่งจะทำงานแบบขนาน และ BatchJobService จะลองดำเนินการอีกครั้งโดยอัตโนมัติหากการดำเนินการล้มเหลวเนื่องจากข้อผิดพลาดชั่วคราว เช่น ข้อผิดพลาดในการจำกัดอัตราคำขอ Google Ads API จะยังคงนับการดำเนินการแต่ละรายการรวมกับ ขีดจำกัดการดำเนินการรายวันตาม วิธีการนับการดำเนินการ API

BatchJobService ยังช่วยให้คุณใช้ รหัสชั่วคราวภายในคำขอได้ด้วย เพื่อให้คุณส่งการดำเนินการที่ขึ้นอยู่กับรายการอื่น ในงานเดียวได้

การดำเนินการ

BatchJobService รองรับการดำเนินการทั้งหมดที่ระบุไว้ใน MutateOperation ซึ่งบริการพื้นฐานรองรับ การล้มเหลวบางส่วน รวมถึง AssetGroupOperation และ AssetGroupListingGroupFilterOperation ซึ่งได้รับการยกเว้นอย่างชัดเจนและดำเนินการ (พร้อมกับการดำเนินการที่ขึ้นอยู่กับรายการอื่น) ใน ชุดย่อยแบบอะตอมมิก

เนื่องจาก Google Ads API จะดำเนินการมาตรฐานในงานที่ เปิดใช้การล้มเหลวบางส่วน (ยกเว้นภายใน ชุดย่อยแบบอะตอมมิก) ดังนั้นหากมีการยกเลิกงานหรือ การดำเนินการแต่ละรายการล้มเหลว ระบบจะ ไม่ ยกเลิกการดำเนินการที่สำเร็จ

การดำเนินการต่อไปนี้ใน MutateOperation ต้องเป็น อะตอมมิก และไม่รองรับการล้มเหลวบางส่วน จึงไม่รองรับ ภายในงานแบบกลุ่ม การเพิ่มการดำเนินการใดๆ เหล่านี้ลงในงานแบบกลุ่ม จะแสดงข้อผิดพลาด MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE (หรือ InternalError.INTERNAL_ERROR สำหรับ BookCampaignsOperation และ QuoteCampaignsOperation) ให้ดำเนินการโดยใช้ GoogleAdsService.Mutate โดยตั้งค่า partial_failure เป็น false (และตั้งค่า validate_only เป็น true สำหรับ QuoteCampaignsOperation)

การดำเนินการที่ไม่รองรับใน BatchJobService

ถัดไป
ขั้นตอนการใช้งาน