할당량 및 한도

Merchant API 기능에는 엄격한 할당량과 한도가 적용됩니다.

정책 업데이트

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

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

Merchant API와 Shopping용 Content API 간의 할당량 관련 변경사항

  • 할당량은 메서드별이 아닌 리소스별로 집계됩니다. 즉, 일부 서비스가 이제 연결되었습니다.
  • 맞춤 일괄 처리가 없더라도 할당량 계산에는 영향을 미치지 않습니다. 예를 들어 삽입 요청 500개가 포함된 일괄 요청에는 개별 삽입 메서드 요청 500개로 비용이 청구됩니다.
  • 계정 및 제품의 할당량 자동화는 계속 유지됩니다.
  • 자동화 및 재정의를 비롯한 현재 할당량 사용량 및 한도를 확인하려면 Quota.list 메서드를 사용하세요.

메서드 호출 할당량

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

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

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

이 다이어그램은 CSS 그룹, CSS, 계정, 하위 계정의 계층 구조를 보여줍니다. CSS 그룹은 가장 상위 인증 수준으로, 그 안에 개별 CSS가 있을 수 있으며, 그 안에 계정이 있고 가장 하위 수준으로 하위 계정이 있습니다.

내 할당량 확인

계정의 현재 할당량과 사용량을 확인하려면 계정의 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

리소스 표현 한도

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

이 제한 목록은 일부에 불과하며, 더 많은 제한사항이 있을 수 있습니다. 이 한도는 연장되지 않습니다.

리소스 필드 한도
shippingsettings

국가별 배송 서비스 (services)

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

배송 그룹당 라벨 (applicableShippingLabels)

배송 그룹별 하위 표 (subtables)

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

배송물 라벨의 길이입니다.

20

20

30

100

150

100

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

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