할당량 및 한도

판매자 계정 및 판매자 API 사용에는 할당량과 한도가 적용됩니다.

정책 업데이트

Merchant API는 업데이트와 관련하여 다음 정책을 적용합니다.

  • 제품은 하루에 최대 두 번만 업데이트할 수 있습니다.
  • 하위 계정은 하루에 한 번만 업데이트할 수 있습니다.

메서드 호출 할당량

Merchant API는 사용량에 따라 products 및 accounts의 호출 할당량을 자동으로 조정합니다.

Google에서 할당량 사용량을 추적하는 방법은 다음과 같습니다.

  • 할당량은 메서드별로 적용됩니다. 예를 들어 get 메서드에는 update 메서드와 별도의 할당량이 있습니다.
  • 각 요청은 유형에 관계없이 한 번씩 계산됩니다. 예를 들어 항목 250개의 list 요청은 250개의 get 요청이 아닌 한 번으로 계산됩니다.
  • 할당량은 API 요청을 하는 사용자를 기준으로 청구됩니다. 사용자가 고급 계정의 직접 구성원인 경우 할당량은 고급 계정 수준에서 청구됩니다.
  • 할당량은 호출 시 인증하는 비교 쇼핑 서비스 (CSS) 그룹, CSS, 계정 또는 하위 계정에 적용됩니다. 예를 들어 고급 계정으로 인증하면 호출이 고급 계정의 할당량에 포함되지만 하위 계정 중 하나로 인증하면 호출이 하위 계정의 할당량에 포함됩니다.

이 다이어그램은 CSS 그룹, CSS, 계정, 하위 계정의 계층 구조를 보여줍니다. CSS 그룹은 전반적인 인증 수준이며, 그 안에 개별 CSS, 해당 CSS 내의 계정, 가장 개별적인 수준인 하위 계정이 있을 수 있습니다.

Content API for Shopping의 메서드 호출 할당량 변경사항

Content API for Shopping을 사용한 경우 Merchant API의 다음 메서드 호출 할당량 변경사항을 참고하세요.

  • 맞춤 일괄 처리가 없어도 할당량 계산에는 영향을 미치지 않습니다. 예를 들어 삽입 요청 500개가 포함된 일괄 요청은 개별 삽입 메서드 요청 500개로 청구됩니다.
  • 계정 및 제품의 할당량 자동화는 그대로 유지됩니다.
  • 자동화 및 재정의를 비롯한 현재 할당량 사용량과 한도를 확인하려면 Quota.list 메서드를 사용하세요.

통화 할당량 확인

계정의 현재 호출 할당량과 사용량을 확인하려면 계정의 name를 사용하여 quotas.list를 호출합니다.

자동 할당량은 products 및 accounts 서비스에만 적용됩니다. 다른 서비스의 할당량을 늘려야 하거나, products 또는 accounts 서비스의 일일 할당량에 도달했거나, accounts 또는 제품 services의 할당량을 일시적으로 늘려야 하는 경우 다음 정보를 포함하여 Google에 문의하세요.

  • 판매자 센터 ID
  • 할당량 한도에 도달한 메서드
  • 이러한 메서드에 필요한 일일 호출 수의 추정치
  • 할당량 상향이 필요한 이유
  • 임시 또는 영구 증가 여부

구현에 충분한 할당량이 있는지 또는 할당량이 자동으로 조정되는 방식을 확인하려면 할당량을 주기적으로 확인하는 것이 좋습니다.

오류

할당량을 초과하면 다음과 같은 오류가 표시됩니다.

  • 분당: quota/request_rate_too_high
  • 일별: quota/daily_limit_exceeded

할당량 및 사용량을 확인하고 일별 또는 분당 할당량 증가를 요청하려면 호출 할당량 확인을 참고하세요.

다음 오류는 자동 할당량 증가로 해결할 수 없으며 항목, 피드 또는 하위 계정의 추가 할당량을 요청해야 합니다.

  • too_many_items: Merchant quota exceeded
  • too_many_subaccounts: Maximum number of sub-accounts reached

계정 한도

accounts.limits.get 및 accounts.limits.list 메서드를 사용하면 계정 수준 항목의 한도를 확인할 수 있습니다. 이러한 메서드를 사용하여 제품 한도를 확인할 수 있습니다.

특정 제품 한도를 가져오려면(예: 계정의 광고 EEA 할당량을 가져오려면) accounts.limits.get 호출에서 계정 ID와 한도 ID를 지정해야 합니다. 한도 ID는 한도 유형과 범위의 조합입니다. 예를 들어 EEA에서 광고를 타겟팅하는 제품의 경우 products~ADS_EEA, EEA 외부에서 광고를 타겟팅하는 제품의 경우 products~ADS_NON_EEA입니다.

다음은 특정 계정의 products~ADS_EEA 한도를 가져오는 요청의 예입니다.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

계정에 사용할 수 있는 한도 ID를 알아보려면 type="products" 필터와 함께 accounts.limits.list를 사용하세요.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

제품 할당량에 대한 자세한 내용은 Google 판매자 센터의 할당량 이해하기를 참고하세요.

리소스 표현 한도

다음 한도는 Merchant API에 사용되는 리소스 표현 내의 특정 문자열 값과 배열 필드에 적용되는 주목할 만한 제한사항을 설명합니다. 이러한 한도는 Merchant API와 판매자 센터의 해당 기능에 모두 동일하게 적용됩니다.

이 한도 목록은 완전하지 않을 수 있습니다. 이러한 한도는 연장되지 않습니다.

리소스 필드 한도
shippingsettings

국가별 배송 서비스 (services)

배송 서비스별 배송 그룹 (rateGroups)

배송 그룹별 라벨 (applicableShippingLabels)

배송 그룹별 하위 표 (subtables)

단일 요금표의 행 수 또는 열 수입니다.

배송물 라벨 길이입니다.

20

20

30

100

150

100

요금 표의 행 수 또는 열 수는 다음 배열 필드에 영향을 미칩니다.

  • rowHeaders 또는 columnHeaders 내 배열 필드:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]