리셀러 API 문제 해결

이 페이지에서는 Reseller API와 관련하여 발생할 수 있는 몇 가지 일반적인 문제에 대해 설명합니다.

400:badRequest

이 오류는 구독이 정지되거나 취소된 경우에 발생합니다. 자세한 내용은 구독 활성화를 참고하세요.

400:invalid

이 오류는 여러 가지 이유로 발생할 수 있습니다.

customers.insert 메서드를 사용하는 경우 다음 고객 객체 매개변수 중 하나가 잘못되었습니다.

  • postalAddress.postalCode 상태가 올바르지 않습니다.
  • Google Workspace를 postalAddress.countryCode를 재판매할 수 없습니다.
  • alternateEmail가 customerDomain와 동일한 도메인에 있을 수 없음

이 문제를 해결하려면 필요한 매개변수가 있고 고객에게 유효한지 확인합니다.

subscriptions.changeSeats 메서드를 사용하는 경우 다음 문제 중 하나로 인해 이 오류가 발생했을 수 있습니다.

  • 연간 요금제 유형의 사용 가능 라이선스 수는 줄일 수 없습니다. 갱신 설정을 변경해 보세요. 정기 결제의 경우 갱신 시 계정의 활성 사용자 수와 동일한 좌석이 자동으로 설정됩니다.
  • 요청한 사용 가능 라이선스 수가 계정의 현재 사용자 수보다 적습니다. 고객에게 사용자를 삭제해야 자리 수를 줄일 수 있다고 안내합니다.
  • 잘못된 좌석 매개변수를 늘렸습니다. FLEX 계획의 경우 maximumNumberOfSeats 매개변수를 늘리고 ANNUAL 계획의 경우 numberOfSeats 매개변수를 늘립니다.
  • 읽기 전용 매개변수인 licensedNumberOfSeats 매개변수를 변경하려고 했습니다.
  • 체험 기간 동안 고객의 최대 사용 가능 라이선스 수는 10개입니다. 무료 체험판 구독에서 유료 서비스를 시작하여 무료 체험 기간을 즉시 종료하고 결제를 시작하며 최대 10석의 한도를 삭제합니다.

403:forbidden

이 오류는 관리자가 고객을 소유하지 않거나 고객이 관리 콘솔에 대한 리셀러 액세스를 사용 중지한 경우에 발생합니다.

403:usageLimits.dailyLimitExceeded

이 오류는 이 API 호출의 일일 할당량에 도달했을 때 발생합니다. 이 문제를 해결하려면 백오프 지연을 구현하세요. 자세한 내용은 사용량 한도 및 할당량을 참고하세요.

많은 정기 결제를 가져오려고 하는 경우 customerId 또는 subscriptionId 매개변수를 지정하지 않고 subscriptions.list 메서드를 사용하는 것이 좋습니다. 호출당 최대 100개의 정기 결제를 반환할 수 있습니다. pageToken 매개변수를 사용하여 리셀러 계정의 모든 구독을 계속 가져옵니다.

403:usageLimits.accessNotConfigured

이 오류는 Google Cloud 프로젝트에서 API가 사용 설정되지 않은 경우 발생합니다. 이 문제를 해결하려면 Google Cloud 콘솔로 이동하여 API를 사용 설정하세요. 자세한 내용은 Google Workspace API 사용 설정을 참고하세요.

404:notFound

customers.get 메서드를 사용할 때 이 오류는 Google Workspace 계정에 고객 또는 도메인이 없으며 도메인을 사용할 수 있음을 의미합니다.

412:conditionNotMet

이 오류는 여러 가지 문제로 인해 발생합니다.

subscriptions.changeRenewalSettings 메서드를 사용할 때 이 오류가 발생하면 다음과 같은 약정 요금제에서만 이 메서드를 호출하고 있는지 확인하세요.

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

subscriptions.delete 메서드를 사용할 때 이 오류가 발생하면 Google Workspace 계정에 관리자 사용자가 없음을 의미합니다. 이 문제를 해결하려면 임시 관리자 사용자를 추가한 후 다시 시도하세요.

subscriptions.insert 메서드를 사용할 때 이 오류가 발생하면 선택한 SKU를 재판매할 수 없거나 신흥 시장 고객에게 판매할 수 없음을 의미합니다. 이 문제를 해결하려면 관련 서비스 약관에 동의하세요.

429:usageLimits.quotaExceeded

이 오류는 초당 쿼리 한도를 초과할 때 발생합니다. 이 문제를 해결하려면 백오프 재시도 전략을 구현하거나 결과를 캐시하여 API 호출 횟수를 줄입니다. 자세한 내용은 사용량 한도 및 할당량을 참고하세요.

많은 구독을 가져오려고 하는 경우 customerId 또는 subscriptionId 매개변수를 지정하지 않고 subscriptions.list 메서드를 사용하는 것이 좋습니다. 호출당 최대 100개의 정기 결제를 반환할 수 있습니다. pageToken 매개변수를 사용하여 리셀러 계정의 모든 구독을 계속 가져옵니다.