리셀러 API 문제 해결

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

400:badRequest

이 오류는 구독이 정지되거나 취소되었을 때 발생합니다. 자세한 내용은 정기 결제 활성화를 참고하세요.

400:invalid

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

customers.insert 메서드를 사용하는 경우 다음 고객 객체 매개변수 중 하나가 유효하지 않습니다.

  • postalAddress.postalCode 상태가 올바르지 않습니다.
  • postalAddress.countryCode의 Google Workspace 재판매 대상이 아닙니다.
  • 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 매개변수를 사용하여 리셀러 계정의 모든 정기 결제를 계속 검색합니다.