Method: accounts.adUnits.adUnitMappings.list

列出指定 AdMob 帳戶和廣告單元下的廣告單元對應。

HTTP 要求

GET https://admob.googleapis.com/v1beta/{parent=accounts/*/adUnits/*}/adUnitMappings

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必填。擁有這組廣告單元對應的父項。格式：accounts/{publisherId}/adUnits/{adUnitId}

查詢參數

參數
pageSize

integer

要傳回的廣告單元對應數量上限。如未指定或設為 0，最多會傳回 10,000 個廣告單元對應。許可的最大值為 20,000；超出的數值將一律指定為 20,000。
pageToken

string

屬於接收自前一個 adUnitMappings.list 呼叫的網頁權杖。提供此項目即可擷取後續網頁。
filter

string

使用 EBNF 文法語法的篩選器字串。可做為篩選依據的欄位包括：

  • 「DISPLAY_NAME」

可能的篩選函式為：

  • IN：用於篩選代表單例項的欄位，包括「DISPLAY_NAME」。

您可以使用 AND 將篩選函式加在一起。不支援 OR 功能。

範例：

篩選器：IN(DISPLAY_NAME, "Test Ad Unit Mapping 1", "Test Ad Unit Mapping 2")

要求主體

要求主體必須為空白。

回應主體

ListAdUnitMappingsRequest 的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "adUnitMappings": [
    {
      object (AdUnitMapping)
    }
  ],
  "nextPageToken": string
}
欄位
adUnitMappings[]

object (AdUnitMapping)

指定帳戶和廣告單元的廣告單元對應。
nextPageToken

string

用於在 ListAdUnitMappingsRequest 中設定 pageToken，以擷取下一頁。如果省略這個欄位，就不會有後續頁面。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/admob.monetization
  • https://www.googleapis.com/auth/admob.readonly

詳情請參閱OAuth 2.0 Overview。