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

แม้ว่าบริการส่วนใหญ่จะมี 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

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