限制

本頁列出 AdSense Management API 專屬的各種配額和限制。這些限制和所有產品專屬限制 (例如每個帳戶的管道數量) 都適用於 AdSense。

API 級別配額

所有傳送至 AdSense Management API 的要求都會計入一般請求頻率配額，不受要求類型影響。

您可以在 Google API 控制台的「配額」頁面中，查看上述任一配額的目前用量。您也可以設定用量快訊或額外的監控功能，詳情請參閱一般 Google Cloud 配額總覽說明文件。

超過配額時，系統會拒絕要求，並顯示「HTTP 429 要求數量過多」錯誤。錯誤訊息會詳細說明超出配額的情況。

說明 價值 附註
單一使用者和專案的每分鐘查詢次數 100 n/a
單一專案所有使用者的每分鐘查詢次數 500 n/a
每日查詢次數 10,000 系統會在太平洋時間凌晨 12 點左右重設每日配額。

報表大小限制

AdSense Management API 產生的報表的大小上限取決於輸出格式：

  • JSON 報表 (例如由 accounts.reports.generate 方法產生) 的資料列數量上限為 100,000 個。超過此上限的報表將遭到截斷，但回應中的 totalMatchedRows 欄位會顯示完整報表的大小，可用於判斷是否發生截斷情形。
  • CSV 報表 (例如由 accounts.reports.generateCsv 方法產生) 的資料列數量上限為 1,000,000 個。超過此上限的報表將被截斷。

報表資料列配額

此外，為防範濫用行為，AdSense Management API 也會限制每日和短期間內擷取的報表資料總數。超過限制後，系統就會拒絕要求，並顯示 HTTP 429 要求數量過多錯誤，並顯示相關訊息：「超出報表資料列配額」。

其他要求限制

各種要求參數可控制針對要求傳回多少資料 (例如，page_size 適用於允許分頁的要求，或是 limit 參數用於報表產生要求)。如果未指定這些參數，預設值一律為允許的最大值。指定較高的值會導致要求遭到拒絕，並顯示「HTTP 400 錯誤要求」錯誤。