Google Ads API는 API 작업(예: 단일 변경 요청으로 보낼 수 있는 작업 수)을 제한합니다. 아래 표에는 알아야 할 중요한 한도 및 할당량이 요약되어 있습니다.
요청 유형, 제한사항, 오류 코드 | |||
---|---|---|---|
페이지로 나눈 요청 | 페이지당 행 10,000개 |
INVALID_PAGE_SIZE
|
|
기본 액세스를 통한 작업 | API 작업 15,000회/일 |
RESOURCE_EXHAUSTED
|
|
요청 변경 | 요청당 작업 10,000개 |
TOO_MANY_MUTATE_OPERATIONS
|
|
계획 도구 서비스 요청 | 1QPS |
RESOURCE_EXHAUSTED
|
|
전환 업로드 서비스 요청 | 요청당 전환 2,000회 |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
|
결제 및 계정 예산 서비스 요청 | 변경 요청당 연산 1개 |
TOO_MANY_MUTATE_OPERATIONS
|
일일 API 작업 한도
일일 API 사용량 한도는 개발자 토큰당 수행되는 API 작업 수를 기준으로 합니다. API 작업은 get 요청 및 mut 작업의 총합입니다. 일일 API 작업의 한도는 개발자 토큰의 액세스 수준에 따라 다릅니다. 액세스 수준 및 허용되는 사용 가이드에서는 각 액세스 수준의 특정 API 작업 한도를 간략히 설명합니다.
이러한 한도를 위반하는 요청은 RESOURCE_EXHAUSTED
오류와 함께 거부됩니다.
gRPC 제한사항
모든 Google Ads API 클라이언트 라이브러리는 요청 및 응답을 생성하는 데 gRPC를 사용합니다. 기본적으로 gRPC의 메시지 크기는 4MB이지만, 클라이언트 라이브러리는 효율성을 높이기 위해 최대 메시지 크기를 64MB로 설정합니다.
응답이 이 한도를 초과해서는 안 됩니다. 예를 들어 많은 필드가 포함된 검색 요청은 크기가 64MB를 초과하는 응답을 생성할 수 있습니다. 이 제한을 피하려면 선택된 필드 수를 줄이거나 페이지 크기를 줄이거나 스트리밍을 사용하면 됩니다. 변형의 경우 요청당 전송하는 작업 수를 줄입니다.
이 제한을 위반하는 요청은 GoogleAdsError
를 생성하지 않지만 429 Resource Exhausted
gRPC 오류를 생성합니다. gRPC 오류 코드 및 메시지 목록을 참조하세요.
요청 변경
변경 요청은 사용자의 일일 작업 할당량을 집계할 뿐 아니라 요청당 최대 10,000개의 연산을 포함할 수 있습니다.
이 제한을 위반하는 요청은 TOO_MANY_MUTATE_OPERATIONS
오류와 함께 거부됩니다.
특정 서비스 및 요청 유형에 대한 추가 한도 및 고려사항은 아래에 설명되어 있습니다.
검색 요청
Search
또는 SearchStream
요청은 사용자의 일일 작업 할당량에서 하나의 작업으로 집계됩니다. SearchStream
요청 1개는 배치 수와 관계없이 API 작업 1개로 계산됩니다.
페이지로 나눈 요청
페이지로 나눈 요청 (예: 유효한 next_page_token
가 포함된 요청)은 사용자의 일일 작업 할당량에 포함되지 않습니다.
하지만 만료되었거나 잘못된 페이지 토큰이 포함된 페이지로 나누기 요청은 예외가 생성되고 일일 작업 할당량에 포함됩니다.
페이지가 매겨진 요청(예: 검색 요청)에도 Page size cannot exceed 10,000 rows
제한이 적용되며, 이 제한을 위반하는 경우 INVALID_PAGE_SIZE
오류와 함께 거부됩니다.
페이지로 나누기에 관한 자세한 내용은 결과를 통한 페이징을 참고하세요.
기타 요청 유형
Get
, Mutate
, Search
또는 SearchStream
요청이 아닌 요청은 사용자의 일일 작업 할당량에서 하나의 작업으로 집계됩니다.
이러한 요청의 예는 다음과 같습니다.
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
API 예외를 반환하는 요청
GoogleAdsFailure
로 거부된 요청도 사용자의 일일 작업 할당량에 반영됩니다.
네트워크 수준의 오류 등으로 인해 실패했지만 GoogleAdsFailure
를 반환하지 않는 요청은 서비스에 도달하지 않으므로 사용자의 일일 작업 할당량에 포함되지 않습니다. 네트워크 연결 실패를 예로 들 수 있습니다.
계획 수립 서비스
비용과 복잡성으로 인해 아래에 나열된 Planning 서비스 메서드에는 다른 유형의 요청과는 별도의 제한사항이 적용됩니다.
CID 또는 개발자 토큰별로 초당 요청 수가 1개로 제한됨:
KeywordPlanService.GetKeywordPlan
KeywordPlanService.GenerateHistoricalMetrics
KeywordPlanService.GenerateForecastMetrics
이러한 제한사항을 위반하는 요청은
RESOURCE_EXHAUSTED
오류와 함께 거부됩니다.1 QPS는 60초당 60개의 요청으로 계산됩니다.
키워드 계획을 만들 때 이러한 한도에 유의하세요.
키워드 계획 객체 | 최대 개수 |
---|---|
계정당 KeywordPlan |
10,000 |
KeywordPlan 당 KeywordPlanAdGroup |
200 |
KeywordPlan 당 KeywordPlanAdGroupKeyword |
10,000 |
KeywordPlanCampaignKeyword (제외 키워드) |
1,000 |
KeywordPlan 당 KeywordPlanCampaign |
1 |
전환 업로드 서비스
요청당 통화 또는 클릭 전환수 2,000회로 제한:
이러한 한도를 위반하는 요청은
TOO_MANY_CONVERSIONS_IN_REQUEST
오류와 함께 거부됩니다.
전환 조정 업로드 서비스
요청당 전환 조정은 2,000개로 제한됨:
이러한 한도를 위반하는 요청은
TOO_MANY_ADJUSTMENTS_IN_REQUEST
오류와 함께 거부됩니다.
결제 및 계정 예산 서비스
월별 인보이스로 구성된 계정에 대해서만 대안을 사용할 수 있습니다.
이 제한을 위반하는 요청은
MUTATE_NOT_ALLOWED
오류와 함께 거부됩니다.변경 요청에는 1 연산만 허용됩니다.
이 제한을 위반하는 요청은
TOO_MANY_MUTATE_OPERATIONS
오류와 함께 거부됩니다.동일한 계정으로 예산 주문이 변경되려면 최소 12시간이 지나야 합니다. 12시간이 지나기 전에 변경할 경우 복구할 수 없는 오류가 발생할 수 있으며 이는 Google Ads 계정 담당자만 해결할 수 있습니다.
고객 계정 초대
신규 사용자는 CustomerUserAccessService
를 사용하여 기존 고객 계정에
초대할 수 있습니다. 이 기능은 다른 사용자에게 초대 이메일을 전송하므로 오용될 수 있으며 동작에 제한이 있습니다.
사용자는 동일한 클라이언트 계정에 대해 대기 중인 초대를 2개 이상 받을 수 없습니다. 이미 대기 중인 초대가 있는 사용자에게 초대를 보내라는 후속 요청이 이루어지면
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION
오류가 반환됩니다.고객 계정에서 한 번에 대기 중인 초대는 70개를 초과할 수 없습니다. 이 값을 초과하는 요청이 전송되면
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED
오류가 반환됩니다.
사용자 데이터
사용자 데이터는 UserDataService
및 OfflineUserDataJobService
를 통해 관리됩니다.
지정된 UserData
만들기/삭제 작업에서 user_identifiers
의 각 세트는 단일 사용자별로 지정되어야 합니다.
이를 적용하기 위해 UserData
집합에 user_identifiers
이 20개를 초과하면 OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
또는 UserDataError.TOO_MANY_USER_IDENTIFIERS
오류가 반환됩니다.
기타 한도 유형
작업 목록과 같이 요청에 항목이 너무 많은 반복되는 필드는 REQUEST_SIZE_LIMIT_EXCEEDED
오류를 발생시킬 수 있습니다.
이 오류 메시지는 다른 문제로 인한 것일 수도 있습니다.
이러한 제한이 발생하여 반복 필드를 사용하는 요청을 하는 경우, 뮤테이션 요청에 작업 목록을 배포하여 반복 필드의 항목 수를 줄여보세요.
GAQL 쿼리를 만들 때 IN
절 내 최대 항목 수는 20,000개입니다. 이 한도를 초과하면 FILTER_HAS_TOO_MANY_VALUES
오류가 반환됩니다.