Reseller API

`customers.insert`

400:invalid

Cause
One of the customer object parameters is invalid Common causes for this error: Invalid `postalAddress.postalCode` Ineligible `postalAddress.countryCode` for reselling Google Workspace `alternateEmail` cannot be at the same domain as `customerDomain`

Recommendation
Verify that required parameters are present and valid for the customer. Only 6 parameters are required to create a customer: `customerDomain` `alternateEmail` `postalAddress.contactName` `postalAddress.organizationName` `postalAddress.postalCode` `postalAddress.countryCode`

`customers.get`

404:notFound

Cause
Customer/Domain does not exist for any Google Workspace Account

Recommendation
This is the desired error when attempting to create a new Google Workspace account. It signals that the input domain is available for creating a Google Workspace account.

429:usageLimits.quotaExceeded

Cause
Queries per second limit has been surpassed.

Recommendation
Implement a backoff retry strategy or cache results to make fewer API calls.

`subscriptions.changeRenewalSettings`

412:conditionNotMet

Cause
Renewal settings don't apply to flexible or trial payment plans

Recommendation
Make sure you only call this method on commitment payment plans: `ANNUAL_MONTHLY_PAY` `ANNUAL_YEARLY_PAY`

`subscriptions.changeSeats`

400:badRequest

Cause
Subscription is either suspended or cancelled

Recommendation
Verify that the subscription is active and customer is still under your reseller account

400:invalid

Cause
Several possible causes: Seat reduction is not allowed for annual plan types Seat amount requested is less than current users on account Increased the incorrect seat parameter or attempted to change `licensedNumberOfSeats` parameter which is read-only During trial period, customers have a maximum seat limit of 10

Recommendation

Recommendation
Seat reduction is not allowed for annual plan types Consider changing renewal settings for the subscription to automatically set (at time of renewal) seats equal to the amount of active users on the account Seat amount requested is less than current users on account Message customer that they must remove a user before they can decrease their seat count Increased the incorrect seat parameter or attempted to change licensedNumberOfSeats parameter which is read-only For FLEX, increase `maximumNumberOfSeats` For ANNUAL, increase `numberOfSeats` During trial period, customers have a maximum seat limit of 10 Calling subscriptions.startPaidService will immediately end the trial period, commence billing, and remove the 10 seat maximum limit

Seat reduction is not allowed for annual plan types

Consider changing renewal settings for the subscription to automatically set (at time of renewal) seats equal to the amount of active users on the account

Seat amount requested is less than current users on account

Message customer that they must remove a user before they can decrease their seat count

Increased the incorrect seat parameter or attempted to change licensedNumberOfSeats parameter which is read-only

For FLEX, increase maximumNumberOfSeats
For ANNUAL, increase numberOfSeats

During trial period, customers have a maximum seat limit of 10

Calling subscriptions.startPaidService will immediately end the trial period, commence billing, and remove the 10 seat maximum limit

`subscriptions.delete`

403:forbidden

Cause
Reseller no longer owns the customer or they never did

Recommendation
Either call customers.get before making these calls or keep better syncing of local customers

412:conditionNotMet

Cause
Transfers to direct are not allowed if no admin user is present on the Google Workspace account

Recommendation
Add a temporary admin user then retry transfer: `users.insert` `users.makeAdmin` `subscriptions.delete`

`subscriptions.get`

403:forbidden

Cause
Reseller no longer owns the customer or they never did

Recommendation
Either call `customers.get` before making these calls or keep better syncing of local customers

403:usageLimits.dailyLimitExceeded

Cause
Daily quota for calls on this API has been reached. Too many calls were made likely a cause of no delay in retry logic.

Recommendation
Implement a backoff delay. If attempting to retrieve many subscriptions, consider using `subscriptions.list` without specifying customerId or subscriptionId. 100 subscriptions can be returned max per call. Use `pageToken` parameter to continue retrieving all subscriptions under reseller account.

429:usageLimits.quotaExceeded

Cause
Queries per second limit has been surpassed.

Recommendation
Implement a backoff delay. If attempting to retrieve many subscriptions, consider using `subscriptions.list` without specifying customerId or subscriptionId. 100 subscriptions can be returned max per call. Use `pageToken` parameter to continue retrieving all subscriptions under reseller account.

`subscriptions.insert`

412:conditionNotMet

Cause
Reseller is not enabled to either: Sell selected SKU Sell to emerging market customer

Recommendation
Accept the applicable terms of service: Google Drive Storage ToS Google Vault ToS Emerging Market Pricing ToS Cloud Identity ToS

`subscriptions.list`

403:forbidden

Cause
Reseller no longer owns the customer or they never did

Recommendation
Either call customers.get before making these calls or keep better syncing of local customers

403:usageLimits.accessNotConfigured

Cause
Reseller API is not enabled in your cloud project

Recommendation
Go to your cloud console and enable the Reseller API in your project

429:usageLimits.quotaExceeded

Cause
Queries per second limit has been surpassed.

Recommendation
Implement a backoff retry strategy or cache results to make fewer API calls.