Dịch vụ tài nguyên biến đổi

Sử dụng dịch vụ chuyên biệt của tài nguyên là cách trực tiếp nhất để tạo, cập nhật hoặc xoá các thực thể của một loại tài nguyên duy nhất trong API Google Ads.

Điểm cuối thay đổi

Mỗi tài nguyên có thể thay đổi đều có một dịch vụ và loại thao tác tương ứng. Để thay đổi một tài nguyên bằng dịch vụ chuyên dụng của tài nguyên đó, hãy điền vào một trong các trường sau đây trong thao tác và gửi thao tác đó đến điểm cuối thay đổi của dịch vụ:

  • Tạo (create): Một đối tượng tài nguyên mới cần tạo.
  • Cập nhật (update): Đối tượng tài nguyên đã sửa đổi, kèm theo update_mask chỉ định các trường đã thay đổi.
  • Xoá (remove): Chuỗi resource_name của tài nguyên mục tiêu cần xoá.

Ví dụ: để tạo một Campaign mới, hãy hoàn tất các bước sau:

  1. Tạo một đối tượng Campaign có các thuộc tính bạn chọn.
  2. Chỉ định giá trị này cho trường create của CampaignOperation.
  3. Gửi thao tác trong MutateCampaignsRequest đến CampaignService.MutateCampaigns.

Mẫu này áp dụng cho tất cả các dịch vụ dành riêng cho tài nguyên trong Google Ads API:

Tải trọng JSON REST sau đây minh hoạ một yêu cầu đến 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
}

Nhiều thao tác và giới hạn

Hầu hết các yêu cầu thay đổi tài nguyên theo tài nguyên cụ thể đều chấp nhận trường operations lặp lại, vì vậy, một yêu cầu có thể chứa nhiều thao tác cho loại tài nguyên đó (tối đa 10.000 thao tác cho mỗi yêu cầu hoặc 20.000 thao tác cho AdGroupCriterionService.MutateAdGroupCriteria; CustomerService.MutateCustomer chấp nhận một trường operation). Theo mặc định, tất cả các thao tác trong yêu cầu đều thực thi một cách riêng lẻ, trừ phi dịch vụ hỗ trợ partial_failure và bạn đặt giá trị này thành true.

Tuy nhiên, các dịch vụ tài nguyên riêng lẻ có hai hạn chế quan trọng:

  • Một loại tài nguyên: Yêu cầu đối với một dịch vụ tài nguyên chỉ có thể thay đổi các tài nguyên do dịch vụ cụ thể đó quản lý.
  • Không có mã tạm thời trên nhiều tài nguyên: Vì lệnh gọi thay đổi theo tài nguyên cụ thể chỉ chấp nhận một loại tài nguyên, nên bạn không thể chỉ định mã tạm thời âm cho tài nguyên mẹ (chẳng hạn như customers/CUSTOMER_ID/campaigns/-1) và tham chiếu mã đó từ tài nguyên con thuộc loại khác (chẳng hạn như AdGroup) trong cùng một yêu cầu. (Mã tạm thời tự tham chiếu trong cùng một loại tài nguyên được hỗ trợ cho các cây phân cấp, chẳng hạn như nhóm trang thông tin AdGroupCriterion và nút AssetGroupListingGroupFilter.)

Nếu bạn cần thay đổi nhiều loại tài nguyên trong một yêu cầu hoặc tham chiếu tên tài nguyên tạm thời trên nhiều loại tài nguyên, hãy sử dụng GoogleAdsService.Mutate.

Sự khác biệt theo phiên bản

Hãy lưu ý sự khác biệt sau đây giữa các phiên bản Google Ads API được hỗ trợ khi thay đổi tài nguyên:

  • Dịch vụ mục tiêu vòng đời: Mục tiêu Giữ chân khách hàng được thay đổi trên tất cả các phiên bản được hỗ trợ thông qua GoalService.MutateGoals (retention_goal_settings) và CampaignGoalConfigService.MutateCampaignGoalConfigs (campaign_retention_settings) bằng cách sử dụng trường operations lặp lại tiêu chuẩn. Trong phiên bản 25 trở lên, mục tiêu Thu nạp khách hàng mới (new_customer_acquisition_goal_settings/campaign_new_customer_acquisition_settings) và Giữ chân khách hàng thân thiết (loyalty_retention_goal_settings/campaign_loyalty_retention_settings) cũng được thay đổi thông qua GoalService.MutateGoals và CampaignGoalConfigService.MutateCampaignGoalConfigs. Trường này thay thế CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals và CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals, vốn được dùng cho mục tiêu Thu nạp khách hàng mới trong phiên bản 23 và 24, đồng thời chấp nhận một trường operation duy nhất.
Trước
Tổng quan
Tiếp
Thay đổi hàng loạt