Method: advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

Liệt kê các mối liên kết tài sản trên YouTube được liên kết với tài nguyên đã cho.

Yêu cầu HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems/{linkedEntity.lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations

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ã nhận dạng của nhà quảng cáo mà thực thể được liên kết thuộc về.
Tham số hợp nhất entity. Thực thể cần liên kết với tài sản trên YouTube. entity chỉ có thể là một trong những trạng thái sau:
linkedEntity.lineItemId

string (int64 format)

Mã nhận dạng của một mục hàng.
youtubeAssetType

enum (YoutubeAssetType)

Bắt buộc. Loại tài sản trên YouTube được liên kết với tài nguyên.

Tham số truy vấn

Tham số
Tham số hợp nhất entity. Thực thể cần liên kết với tài sản trên YouTube. entity chỉ có thể là một trong những trạng thái sau:
linkedEntity.adGroupId

string (int64 format)

Mã của một nhóm quảng cáo.
pageSize

integer

Không bắt buộc. Kích thước trang được yêu cầu. Phải nằm trong khoảng từ 1 đến 10000. Nếu bạn không chỉ định, giá trị mặc định sẽ là 100. Trả về mã lỗi INVALID_ARGUMENT nếu bạn chỉ định một giá trị không hợp lệ.
pageToken

string

Không bắt buộc. Mã thông báo xác định một trang kết quả mà máy chủ sẽ trả về.

Thông thường, đây là giá trị của nextPageToken được trả về từ lệnh gọi trước đó đến phương thức youtubeAssetAssociations.list. Nếu không chỉ định, trang kết quả đầu tiên sẽ được trả về.
orderBy

string

Không bắt buộc. Trường dùng để sắp xếp danh sách.

Các giá trị duy nhất được chấp nhận là:

  • linkedYoutubeAsset.locationAssetFilter.assetSetId,
  • linkedYoutubeAsset.affiliateLocationAssetFilter.assetSetId,
  • linkedYoutubeAsset.sitelinkAsset.assetId

Thứ tự sắp xếp mặc định là tăng dần. Để chỉ định thứ tự giảm dần cho một trường, bạn nên thêm hậu tố " desc" vào tên trường. Ví dụ: linkedYoutubeAsset.sitelinkAsset.assetId desc

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

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 thực thể của ListYoutubeAssetAssociationsResponse.

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.