本頁列出 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 錯誤要求」錯誤。