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, "測試廣告單元對應 1", "測試廣告單元對應 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 總覽。