API 한도 및 할당량

Google Ads API는 API 작업(예: 작업 수)에 한도를 적용합니다. 단일 뮤테이션 요청으로 보낼 수 있습니다. 다음 표에는 몇 가지 중요한 한도와 할당량을 살펴보겠습니다

요청 유형, 제한사항, 오류 코드
기본 액세스 권한이 있는 작업 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 요청 및 뮤추얼 연산의 총합입니다. 제한사항 개발자 토큰의 액세스 수준에 따라 일일 API 작업에 대한 액세스 수준이 달라집니다. 이 액세스 수준 및 허용되는 사용 가이드에서는 API 작업 한도를 설정할 수 있습니다.

이러한 한도를 위반하는 요청은 다음 오류와 함께 거부됩니다. RESOURCE_EXHAUSTED

gRPC 제한사항

모든 Google Ads API 클라이언트 라이브러리gRPC: 요청 및 응답 생성 기본적으로 gRPC에는 4MB로 설정되어 있지만 Google 클라이언트 라이브러리에서는 최대 메일 크기를 64MB의 여유 공간이 필요합니다.

응답은 이 한도를 초과하면 안 됩니다. 예를 들어 포함된 파일을 선택하면 크기가 64MB를 초과하는 응답이 생성될 수 있습니다. 받는사람 이 제한을 피하려면 선택한 필드의 수를 줄이거나 streaming입니다. 변형의 경우 더 적은 수의 작업을 전송합니다. 요청당

이 제한사항을 위반하는 요청은 다음을 생성하지 않습니다. GoogleAdsError이지만 gRPC 오류 429 Resource Exhausted개 자세한 내용은 gRPC 오류 코드 목록 및 메시지를 참조하세요.

요청 변형

사용자의 일일 작업 할당량을 계산하는 것 외에도 요청은 요청당 10,000개 이상의 작업을 포함할 수 없습니다.

이 제한사항을 위반하는 요청은 다음 오류와 함께 거부됩니다. TOO_MANY_MUTATE_OPERATIONS

특정 서비스 및 요청 유형에 대한 추가 한도와 고려사항은 다음과 같습니다. 다음에 설명하겠습니다.

검색 요청

Search 또는 SearchStream 요청은 사용자의 일일 작업 할당량입니다. SearchStream 요청 1건은 API 작업 1개로 집계됨 할 수 있습니다.

페이지로 나눈 요청

페이지로 나눈 요청 (예: 유효한 next_page_token)는 사용자의 일일 작업 할당량에 포함되지 않습니다. 만료되었거나 잘못된 페이지 토큰이 포함된 페이지로 나누기 요청은 예외가 생성되고 일일 작업 할당량에 포함됩니다.

페이지로 나누기에 관한 자세한 내용은 페이징 스루를 참고하세요. 결과를 참조하세요.

기타 요청 유형

Get, Mutate, Search 또는 SearchStream 요청이 아닌 요청 사용자의 일일 작업 할당량에서 작업 1회로 계산됩니다.

이러한 요청의 몇 가지 예는 다음과 같습니다.

API 예외를 반환하는 요청

GoogleAdsFailure은(는) 계속해서 일일 작업 할당량입니다.

실패하지만 GoogleAdsFailure(예: 네트워크 수준에서 사용자의 일일 작업 할당량에 포함되지 않음 요청이 서비스에 도달하지 않기 때문입니다. 이와 관련된 예는 네트워크 연결에 문제가 있습니다.

계획 서비스

비용과 복잡성으로 인해 다음 Planning 서비스 방법은 다른 유형의 요청과 별도의 제한이 적용됩니다.

키워드 계획을 만들 때는 이러한 제한을 염두에 두시기 바랍니다.

키워드 계획 객체 최대 개수
계정당 KeywordPlan 10,000
KeywordPlanKeywordPlanAdGroup 200
KeywordPlanKeywordPlanAdGroupKeyword 10,000
KeywordPlanCampaignKeyword (제외 키워드) 1,000
KeywordPlanKeywordPlanCampaign 1

전환 업로드 서비스

전환 조정 업로드 서비스

결제 및 계정 예산 서비스

  • 월별 인보이스로 구성된 계정에 대해서만 변경이 가능합니다.

    이 제한사항을 위반하는 요청은 다음 오류와 함께 거부됩니다. MUTATE_NOT_ALLOWED

  • 변형 요청에는 연산이 1개만 허용됩니다.

    이 제한사항을 위반하는 요청은 다음 오류와 함께 거부됩니다. TOO_MANY_MUTATE_OPERATIONS

  • 예산 주문을 변경하려면 12시간 이상 기다려야 합니다. 있습니다. 12시간이 지나기 전에 변경하면 Google Ads 계정에서만 해결할 수 있는 복구 불가능한 오류 담당자로 문의하시기 바랍니다.

고객 계정 초대

신규 사용자는 CustomerUserAccessService 왜냐하면 이 기능을 통해 다른 사용자에게 초대 이메일을 보낼 수 있으며, 따라서 동작에 제한이 있습니다.

사용자 데이터

사용자 데이터는 UserDataServiceOfflineUserDataJobService 지정된 생성 또는 삭제 UserData 작업에서 각각은 user_identifiers 세트 단일 사용자에 국한되어야 합니다

이를 시행하려면 OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS 또는 UserDataError.TOO_MANY_USER_IDENTIFIERS 한 열에 user_identifiers가 20개를 초과하면 UserData 설정됨.

기타 한도 유형

작업 목록과 같이 다음 오류가 발생할 수 있습니다. REQUEST_SIZE_LIMIT_EXCEEDED 이 오류 메시지는 다른 문제로 인해 발생할 수도 있습니다.

이러한 제한이 발생하고 반복 필드의 항목 수를 줄임으로써 변경 요청의 연산 목록입니다.

GAQL 쿼리를 실행할 때 최대 항목 개수는 20,000개라는 사실을 기억하실 겁니다IN 이 한도를 초과하면 FILTER_HAS_TOO_MANY_VALUES 오류가 반환됩니다.