이 페이지에서는 리셀러 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 매개변수를 사용하여 리셀러 계정의 모든 구독을 계속 가져옵니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Troubleshoot Reseller API issues\n\nThis page describes some common issues that you might encounter involving the\nReseller API.\n\n`400:badRequest`\n----------------\n\nThis error occurs when the subscription is either suspended or cancelled. For\nmore information, see\n[Activate a subscription](/workspace/admin/reseller/v1/how-tos/change-subscription-status#activate_a_subscription).\n\n`400:invalid`\n-------------\n\nThis error can occur for a number of different reasons.\n\nIf you're using the `customers.insert` method, one of the following customer\nobject parameters are invalid:\n\n- Invalid `postalAddress.postalCode`.\n- Ineligible `postalAddress.countryCode` for reselling Google Workspace.\n- `alternateEmail` can't be at the same domain as `customerDomain`\n\nTo resolve this issue, verify that required parameters are present and valid for\nthe customer.\n\nIf you're using the `subscriptions.changeSeats` method, one of the following\nissues might have caused this error:\n\n- You can't reduce seats for annual plan types. Consider [changing the renewal settings](/workspace/admin/reseller/v1/reference/subscriptions/changeRenewalSettings). for the subscription to automatically set (at time of renewal) seats equal to the amount of active users on the account.\n- The seat amount that you requested is less than the current users on the account. Message customer that they must remove a user before they can decrease their seat count.\n- You increased the incorrect seat parameter. For the `FLEX` plan, increase the `maximumNumberOfSeats` parameter and for the `ANNUAL` plan, increase the `numberOfSeats` parameter.\n- You attempted to change the `licensedNumberOfSeats` parameter, which is a read-only parameter.\n- During the trial period, customers have a maximum seat limit of 10. [Start a paid service from a free trial subscription](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#start_paid_service_from_a_free_trial_subscription) to immediately end the trial period, start billing, and remove the 10 seat maximum limit.\n\n`403:forbidden`\n---------------\n\nThis error occurs when you don't own the customer or your customer has disabled\nreseller access to their Admin console.\n\n`403:usageLimits.dailyLimitExceeded`\n------------------------------------\n\nThis error occurs when you've reached the daily quota for calls to this API. To\nresolve this issue, implement a backoff delay. For more information, see\n[Usage limits and quotas](/workspace/admin/reseller/v1/limits).\n\nIf you're attempting to retrieve many subscriptions, consider using the\n`subscriptions.list` method without specifying the `customerId` or\n`subscriptionId` parameters. You can return a maximum of 100 subscriptions per\ncall. Use the `pageToken` parameter to continue retrieving all subscriptions\nunder a reseller account.\n\n`403:usageLimits.accessNotConfigured`\n-------------------------------------\n\nThis error occurs when the API isn't enabled in the Google Cloud project. To resolve\nthis issue, go to the Google Cloud console, and enable the API. For more\ninformation, see\n[Enable Google Workspace APIs](/workspace/guides/enable-apis).\n\n`404:notFound`\n--------------\n\nWhen using the `customers.get` method, this error means that the customer or\ndomain doesn't exist for any Google Workspace account and that the\ndomain is available.\n\n`412:conditionNotMet`\n---------------------\n\nThis error is caused by a number of different issues.\n\nIf you encounter this error when using the `subscriptions.changeRenewalSettings`\nmethod, make sure that you're only calling this method on the following\ncommittment payment plans:\n\n- `ANNUAL_MONTHLY_PAY`\n- `ANNUAL_YEARLY_PAY`\n\nIf you encounter this error when using the `subscriptions.delete` method, it\nmeans that there's no admin user present on the Google Workspace\naccount. To resolve this issue, add a temporary admin user and try again.\n\nIf you encounter this error when using the `subscriptions.insert` method, it\nmeans that you either can't resell the selected SKU or to the emerging market\ncustomer. To resolve this issue, accept the applicable terms of service.\n\n`429:usageLimits.quotaExceeded`\n-------------------------------\n\nThis error occurs when you've surpassed the queries per second limit. To\nresolve this issue, implement a backoff retry strategy or cache results to make\nfewer API calls. For more information, see\n[Usage limits and quotas](/workspace/admin/reseller/v1/limits).\n\nIf you're attempting to retrieve many subscriptions, consider using the\n`subscriptions.list` method without specifying the `customerId` or\n`subscriptionId` parameters. You can return a maximum of 100 subscriptions per\ncall. Use the `pageToken` parameter to continue retrieving all subscriptions\nunder a reseller account."]]
