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

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

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

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

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

BatchJobService รองรับการดำเนินการทั้งหมดที่ระบุไว้ใน MutateOperation โดยมีข้อยกเว้นที่สำคัญบางประการ

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

การดำเนินการต่อไปนี้ใน MutateOperation ต้องเป็นแบบอะตอม ดังนั้นจึงไม่รองรับการทำงานล้มเหลวบางส่วน และไม่รองรับภายในงานแบบกลุ่ม หลีกเลี่ยงการเพิ่มการดำเนินการเหล่านี้ลงใน งาน ตั้งค่า partial_failure เป็น false ในคำขอ และใช้วิธี mutate ใน GoogleAdsService แทน

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

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