시스템 한도

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

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

참고: 문자열 값의 바이트 제한을 계산할 때는 UTF-8 인코딩이 사용됩니다.

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가 발생할 수 있습니다. 이는 내부 리소스가 마샬링되고 내부 한도를 초과하는 종속 항목의 팬아웃이 발생한 경우 발생합니다. 쿼리의 크기나 복잡성을 줄여보세요. 필요한 결과를 얻으려면 쿼리를 두 개 이상 실행해야 할 수 있습니다.