需要授權
根據此 AdSense 帳戶,列出某個廣告用戶端的所有廣告單元。馬上試試!
請求
HTTP 請求
GET https://www.googleapis.com/adsense/v1.4/adclients/adClientId/adunits
參數
參數名稱 | 值 | 說明 |
---|---|---|
路徑參數 | ||
adClientId | string | 要列出廣告單元的廣告用戶端。 |
自選查詢參數 | ||
includeInactive | boolean | 是否要加入無效廣告單元。預設值:true。 |
maxResults | integer | 要加進回應的廣告單元數量上限,用於分頁。可接受的值為 0 到 10000 (含頭尾)。 |
pageToken | string | 用於廣告單元分頁的接續權杖。若要擷取下一頁,請將此參數設為前一個回應的「nextPageToken」值。 |
授權
此請求至少需要獲得下列其中一個範圍的授權 (進一步瞭解驗證和授權)。
範圍 |
---|
https://www.googleapis.com/auth/adsense |
https://www.googleapis.com/auth/adsense.readonly |
請求主體
請不要在請求主體中使用這個方法。
回應
成功的話,這個方法會傳回下列結構的回應主體:
{ "kind": "adsense#adUnits", "etag": etag, "nextPageToken": string, "items": [ adunits Resource ] }
屬性名稱 | 值 | 說明 | 備註 |
---|---|---|---|
kind | string | 此為清單種類,此處為 adsense#adUnits。 | |
etag | etag | 此回應的 ETag,用於快取。 | |
nextPageToken | string | 用於廣告單元分頁的接續權杖。若要擷取結果的下一頁,請將此參數設為下一個請求的「pageToken」值。 | |
items[] | list | 此清單回應中傳回的廣告單元。 |
試試看!
使用下方的 APIs Explorer,針對線上資料叫用這個方法,看看會有什麼結果。