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。