Search Ads 360 Reporting API는 모든 사용자에게 최적의 시스템 성능을 보장하기 위해 API 작업에 한도를 적용합니다.
가격 책정
Search Ads 360 Reporting API 사용은 Search Ads 360의 전체 가격 책정에 포함됩니다. API 사용에 대한 추가 수수료는 없습니다.
검색어 한도
Search 또는 SearchStream 메서드를 통해 수행되는 쿼리 작업에는 다음 한도가 적용됩니다.
- 사용자당 프로젝트당 분당 쿼리 3,000개
- 프로젝트당 분당 쿼리 3,000개
- 프로젝트당 일일 쿼리 150,000개
일일 API 작업 한도
일일 API 사용량 한도는 Google Cloud 프로젝트당 API 작업 수를 기준으로 합니다.
단일 쿼리 또는 보고서는 SearchAds360Service.SearchStream
를 통해 스트리밍되거나 SearchAds360Service.Search
호출에서 페이징되는 결과에 관계없이 하나의 작업으로 집계됩니다.
자세히 알아보기
다음은 일일 연산 한도 집계의 일부 예입니다.
API 요청 | 일일 한도 집계에 반영되는 연산 횟수 |
---|---|
연산: Search
개수: 광고그룹 53개
서비스: |
1 |
연산: SearchStream
개수: 캠페인 45개
서비스: |
1 |
이러한 한도를 위반하는 요청은 RESOURCE_EXHAUSTED
오류와 함께 거부됩니다.
검색 요청
Search
또는 SearchStream
요청은 사용자의 일일 작업 할당량에서 하나의 작업으로 집계됩니다. SearchStream
요청 1개는 배치 수와 관계없이 API 작업 1개로 계산됩니다.
gRPC 제한사항
모든 Search Ads 360 Reporting API 클라이언트 라이브러리는 요청 및 응답을 생성하는 데 gRPC를 사용합니다. 기본적으로 gRPC의 메시지 크기는 4MB입니다.
응답이 이 한도를 초과해서는 안 됩니다. 예를 들어 많은 필드가 포함된 검색 요청은 크기가 4MB를 초과하는 응답을 생성할 수 있습니다. 이 제한을 피하려면 선택된 필드 수를 줄이거나 페이지 크기를 줄이거나 스트리밍을 사용하면 됩니다.
이 제한을 위반하는 요청은 SearchAds360Error
를 생성하지 않지만 429 Resource Exhausted
gRPC 오류를 생성합니다. gRPC 오류 코드 및 메시지 목록을 참조하세요.
페이지로 나눈 요청
페이지로 나눈 요청 (예: 유효한 next_page_token
가 포함된 요청)은 사용자의 일일 작업 할당량에 포함되지 않습니다.
하지만 만료되었거나 잘못된 페이지 토큰이 포함된 페이지로 나누기 요청은 예외가 생성되고 일일 작업 할당량에 포함됩니다.
페이지가 매겨진 요청(예: 검색 요청)에도 Page size cannot exceed 10,000 rows
제한이 적용되며, 이 제한을 위반하는 경우 INVALID_PAGE_SIZE
오류와 함께 거부됩니다.
페이지로 나누기에 관한 자세한 내용은 결과를 통한 페이징을 참고하세요.
API 예외를 반환하는 요청
SearchAds360Failure
로 거부된 요청도 사용자의 일일 작업 할당량에 반영됩니다.
네트워크 수준의 오류 등으로 인해 실패했지만 SearchAds360Failure
를 반환하지 않는 요청은 서비스에 도달하지 않으므로 사용자의 일일 작업 할당량에 포함되지 않습니다. 네트워크 연결 실패를 예로 들 수 있습니다.
기타 한도 유형
작업 목록과 같이 요청에 항목이 너무 많은 반복되는 필드는 REQUEST_SIZE_LIMIT_EXCEEDED
오류를 발생시킬 수 있습니다.
이 오류 메시지는 다른 문제로 인한 것일 수도 있습니다.
Search Ads 360 Query Language 쿼리를 실행할 때 IN
절 내의 최대 항목 수는 20,000개입니다. 이 한도를 초과하면 FILTER_HAS_TOO_MANY_VALUES
오류가 반환됩니다.