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 個值將強制轉換為 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 總覽