Method: advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

列出与指定资源相关联的 YouTube 资产关联。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
advertiserId

string (int64 format)

必需。关联实体所属的广告客户的 ID。
要与 YouTube 资产相关联的实体。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
linkedEntity.lineItemId

string (int64 format)

相应订单项的 ID。
互斥字段的结束。
youtubeAssetType

enum (YoutubeAssetType)

必需。与资源相关联的 YouTube 资产的类型。

查询参数

参数
要与 YouTube 资产相关联的实体。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
linkedEntity.adGroupId

string (int64 format)

广告组的 ID。
互斥字段的结束。
pageSize

integer

可选。请求的页面大小。 必须介于 1 到 10000 之间。如果未指定，则默认为 100。如果指定了无效值，则返回错误代码 INVALID_ARGUMENT。
pageToken

string

可选。标识服务器应返回的结果页面的令牌。

通常，这是上一次调用 youtubeAssetAssociations.list 方法返回的 nextPageToken 值。如果未指定，则返回第一页结果。
orderBy

string

可选。用于对列表进行排序的字段。

唯一可接受的值是：

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

默认排序顺序为升序。如需将字段指定为降序排序，应在字段名称中添加“desc”后缀。示例：linkedYoutubeAsset.sitelinkAsset.assetId desc。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 ListYoutubeAssetAssociationsResponse 实例。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 Overview。