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

Sử dụng dịch vụ chuyên dụng của một 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ể thuộc một loại tài nguyên duy nhất trong Google Ads API.

Thay đổi điểm cuố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, hãy điền một trong các trường sau vào thao tác và gửi đến điểm cuối đột biến 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 một 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 bằng các thuộc tính mà 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ô hình 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 đối với 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à hạn chế

Hầu hết các yêu cầu biến đổi dành riêng cho tài nguyên đều chấp nhận một trường operations lặp lại, vì vậy, một yêu cầu duy nhất 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 cho AdGroupCriterionService.MutateAdGroupCriteria; CustomerService.MutateCustomer chấp nhận một trường operation duy nhất). Theo mặc định, tất cả các thao tác trong yêu cầu đều thực hiện một cách riêng lẻ, trừ phi dịch vụ hỗ trợ partial_failure và bạn đặt 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ã nhận dạng tạm thời trên nhiều tài nguyên: Vì lệnh gọi biến đổi dành riêng cho tài nguyên chỉ chấp nhận một loại tài nguyên duy nhất, nên bạn không thể chỉ định mã nhận dạng 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ã nhận dạng đó từ tài nguyên con thuộc một loại khác (chẳng hạn như AdGroup) trong cùng một yêu cầu. (Các mã nhận dạng 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à các 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 ý đến sự khác biệt sau đây giữa các phiên bản Google Ads API được hỗ trợ khi biến đổ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. Điều này sẽ thay thế CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals và CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals. Đây là những trường đượ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