Reports: generate

需要授權

按照查詢參數中傳送的報表請求來產生 AdSense 報表。系統會以 JSON 的形式傳回結果;若要以 CSV 格式擷取結果,請將「alt=csv」指定為查詢參數。馬上試試

請求

HTTP 請求

GET https://www.googleapis.com/adsense/v1.4/reports

參數

參數名稱 說明
必要查詢參數
endDate string 報表日期範圍的結束日期,格式為「YYYY-MM-DD」,含當天資料。
startDate string 報表日期範圍的開始日期,格式為「YYYY-MM-DD」,含當天資料。
自選查詢參數
accountId string 要製作報表的帳戶。
currency string 金額指標報表中所用的貨幣。若未設定,預設會使用帳戶所用的貨幣。
dimension string 報表所依據的維度。可用的維度會在指標和維度中說明。有關各維度的相關詳情,請參閱 AdSense 詞彙解釋
filter string 要套用至報表的篩選器
locale string 將報表資料翻譯成當地語言時所用的自選語言代碼。如未指定,系統會預設使用「en_US」。
maxResults integer 要傳回的報表資料列的數量上限。如果 startIndex 並未設定或設為零,API 會傳回 maxResults 值指定的列數。若未設定 maxResults,API 則會傳回最多的資料列,但不超過 50,000 列。如果 startIndex 設為非零的值,則 startIndex 和 maxResults 的總和不得大於 5000,否則系統會傳回「不支援第 5000 列以後的分頁」錯誤訊息。可接受的值為 050000 (含頭尾)。
metric string 報表所依據的指標。可用的指標會在指標和維度中說明。有關各指標的相關詳情,請參閱 AdSense 詞彙解釋
sort string 報表結果排序時所用維度或指標的名稱。選擇冠上「+」即可按遞增順序排列,冠上「-」則可按遞減順序排列。如果不加上任何符號,資料欄就會按遞增順序排列。
startIndex integer 要傳回的第一列報表資料的索引。如果 startIndex 並未設定或設為零,API 會傳回 maxResults 值指定的列數。若未設定 maxResults,API 則會傳回最多的資料列,但不超過 50,000 列。如果 startIndex 設為非零的值,則 startIndex 和 maxResults 的總和不得大於 5000,否則系統會傳回「不支援第 5000 列以後的分頁」錯誤訊息。可接受的值為 05000 (含頭尾)。
useTimezoneReporting boolean 是否應該以 AdSense 帳戶的當地時區產生報表。如果不是,則會使用預設太平洋標準時間/太平洋夏令時間時區。

授權

此請求至少需要獲得下列其中一個範圍的授權 (進一步瞭解驗證和授權)。

範圍
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。

可接受的值為:
  • "DIMENSION":
  • "METRIC_CURRENCY":
  • "METRIC_RATIO":
  • "METRIC_TALLY":
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,針對線上資料叫用這個方法,看看會有什麼結果。