เปลี่ยนแปลงทรัพยากร

Google Ads API มีวิธีเปลี่ยนแปลงทรัพยากรหลายวิธีตามกรณีการใช้งานของคุณ ดังนี้

  • การเปลี่ยนแปลงบริการทรัพยากร: ทรัพยากรที่เปลี่ยนแปลงได้แต่ละรายการมีบริการเฉพาะที่ดำเนินการสำหรับการทำงานของทรัพยากรประเภทนั้นๆ ตัวอย่างเช่น ทรัพยากร Campaign ใช้ปลายทาง CampaignService.MutateCampaigns เพื่อสร้าง อัปเดต หรือนำแคมเปญออก
  • การเปลี่ยนแปลงหลายรายการพร้อมกัน: ปลายทาง GoogleAdsService.Mutate จะรวมลำดับของการดำเนินการเปลี่ยนแปลงในทรัพยากรหลายประเภท (และการดำเนินการที่รองรับ เช่น การจองหรือการเสนอราคาแคมเปญ) ไว้ในคำขอที่โหลดแบบซิงโครนัสรายการเดียว
  • งานแบบกลุ่มแบบอะซิงโครนัส: สำหรับการเปลี่ยนแปลงขนาดใหญ่หรือภาระงานที่ใช้เวลานาน BatchJobService จะดำเนินการแบบอะซิงโครนัสโดยไม่เสี่ยงต่อการหมดเวลาของคำขอที่โหลดแบบซิงโครนัส BatchJobService จะทำงานภายใต้ความหมายของความล้มเหลวบางส่วนเสมอและไม่รองรับโหมด validate_only หรือการดำเนินการ (book_campaigns_operation, quote_campaigns_operation) ซึ่งต่างจาก GoogleAdsService.Mutate เนื่องจากความล้มเหลวบางส่วนทำงานอยู่เสมอ BatchJobService จึงปฏิเสธการดำเนินการกับทรัพยากรที่บริการเบื้องหลังไม่รองรับความล้มเหลวบางส่วน (เช่น CustomerOperation, CampaignConversionGoalOperation, ConversionGoalCampaignConfigOperation, CustomConversionGoalOperation และ CustomerConversionGoalOperation) โดยมี MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE

ประโยชน์ของการเปลี่ยนแปลงหลายรายการพร้อมกัน

การใช้ GoogleAdsService.Mutate มีประโยชน์ดังต่อไปนี้ (ดูคำแนะนำในการติดตั้งใช้งานได้ที่แนวทางปฏิบัติแนะนำในการเปลี่ยนแปลง)

  • การดำเนินการที่จัดกลุ่มในบริการทรัพยากรต่างๆ: แม้ว่าการเรียกใช้บริการทรัพยากรแต่ละรายการจะยอมรับเฉพาะการดำเนินการสำหรับทรัพยากรประเภทเดียว แต่ GoogleAdsService.Mutate ช่วยให้คุณเปลี่ยนแปลงทรัพยากรหลายประเภทได้ในการเรียกใช้ครั้งเดียว
  • ชื่อทรัพยากรชั่วคราว: คุณสามารถกำหนดรหัสจำนวนเต็มลบ (เช่น customers/CUSTOMER_ID/campaigns/-1) ให้กับเอนทิตีหลักที่สร้างขึ้นใหม่ และอ้างอิงรหัสชั่วคราวเหล่านั้นในการดำเนินการย่อยภายในคำขอเดียวกัน

ความสามารถเหล่านี้ช่วยให้คุณใช้ GoogleAdsService.Mutate เพื่อสร้างลำดับชั้นของแคมเปญทั้งหมดแบบอะตอมเพื่อให้การดำเนินการทั้งหมดสำเร็จหรือล้มเหลวพร้อมกัน หรือตั้งค่า partial_failure เป็น true เพื่อดำเนินการที่ถูกต้องอย่างเป็นอิสระ

ถัดไป
ทรัพยากรเปลี่ยนแปลง