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

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

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

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

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

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

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

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

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

เพย์โหลด REST JSON ต่อไปนี้แสดงคำขอไปยัง 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 ประการดังนี้

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

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

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

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

• บริการเป้าหมายวงจรลูกค้า: เป้าหมายการรักษาลูกค้าจะเปลี่ยนแปลงในทุกเวอร์ชันที่รองรับผ่าน GoalService.MutateGoals (retention_goal_settings) และ CampaignGoalConfigService.MutateCampaignGoalConfigs (campaign_retention_settings) โดยใช้ฟิลด์ operations ที่ซ้ำได้มาตรฐาน ใน v25 ขึ้นไป การได้ลูกค้าใหม่ (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 แบบเอกพจน์