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 요청은 사용자의 일일 작업 할당량에서 작업 1회로 집계됩니다. 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 쿼리 언어 쿼리를 실행할 때 IN 절 내 최대 항목 수는 20,000개입니다. 이 한도를 초과하면 FILTER_HAS_TOO_MANY_VALUES 오류가 반환됩니다.