Method: accounts.adUnits.list

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

HTTP 要求

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

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

路徑參數

參數
parent

string

必要欄位。要列出其廣告單元的帳戶資源名稱。範例：accounts/pub-9876543210987654

查詢參數

參數
pageSize

integer

要傳回的廣告單元數量上限。如果未指定或為 0，最多將傳回 10,000 個廣告單元。許可的最大值為 20,000；超過 20,000 個值將強制轉換為 20,000。
pageToken

string

最後一個 ListAdUnitsResponse 傳回的值；表示這是之前的 adUnits.list 呼叫的接續，系統應傳回下一頁的資料。

要求主體

要求主體必須為空白。

回應主體

廣告單元清單請求的回應。

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

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

object (AdUnit)

指定帳戶所產生的廣告單元。
nextPageToken

string

如果沒有空白，表示請求中可能還有其他廣告單元；這個值應在新的 ListAdUnitsRequest 中傳遞。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

AdUnit

描述 AdMob 廣告單元。

JSON 表示法 
{
  "name": string,
  "adUnitId": string,
  "appId": string,
  "displayName": string,
  "adFormat": string,
  "adTypes": [
    string
  ]
}
欄位
name

string

此廣告單元的資源名稱。格式為 accounts/{publisherId}/adUnits/{ad_unit_id_fragment} 範例：accounts/pub-9876543210987654/adUnits/0123456789
adUnitId

string

廣告單元的外部可見 ID，可用來整合 AdMob SDK。這是唯讀屬性。範例：ca-app-pub-9876543210987654/0123456789
appId

string

這個廣告單元相關應用程式的外部可見 ID。範例：ca-app-pub-9876543210987654~0123456789
displayName

string

AdMob UI 中顯示的廣告單元顯示名稱，由使用者提供。長度上限為 80 個半形字元。
adFormat

string

廣告單元的廣告格式。可能的值如下：

「APP_OPEN」- 應用程式開啟頁面廣告格式。「橫幅」- 橫幅廣告格式。「BANNER_INTERSTITIAL」- 舊格式，可做為橫幅廣告或插頁式廣告。您無法再建立這個格式，但可以由中介服務群組指定。「INTERSTITIAL」- 全螢幕廣告。支援的廣告類型為「RICH_MEDIA」和「VIDEO」「NATIVE」- 原生廣告格式。「已獲得獎勵」- 廣告會在使用者觀看廣告時獲得驗證檢視畫面的回呼，以便獎勵給使用者。支援的廣告類型為「RICH_MEDIA」(互動式) 以及影片無法排除的影片。「REWARDED_INTERSTITIAL」- 插頁式獎勵廣告格式。僅支援影片廣告類型。詳情請參閱 https://support.google.com/admob/answer/9884467。
adTypes[]

string

此廣告單元支援的廣告媒體類型。可能的值如下：

「RICH_MEDIA」- 文字、圖像和其他非影片媒體。「影片」- 影片媒體。