시스템 제한

이 페이지에는 Google Ads API의 다양한 한도와 한도를 초과할 때 발생하는 해당 오류가 나와 있습니다.

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

참고: 문자열 값의 바이트 제한을 계산할 때는 UTF-8 인코딩이 사용됩니다. 2026년 6월 1일부터 상세 보고 세분화 (일별, 시간별, 주별)는 37개월의 전환 확인 기간으로 제한됩니다. 37개월보다 오래된 상세 날짜 세그먼트를 쿼리하면 DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED이 반환됩니다(v24부터).

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 characters 오류 StringLengthError.TOO_LONG 예방 --

Ads
반응형 검색 광고 제목 길이	값 30자 오류 AdError.LINE_TOO_WIDE 예방 자세한 내용은 반응형 검색 광고 정보를 참고하세요.
반응형 검색 광고 설명 길이	값 90자 오류 AdError.LINE_TOO_WIDE 예방 위의 내용을 참조하세요.
경로1 또는 경로2 길이	값 15 characters 오류 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://' 등)는 이 한도에 포함됩니다.
근접 반경	값 800km / 500마일 오류 CriterionError.INVALID_PROXIMITY_RADIUS 예방 --
ProductPartition 트리의 구조를 수정하는 단일 요청의 최대 쇼핑 광고 그룹 수	값 2 오류 AdGroupCriterionError.OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS 예방 이 제한은 트리 구조를 수정하지 않는 ProductPartition 기준 변경 작업에는 적용되지 않습니다. 예를 들어 기존 파티션의 입찰가만 수정하는 요청에는 두 개 이상의 쇼핑 광고 그룹에 대한 작업이 포함될 수 있습니다. 두 개 이상의 쇼핑 광고 그룹의 ProductPartition 트리를 수정하려면 이 제한사항이 적용되지 않는 일괄 작업을 사용하는 것이 좋습니다.
캠페인당 제외된 IP 블록	값 500 오류 ResourceCountLimitExceededError.CAMPAIGN_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를 받는 경우가 드물게 있습니다. 이는 내부 리소스가 마샬링되고 내부 한도를 초과하는 종속 항목의 팬아웃이 있을 때 발생합니다. 쿼리의 크기나 복잡성을 줄여 보세요. 필요한 결과를 얻기 위해 쿼리를 두 개 이상 실행해야 할 수 있습니다.