Method: advertisers.channels.sites.replace

Thay thế tất cả các trang web trong một kênh duy nhất.

Thao tác này sẽ thay thế các trang web trong một kênh bằng các trang web được cung cấp trong ReplaceSitesRequest.new_sites.

Phương pháp này thường có độ trễ cao. Bạn nên tăng thời gian chờ mặc định để tránh lỗi.

Yêu cầu HTTP

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/channels/{channelId}/sites:replace

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

Tham số đường dẫn

Tham số
channelId

string (int64 format)

Bắt buộc. Mã nhận dạng của kênh chính có trang web sẽ bị thay thế.
Tham số kết hợp owner. Bắt buộc. Xác định thực thể DV360 sở hữu kênh mẹ. Đó có thể là một đối tác hoặc nhà quảng cáo. owner chỉ có thể là một trong những trạng thái sau đây:
advertiserId

string (int64 format)

Mã nhận dạng của nhà quảng cáo sở hữu kênh mẹ.

Nội dung yêu cầu

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

Biểu diễn dưới dạng JSON 
{
  "newSites": [
    {
      object (Site)
    }
  ],

  // Union field owner can be only one of the following:
  "partnerId": string
  // End of list of possible types for union field owner.
}
Trường
newSites[]

object (Site)

Các trang web sẽ thay thế các trang web hiện có được gán cho kênh, được chỉ định dưới dạng danh sách Sites.
Trường kết hợp owner. Bắt buộc. Xác định thực thể DV360 sở hữu kênh mẹ. Đó có thể là một đối tác hoặc nhà quảng cáo. owner chỉ có thể là một trong những trạng thái sau đây:
partnerId

string (int64 format)

Mã nhận dạng của đối tác sở hữu kênh mẹ.
advertiserId

string (int64 format)

Mã nhận dạng của nhà quảng cáo sở hữu kênh mẹ.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của ReplaceSitesResponse.

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 bài viết Tổng quan về OAuth 2.0.