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

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

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