Устранение неполадок API реселлера

На этой странице описаны некоторые распространенные проблемы, с которыми вы можете столкнуться при использовании API для реселлеров.

400:badRequest

This error occurs when the subscription is either suspended or cancelled. For more information, see Activate a subscription .

400:invalid

Эта ошибка может возникнуть по ряду различных причин.

При использовании метода customers.insert один из следующих параметров объекта customer является недопустимым:

  • Неверный postalAddress.postalCode .
  • Недопустимый postalAddress.countryCode для перепродажи Google Workspace.
  • alternateEmail не может находиться в том же домене, что и customerDomain

Для решения этой проблемы убедитесь, что необходимые параметры присутствуют и действительны для клиента.

Если вы используете метод subscriptions.changeSeats , причиной этой ошибки могла быть одна из следующих проблем:

  • You can't reduce seats for annual plan types. Consider changing the renewal settings . for the subscription to automatically set (at time of renewal) seats equal to the amount of active users on the account.
  • Запрошенное вами количество рабочих мест меньше, чем количество текущих пользователей в учетной записи. Сообщите клиенту, что для уменьшения количества рабочих мест необходимо удалить пользователя.
  • Вы увеличили неверный параметр количества мест. Для плана FLEX увеличьте параметр maximumNumberOfSeats , а для плана ANNUAL — параметр numberOfSeats .
  • Вы попытались изменить параметр licensedNumberOfSeats , который является параметром только для чтения.
  • В течение пробного периода количество рабочих мест ограничено 10. Чтобы немедленно завершить пробный период, начать оплату и снять ограничение в 10 рабочих мест, можно перейти на платную услугу, используя бесплатную пробную подписку .

403:forbidden

Эта ошибка возникает, если вы не являетесь владельцем клиента или если ваш клиент отключил доступ реселлера к своей консоли администратора.

403:usageLimits.dailyLimitExceeded

Эта ошибка возникает, когда вы достигли суточной квоты на вызовы этого API. Для решения этой проблемы добавьте задержку. Дополнительную информацию см. в разделе «Ограничения использования и квоты» .

Если вам нужно получить много подписок, рассмотрите возможность использования метода subscriptions.list без указания параметров customerId или subscriptionId . За один вызов можно получить максимум 100 подписок. Используйте параметр pageToken , чтобы продолжить получение всех подписок в рамках учетной записи реселлера.

403:usageLimits.accessNotConfigured

Эта ошибка возникает, если API не включен в проекте Google Cloud. Для решения этой проблемы перейдите в консоль Google Cloud и включите API. Дополнительную информацию см. в разделе «Включение API Google Workspace» .

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. Дополнительную информацию см. в разделе «Лимиты использования и квоты» .

Если вам нужно получить много подписок, рассмотрите возможность использования метода subscriptions.list без указания параметров customerId или subscriptionId . За один вызов можно получить максимум 100 подписок. Используйте параметр pageToken , чтобы продолжить получение всех подписок в рамках учетной записи реселлера.