Google ads api 시스템 한도 2059ed60ad7d80b5a1a7c08535e0d480 - all-ad/all-ad GitHub Wiki

시스템 한도

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

2.2 타겟 사용자 세그먼트 (수정된 내용)

  • Primary Target (주요 타겟): 1인 기업부터 중견기업까지, 특히 마케팅 툴 사용에 익숙하지 않거나 1인이 다수의 광고 채널 운영 및 기타 업무를 동시에 처리해야 하는 환경에 놓인 담당자 및 사업주를 핵심 타겟으로 합니다. 이들은 시간 부족과 여러 플랫폼 관리의 복잡함으로 인해 광고 운영 효율화 및 통합 리포팅에 대한 니즈가 매우 큽니다.
  • Overall Target (전체 타겟): 광고 채널 수나 데이터 분석 수준에 관계없이, 두 개 이상의 광고 플랫폼을 운영하는 모든 개인 및 기업을 잠재 고객으로 설정합니다. '올애드'를 통해 자연스럽게 데이터 기반 의사결정을 경험하도록 지원하는 것을 목표로 합니다.

5.2 요금제 구조 (새로운 버전별 계획)

버전 1 (초기 출시 버전):

  • 가격 모델: 전체 무료
  • 이용 가능 플랫폼: 구글(Google Ads), 메타(Meta Ads)
  • 이용 가능 인원: 계정당 최대 5명
  • API 호출 제한: 호출 횟수 자체는 무제한이나, 데이터 업데이트는 시간당 1회로 제한

버전 2 (기능 확장 후):

  • 가격 모델: 부분 무료 (Freemium) 및 구독 기반
  • 요금제 세부 구조:
    • Free Plan:
      • 이용 가능 플랫폼: 구글(Google Ads), 메타(Meta Ads)
      • 이용 가능 인원: 계정당 최대 2명
      • API 호출 제한: 1일 2회 (데이터 업데이트 주기)
    • Starter Plan: (유료)
      • Free Plan 모든 기능 포함
      • 추가 연동 플랫폼: 네이버 광고(Naver Ads), 쿠팡 애즈(Coupang Ads)
      • 이용 가능 인원: 계정당 최대 3명
      • API 호출 제한: 1일 3회
    • Plus Plan: (유료)
      • Starter Plan 모든 기능 포함
      • 추가 연동 플랫폼: 올애드에서 제공하는 모든 플랫폼 연동 가능
      • 이용 가능 인원: 계정당 최대 5명
      • API 호출 제한: 1일 5회
    • Pro Plan: (유료)
      • Plus Plan 모든 기능 포함
      • API 호출 제한: 무제한 (실시간 또는 매우 빈번한 데이터 업데이트 가능)
      • 이용 가능 인원: 계정당 최대 10명

사용자 역할 및 구조

1. Master (마스터):

  • 권한: 계정 내 모든 설정 및 기능에 접근하고 관리할 수 있는 최상위 관리자입니다.
  • 주요 기능:
    • 광고 플랫폼 계정 연동 및 해제
    • 요금제 관리 및 결제 정보 변경
    • 모든 대시보드 및 리포트 생성, 조회, 수정, 삭제
    • 모든 캠페인 데이터 조회
    • 모든 캠페인 관리 기능 사용 (ON/OFF, 예산 변경, 생성, 수정, 삭제 등 - 향후 구현될 기능 포함)
    • 모든 사용자(Master, Team Mate, Viewer) 초대, 역할 변경, 삭제
    • 서비스 관련 모든 알림 및 설정 변경
  • 용도: 계정 소유자, 핵심 관리자, 에이전시 대표 등

2. Team Mate (팀 메이트):

  • 권한: 광고 캠페인 운영 및 관리에 필요한 주요 편집 권한과 하위 사용자 초대 권한을 가집니다.
  • 주요 기능:
    • 할당된 또는 전체 광고 플랫폼 데이터 조회
    • 대시보드 및 리포트 조회 (생성/수정 권한은 Master가 부여 가능 여부 결정 필요)
    • 담당 캠페인 편집 가능 (ON/OFF, 예산 변경, 타겟팅 수정 등 - 향후 구현될 기능 포함)
    • 신규 사용자 초대 (초대 가능한 역할 범위는 Master가 설정)
    • 캠페인 성과 관련 알림 수신
  • 용도: 실무 마케터, 캠페인 운영 담당자, 에이전시 팀원 등

3. Viewer (뷰어):

  • 권한: 데이터 조회만 가능한 읽기 전용 사용자입니다.
  • 주요 기능:
    • 할당된 광고 플랫폼 데이터 및 대시보드, 리포트 조회
    • 모든 편집 및 설정 변경 불가
    • 사용자 초대 불가
  • 용도: 성과 보고를 받아보는 클라이언트, 의사결정을 위한 데이터 참고가 필요한 내부 임원 또는 팀원 등

4. 최고 운영자 계정 (King of Master ID - '올애드' 내부 관리용):

  • 정의: 이 계정은 '올애드(All-AD)' 서비스 운영팀 내부에서 사용하는 특수 관리 계정으로, 일반 사용자에게 할당되거나 직접 제공되지 않습니다.
  • 주요 목적:
    • 고객 지원: 사용자의 명시적인 요청 또는 동의가 있을 경우, 기술적 문제 해결, 복잡한 설정 지원, 오류 진단 등을 위해 해당 사용자 계정에 접근하여 지원합니다.
    • 시스템 유지보수: 서비스의 안정성 확보, 데이터 무결성 검증, 시스템 업데이트 등 내부적인 시스템 관리 및 운영을 위해 사용됩니다.
    • 계정 관련 긴급 상황 대응: 사용자의 계정 복구 지원(정상적인 절차로 불가능할 경우) 등 긴급한 문제 해결을 위해 사용될 수 있습니다.
  • 권한 및 통제:
    • 이론적으로 서비스 내 모든 사용자 계정 및 데이터에 대한 접근 권한을 가질 수 있으나, 실제 접근은 엄격한 내부 보안 정책, 다중 인증(MFA), 접근 통제 프로토콜, 명확한 승인 절차에 따라 제한적으로 허용됩니다.
    • 모든 접근 및 작업 내역은 상세한 감사 로그(Audit Log)로 기록되어 투명성과 책임성을 확보합니다.
    • 운영팀의 계정 접근은 개인정보보호법 등 관련 법규를 철저히 준수하며, 이용약관 및 개인정보처리방침에 명시된 절차에 따라 필요한 경우 사용자에게 고지되거나 동의를 구하는 것을 원칙으로 합니다.
  • 성격: 일반적인 사용자 역할과 달리, 서비스 제공 및 유지를 위한 내부 운영 및 기술 지원을 위한 관리자 권한입니다.
⚠️ **GitHub.com Fallback** ⚠️