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

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

400:badRequest

Эта ошибка возникает, когда подписка приостановлена или отменена. Подробнее см. в разделе Активация подписки .

400:invalid

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

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

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

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

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

  • Уменьшение количества мест для годовых планов невозможно. Рекомендуем изменить настройки продления , чтобы подписка автоматически устанавливала (при продлении) количество мест, равное количеству активных пользователей в учётной записи.
  • Запрошенное вами количество мест меньше текущего количества пользователей в учётной записи. Сообщите клиенту, что ему необходимо удалить пользователя, прежде чем он сможет уменьшить количество мест.
  • Вы увеличили неверное значение параметра «Seats». Для плана 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 , это означает, что вы не можете перепродать выбранный товар или клиенту из развивающегося рынка. Чтобы решить эту проблему, примите соответствующие условия обслуживания.

429:usageLimits.quotaExceeded

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

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