시스템 한도

이 페이지에서는 Google Ads API의 다양한 한도와 한도를 초과할 때 발생하는 오류에 대해 설명합니다.

계정당 최대 캠페인 수와 같은 제품 한도는 Google Ads 계정 한도 정보를 참조하세요.

Account

관리자 계정 계층 구조의 최대 Google Ads 계정 수
기타
오류 ManagerLinkError.TOO_MANY_ACCOUNTS
예방 자세한 내용은 관리자 계정의 최대 계정 한도 정보를 참조하세요.
관리자 계정 계층 구조의 최대 테스트 계정 수
50
오류 ManagerLinkError.TOO_MANY_ACCOUNTS
예방 --
Google Ads 계정에서 관리할 수 있는 최대 관리자 계정 수
5
오류 ManagerLinkError.TOO_MANY_MANAGERS
예방 자세한 내용은 관리자 연결 오류 정보를 참고하세요.
계층 구조의 최대 수준 수(최상위 관리자 계정에서 최하위 Google Ads 계정까지)
6
오류 ManagerLinkError.MAX_DEPTH_EXCEEDED
예방 자세한 내용은 관리자 연결 오류 정보를 참고하세요.
동일한 계층에서 대기 중인 관리자 계정 초대의 최대 개수
20
오류 ManagerLinkError.TOO_MANY_INVITES
예방 자세한 내용은 관리자 연결 오류 정보를 참고하세요.
이름 길이
255자(영문 기준)
오류 StringLengthError.TOO_LONG
예방 --

Ads

광고 제목 길이
30자(영문 기준)
오류 AdError.LINE_TOO_WIDE
예방 자세한 내용은 텍스트 광고에 대한 정보를 참고하세요.
설명 1 또는 설명 2 길이
90자(영문 기준)
오류 AdError.LINE_TOO_WIDE
예방 위의 내용을 참조하세요.
Path1 또는 path2 길이
15자(영문 기준)
오류 AdError.LINE_TOO_WIDE
예방 위의 내용을 참조하세요.
최종 URL 길이
2,084바이트
오류 StringLengthError.TOO_LONG
예방 최종 URL에는 프로토콜 프리픽스 (예: 'https://')가 필요하며 이 한도에 포함됩니다.

Ad group

이름 길이
256자(영문 기준)
오류 AdGroupError.INVALID_ADGROUP_NAME
예방 --

Campaign budget

계정의 최대 공유 예산 수
11,000명
오류 ResourceCountLimitExceededError.ACCOUNT_LIMIT
예방 예산 한도는 캠페인 수 한도보다 1,000개 더 많으므로 필요한 경우 예산을 재할당할 수 있습니다. 예산을 공유할 수 있는 캠페인 수에는 제한이 없습니다.
계정의 최대 비공유 예산 수
20,000명
오류 ResourceCountLimitExceededError.ACCOUNT_LIMIT
예방 특정 캠페인과 연결된 예산이며 캠페인 간에 공유할 수 없습니다.

Campaign

캠페인당 광고그룹에 연결된 입찰 전략 최대 개수
1,000
오류 ResourceCountLimitExceededError.CAMPAIGN_LIMIT
예방 --
이름 길이
256자(영문 기준)
오류 StringLengthError.TOO_LONG
예방 --

Conversion upload

API 호출당 업로드할 수 있는 최대 오프라인 클릭 전환수
2,000명
오류 ConversionUploadError.TOO_MANY_CONVERSIONS_IN_REQUEST
예방 성능상의 이유로 API 요청당 업로드할 수 있는 전환수는 2,000회로 제한됩니다.

Criterion

