需要授權
按照查詢參數中傳送的報表存檔編號來產生 AdSense 報表。馬上試試!
請求
HTTP 請求
GET https://www.googleapis.com/adsense/v1.4/accounts/accountId/reports/savedReportId
參數
參數名稱 | 值 | 說明 |
---|---|---|
路徑參數 | ||
accountId | string | 報表存檔所屬的帳戶。 |
savedReportId | string | 要擷取的報表存檔。 |
自選查詢參數 | ||
locale | string | 將報表資料翻譯成當地語言時所用的自選語言代碼。如未指定,系統會預設使用「en_US」。 |
maxResults | integer | 要傳回的報表資料列的數量上限。如果 startIndex 並未設定或設為零,API 會傳回 maxResults 值指定的列數。若未設定 maxResults,API 則會傳回最多的資料列,但不超過 50,000 列。 如果 startIndex 設為非零的值,則 startIndex 和 maxResults 的總和不得大於 5000,否則系統會傳回「不支援第 5000 列以後的分頁」錯誤訊息。 可接受的值為 0 到 50000 (含頭尾)。 |
startIndex | integer | 要傳回的第一列報表資料的索引。如果 startIndex 並未設定或設為零,API 會傳回 maxResults 值指定的列數。若未設定 maxResults,API 則會傳回最多的資料列,但不超過 50,000 列。 如果 startIndex 設為非零的值,則 startIndex 和 maxResults 的總和不得大於 5000,否則系統會傳回「不支援第 5000 列以後的分頁」錯誤訊息。 可接受的值為 0 到 5000 (含頭尾)。 |
授權
此請求至少需要獲得下列其中一個範圍的授權 (進一步瞭解驗證和授權)。
範圍 |
---|
https://www.googleapis.com/auth/adsense |
https://www.googleapis.com/auth/adsense.readonly |
請求主體
請不要在請求主體中使用這個方法。
回應
成功的話,這個方法會傳回下列結構的回應主體:
JSON
{ "kind": "adsense#report", "totalMatchedRows": long, "headers": [ { "name": string, "type": string, "currency": string } ], "rows": [ [ string ] ], "totals": [ string ], "averages": [ string ], "warnings": [ string ], "startDate": string, "endDate": string }
屬性名稱 | 值 | 說明 | 備註 |
---|---|---|---|
kind | string | 代表種類,此處為 adsense#report。 | |
totalMatchedRows | long | 與報表請求相符的總列數。受限於請求的列數或報表列數上限,回應中傳回的列數可能較少。 | |
headers[] | list | 報表中所請求欄的標題資訊。這是標題的清單,請求中每個維度都有一份,後面接著請求中每個指標的一份標題清單。 | |
headers[].name | string | 標題名稱。 | |
headers[].type | string | 標題類型:DIMENSION、METRIC_TALLY、METRIC_RATIO 或 METRIC_CURRENCY。 可接受的值為:
| |
headers[].currency | string | 這一欄的貨幣;標題類型為 METRIC_CURRENCY 時才會顯示。 | |
rows[] | list | 報表資料列。每一列都是儲存格清單;請求中每個維度都有一份,後面接著請求中每個指標的一份儲存格清單。維度儲存格內含字串,指標儲存格則內含數字。 | |
totals[] | list | 報表中的總計。長度與報表中的其他列一樣;維度欄的相應儲存格為空白。 | |
averages[] | list | 報表中的平均值。長度與報表中的其他列一樣;維度欄的相應儲存格為空白。 | |
warnings[] | list | 所有與產生報表相關的警告。 | |
startDate | string | 請求的開始日期格式為 yyyy-mm-dd。 | |
endDate | string | 請求的結束日期格式為 yyyy-mm-dd。 |
CSV
"(dynamic)" (foreach) string (/foreach)
屬性名稱 | 值 | 說明 | 備註 |
---|---|---|---|
(dynamic) | string |
試試看!
使用下方的 APIs Explorer,針對線上資料叫用這個方法,看看會有什麼結果。