시스템 한도

이 페이지에는 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
예방 자세한 내용은 텍스트 광고 정보를 참고하세요.
Description1 또는 description2 길이
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 characters
오류 CriterionError.KEYWORD_TEXT_TOO_LONG
예방 --
게재위치 URL 길이
250자(영문 기준)
오류 CriterionError.PLACEMENT_URL_IS_TOO_LONG
예방 프로토콜 접두사 (예: 'http://')는 게재위치 URL에서 제거되며 이 한도에 포함되지 않습니다.
최종 URL 길이
2,047바이트
오류 StringLengthError.TOO_LONG
예방 프로토콜 접두사 (예: 'http://')는 이 한도에 포함됩니다.
근접도 반경
800 km / 500 mi
오류 CriterionError.INVALID_PROXIMITY_RADIUS
예방 --
ProductPartition 트리의 구조를 수정하는 단일 요청의 최대 쇼핑 광고 그룹 수입니다.
2
오류 AdGroupCriterionError.OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS
예방 이 제한은 트리의 구조를 수정하지 않는 ProductPartition 기준 변경 작업에는 적용되지 않습니다. 예를 들어 기존 파티션의 입찰가만 수정하는 요청에는 두 개가 넘는 쇼핑 광고 그룹의 작업이 포함될 수 있습니다.두 개가 넘는 쇼핑 광고 그룹의 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 비즈니스 개발 담당자에게 문의하여 한도를 높일 수 있는지 확인하세요.
캠페인의 최대 애셋 그룹 수
100
오류 ResourceCountLimitExceededError.RESOURCE_LIMIT
예방 --
애셋 그룹의 최대 등록정보 그룹 필터 수
1,000
오류 ResourceCountLimitExceededError.RESOURCE_LIMIT
예방 --
캠페인의 등록정보 그룹 필터 하위 그룹 최대 개수
7
오류 AssetGroupListingGroupFilterError.TREE_TOO_DEEP
예방 --

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