키워드 길이
80자(영문 기준)
오류 CriterionError.KEYWORD_TEXT_TOO_LONG
예방 --
게재위치 URL 길이
250자(영문 기준)
오류 CriterionError.PLACEMENT_URL_IS_TOO_LONG
예방 프로토콜 프리픽스 (예: 'http://')는 게재위치 URL에서 제외되며 이 한도에 포함되지 않습니다.
최종 URL 길이
2,047바이트
오류 StringLengthError.TOO_LONG
예방 프로토콜 프리픽스 (예: 'http://')도 이 한도에 포함됩니다.
근접 반경
800km / 500마일
오류 CriterionError.INVALID_PROXIMITY_RADIUS
예방 --
ProductPartition 트리의 구조를 수정하는 단일 요청의 최대 쇼핑 광고 그룹 수
2
오류 AdGroupCriterionError.OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS
예방 이 제한은 트리 구조를 수정하지 않는 ProductPartition 기준 변경 작업에는 적용되지 않습니다. 예를 들어 기존 파티션의 입찰가만 수정하는 요청에는 3개 이상의 쇼핑 광고 그룹에 대한 작업이 포함될 수 있습니다.3개 이상의 쇼핑 광고 그룹에 대한 ProductPartition 트리 구조를 수정하려면 이 제한이 적용되지 않는 일괄 작업을 사용하는 것이 좋습니다.
캠페인당 제외된 IP 블록
500
오류 ResourceCountLimitExceededError.CAMPAIGN_LIMIT
예방 --

Feed

계정당 피드
100
오류 ResourceCountLimitExceededError.ACCOUNT_LIMIT
예방 가능하면 확장 유형당 하나의 피드만 사용하는 것이 좋습니다.
계정당 피드 항목
5,000,000개
오류 ResourceCountLimitExceededError.ACCOUNT_LIMIT
예방 --
피드당 피드 속성
30
오류 ResourceCountLimitExceededError.ACCOUNT_LIMIT
예방 --
일치 함수당 피드 항목
20
오류 ResourceCountLimitExceededError.ACCOUNT_LIMIT
예방 --

Label

관리자 계정에서 계정에 적용할 수 있는 최대 라벨 수
200
오류 ResourceCountLimitExceededError.ACCOUNT_LIMIT
예방 --
라벨을 적용할 수 있는 최대 계정 수
1,000
오류 ResourceCountLimitExceededError.ACCOUNT_LIMIT
예방 --
계정당 항목 (캠페인, 광고 그룹 등)에 적용할 수 있는 최대 라벨 수
100,000명
오류 ResourceCountLimitExceededError.CAMPAIGN_LIMIT, ADGROUP_LIMIT, etc.
예방 모든 항목 유형의 라벨이 동일한 한도에 포함됩니다.
단일 항목 (캠페인, 광고 그룹 등)에 적용할 수 있는 최대 라벨 수
50
오류 ResourceCountLimitExceededError.CAMPAIGN_LIMIT, ADGROUP_LIMIT, etc.
예방 --

Listing groups

광고 그룹당 최대 등록정보 그룹 수
20,000명
오류 ResourceCountLimitExceededError.RESOURCE_LIMIT
예방 --

Payments account

결제 계정에 연결할 수 있는 최대 결제 설정 수
75,000명
오류 BillingSetupError.PAYMENTS_ACCOUNT_INELIGIBLE
예방 --

Performance Max

계정당 최대 실적 최대화 캠페인 수
100
오류 ResourceCountLimitExceededError.ACCOUNT_LIMIT
예방 자세한 내용은 최대 계정 한도를 참고하세요. 한도를 늘리려면 Google BD/계약 담당 담당자에게 문의하세요.
캠페인에 있는 최대 애셋 그룹 수
100
오류 ResourceCountLimitExceededError.RESOURCE_LIMIT
예방 --
애셋 그룹당 등록정보 그룹 필터의 최대 개수
1,000
오류 ResourceCountLimitExceededError.RESOURCE_LIMIT
예방 --
캠페인에서 등록정보 그룹 필터 하위 그룹의 최대 수
7
오류 AssetGroupListingGroupFilterError.TREE_TOO_DEEP
예방 --

드물지만 위의 한도를 초과하지 않더라도 INTERNAL_ERROR가 발생할 수 있습니다. 이는 내부 리소스가 마샬링되고 내부 한도를 초과하는 종속 항목의 팬아웃이 발생한 경우 발생합니다. 쿼리의 크기나 복잡성을 줄여보세요. 필요한 결과를 얻으려면 쿼리를 두 개 이상 실행해야 할 수 있습니다.