Method: advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

指定されたリソースにリンクされている YouTube アセットの関連付けを一覧表示します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 をご覧ください。