Устранение неполадок 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. Чтобы решить эту проблему, внедрите задержку отсрочки. Дополнительные сведения см. в разделе Ограничения и квоты использования .

Если вы пытаетесь получить множество подписок, рассмотрите возможность использования метода 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 , чтобы продолжить получение всех подписок под учетной записью реселлера.