Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

Chỉnh sửa hàng loạt các lựa chọn nhắm mục tiêu cho nhiều nhóm quảng cáo.

Cùng một tập hợp các yêu cầu xoá và tạo sẽ được áp dụng cho tất cả các nhóm quảng cáo được chỉ định. Cụ thể, thao tác này sẽ xoá các lựa chọn nhắm mục tiêu được chỉ định có trong BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests khỏi mỗi nhóm quảng cáo, sau đó tạo các lựa chọn nhắm mục tiêu được chỉ định có trong BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests.

Phương thức này chỉ được hỗ trợ cho các nhóm quảng cáo Tạo nhu cầu.

Yêu cầu HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
advertiserId

string (int64 format)

Bắt buộc. Mã của nhà quảng cáo mà các nhóm quảng cáo thuộc về.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
Trường
adGroupIds[]

string (int64 format)

Bắt buộc. Mã của các nhóm quảng cáo mà các lựa chọn nhắm mục tiêu được chỉ định sẽ thuộc về. Bạn có thể chỉ định tối đa 25 mã nhóm quảng cáo.
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

Không bắt buộc. Các lựa chọn nhắm mục tiêu được chỉ định để xoá hàng loạt, được chỉ định dưới dạng danh sách DeleteAssignedTargetingOptionsRequest.

Các loại tiêu chí nhắm mục tiêu được hỗ trợ:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

Không bắt buộc. Các lựa chọn nhắm mục tiêu được chỉ định để tạo hàng loạt, được chỉ định dưới dạng danh sách CreateAssignedTargetingOptionRequest.

Các loại tiêu chí nhắm mục tiêu được hỗ trợ:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

Nội dung phản hồi

Thông báo phản hồi cho adGroups.bulkEditAssignedTargetingOptions.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Trường
updatedAdGroupIds[]

string (int64 format)

Chỉ có đầu ra. Mã của các nhóm quảng cáo đã cập nhật thành công.
failedAdGroupIds[]

string (int64 format)

Chỉ có đầu ra. Mã của các nhóm quảng cáo không cập nhật được.
errors[]

object (Status)

Chỉ có đầu ra. Thông tin lỗi cho từng nhóm quảng cáo không cập nhật được.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/display-video

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.