제한

이 페이지에는 애드센스 관리 API에 해당하는 다양한 할당량과 한도가 나와 있습니다. 이 제한은 일반적으로 애드센스에 적용되는 제품별 한도 (예: 계정당 채널 수) 외에 추가로 적용됩니다.

API 수준 할당량

AdSense Management API로 전송된 모든 요청은 요청 유형과 관계없이 일반 요청 비율 할당량에 반영됩니다.

Google API 콘솔의 할당량 페이지에서 이러한 할당량의 현재 사용량을 확인할 수 있습니다. 사용량 알림 또는 추가 모니터링을 설정할 수도 있습니다. 자세한 내용은 일반 Google Cloud 할당량 개요 문서를 참조하세요.

이 할당량을 초과하면 요청이 거부되고 HTTP 429 요청이 너무 많음 오류가 표시됩니다. 오류 메시지에는 초과된 할당량에 대한 세부정보가 포함됩니다.

설명	가치	Notes
단일 사용자 및 프로젝트의 분당 쿼리 수	100	해당 사항 없음
단일 프로젝트를 사용하는 모든 사용자의 분당 쿼리 수	500	해당 사항 없음
일별 쿼리 수	10,000	일일 할당량은 태평양 표준시 자정에 재설정됩니다.

보고서 크기 제한

애드센스 관리 API에서 생성된 보고서의 최대 크기는 출력 형식에 따라 달라집니다.

• JSON 보고서 (예: accounts.reports.generate 메서드로 생성)는 최대 100,000행으로 제한됩니다. 이보다 큰 보고서는 잘리지 않지만 응답에는 전체 보고서의 크기가 포함된 totalMatchedRows 필드가 포함됩니다. 이 필드는 잘림이 발생했는지 식별하는 데 사용할 수 있습니다.
• CSV 보고서 (예: accounts.reports.generateCsv 메서드로 생성)는 최대 1,000,000행으로 제한됩니다. 이보다 큰 보고서는 잘립니다.

보고서 행 할당량

또한 애드센스 관리 API는 악용을 방지하기 위해 하루 또는 더 짧은 기간에 걸쳐 가져올 수 있는 보고 데이터의 총량에 한도를 적용합니다. 이 한도를 초과하면 '보고서 행 할당량을 초과했습니다'라는 관련 메시지와 함께 HTTP 429 요청이 너무 많음 오류와 함께 요청이 거부됩니다.

기타 요청 한도

다양한 요청 매개변수는 요청에 대해 반환해야 하는 데이터의 양을 제어합니다 (예: 페이지로 나누기를 허용하는 요청의 경우 page_size, 보고서 생성 요청의 경우 limit 매개변수). 이러한 매개변수를 지정하지 않으면 기본값은 항상 최대 허용 값입니다. 더 높은 값을 지정하면 요청이 거부되고 HTTP 400 Bad Request 오류가 표시됩니다.