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。
联合参数 entity。要与 YouTube 资产相关联的实体。entity 只能是下列其中一项：
linkedEntity.lineItemId

string (int64 format)

相应订单项的 ID。
youtubeAssetType

enum (YoutubeAssetType)

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

查询参数

参数
联合参数 entity。要与 YouTube 资产相关联的实体。entity 只能是下列其中一项：
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。