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

การใช้บริการเฉพาะของทรัพยากรเป็นวิธีที่ตรงที่สุดในการสร้าง อัปเดต หรือนำเอนทิตีของทรัพยากรประเภทเดียวใน Google Ads API ออก

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

ทรัพยากรที่เปลี่ยนแปลงได้แต่ละรายการจะมีบริการและประเภทการดำเนินการที่เกี่ยวข้อง หากต้องการเปลี่ยนแปลง ทรัพยากรโดยใช้บริการเฉพาะของทรัพยากรนั้น ให้ป้อนข้อมูลในช่องใดช่องหนึ่งต่อไปนี้ใน การดำเนินการ แล้วส่งไปยังปลายทางการเปลี่ยนแปลงของบริการ

• สร้าง (create): ออบเจ็กต์ทรัพยากรใหม่ที่จะสร้าง
• อัปเดต (update): ออบเจ็กต์ทรัพยากรที่แก้ไข พร้อมด้วย update_mask ที่ระบุฟิลด์ที่เปลี่ยนแปลง
• นำออก (remove): สตริง resource_name ของทรัพยากรเป้าหมายที่จะ นำออก

เช่น หากต้องการสร้าง Campaign ใหม่ ให้ทำตามขั้นตอนต่อไปนี้

1. สร้างออบเจ็กต์ Campaign ด้วยแอตทริบิวต์ที่คุณเลือก
2. กำหนดให้กับฟิลด์ create ของ CampaignOperation
3. ส่งการดำเนินการใน MutateCampaignsRequest ไปยัง CampaignService.MutateCampaigns

รูปแบบเดียวกันนี้ใช้กับบริการเฉพาะทรัพยากรทั้งหมดใน Google Ads API ดังนี้

• AdGroup: ส่ง AdGroupOperation ไปยัง AdGroupService.MutateAdGroups
• CampaignCriterion: ส่ง CampaignCriterionOperation ไปยัง CampaignCriterionService.MutateCampaignCriteria

เพย์โหลด JSON ของ REST ต่อไปนี้แสดงคำขอไปยัง CampaignService.MutateCampaigns

{
  "customerId": "CUSTOMER_ID",
  "operations": [
    {
      "create": {
        "name": "Interplanetary Cruise #1",
        "advertisingChannelType": "SEARCH",
        "status": "PAUSED",
        "manualCpc": {},
        "campaignBudget": "customers/CUSTOMER_ID/campaignBudgets/BUDGET_ID",
        "containsEuPoliticalAdvertising": "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
      }
    }
  ],
  "partialFailure": false,
  "validateOnly": false
}

การดำเนินการและข้อจำกัดหลายอย่าง

คำขอเปลี่ยนแปลงที่เฉพาะเจาะจงกับทรัพยากรส่วนใหญ่ยอมรับoperationsฟิลด์ที่ทำซ้ำได้ ดังนั้น คำขอเดียวจึงสามารถมีการดำเนินการหลายรายการสำหรับประเภททรัพยากรนั้น (สูงสุด 10,000 รายการต่อคำขอ หรือ 20,000 รายการสำหรับ AdGroupCriterionService.MutateAdGroupCriteria; CustomerService.MutateCustomer ยอมรับฟิลด์ operation รายการเดียว) โดยค่าเริ่มต้น การดำเนินการทั้งหมดในคำขอจะดำเนินการแบบอะตอมมิก เว้นแต่ว่าบริการจะรองรับ partial_failure และคุณตั้งค่าเป็น true

อย่างไรก็ตาม บริการทรัพยากรแต่ละรายการมีข้อจำกัดที่สำคัญ 2 ประการดังนี้

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

หากต้องการเปลี่ยนแปลงทรัพยากรหลายประเภทในคำขอเดียวหรืออ้างอิงชื่อทรัพยากรชั่วคราวในทรัพยากรประเภทต่างๆ ให้ใช้ GoogleAdsService.Mutate แทน

ความแตกต่างเฉพาะเวอร์ชัน

โปรดคำนึงถึงความแตกต่างต่อไปนี้ใน Google Ads API เวอร์ชันที่รองรับเมื่อ แก้ไขทรัพยากร

• บริการเป้าหมายวงจรลูกค้า: เป้าหมายการรักษาลูกค้าจะได้รับการเปลี่ยนแปลงในทุกเวอร์ชันที่รองรับผ่าน GoalService.MutateGoals (retention_goal_settings) และ CampaignGoalConfigService.MutateCampaignGoalConfigs (campaign_retention_settings) โดยใช้ฟิลด์ operations ที่ทำซ้ำมาตรฐาน ในเวอร์ชัน 25 ขึ้นไป ระบบจะแก้ไขการได้ลูกค้าใหม่ (new_customer_acquisition_goal_settings / campaign_new_customer_acquisition_settings) และการรักษาลูกค้าจากโปรแกรมสะสมคะแนน (loyalty_retention_goal_settings / campaign_loyalty_retention_settings) ผ่าน GoalService.MutateGoals และ CampaignGoalConfigService.MutateCampaignGoalConfigs ด้วย ซึ่งจะแทนที่ CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals และ CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals ซึ่งใช้สำหรับการได้ลูกค้าใหม่ใน v23 และ v24 และยอมรับฟิลด์ operation เดียว