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

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

400:badRequest

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

При использовании метода users.get убедитесь, что значение, переданное в параметр userKey , является либо основным адресом электронной почты пользователя, либо псевдонимом адреса электронной почты, либо уникальным идентификатором пользователя.

При использовании метода users.list проверьте следующие параметры:

  • Параметр customer : используйте только customerId , сгенерированный Google. Не используйте фактический домен клиента. Мы рекомендуем использовать этот параметр, поскольку, если у клиента есть дополнительные домены, использование параметра domain возвращает только пользователей с адресами электронной почты в этом конкретном домене.
  • Параметр domain : используйте только домен клиента. Не используйте
    customerId , сгенерированный Google.

403:domainCannotUseApis

Эта ошибка возникает, когда ваш клиент отключил доступ реселлера к API Admin SDK. Чтобы решить эту проблему, попросите клиента повторно включить доступ к API Admin SDK. Подробнее см. в разделе Управление доступом к API .

Если вы пытаетесь получить количество текущих лицензированных пользователей и получаете эту ошибку, вместо вызова метода users.list используйте поле licensedNumberOfSeats из ресурса подписки.

403:forbidden

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

Чтобы решить эту проблему, либо вызовите метод customers.get перед выполнением вызовов для подтверждения права собственности на клиента, либо попросите клиента повторно включить доступ реселлера к его консоли администратора. Подробнее см. в разделе Доступ к консоли администратора клиента .

403:usageLimits.accessNotConfigured

Эта ошибка возникает, когда API не включён в проекте Google Cloud. Чтобы решить эту проблему, перейдите в консоль Google Cloud и включите API. Подробнее см. в статье Включение API Google Workspace .

409:duplicate

Эта ошибка возникает, когда вы пытаетесь добавить нового пользователя, но основной адрес электронной почты клиента уже существует в одной из следующих групп:

  • Текущая учетная запись Google Workspace, в которую вы пытаетесь их добавить.
  • Еще один продукт Google (не Google Workspace).

Чтобы решить эту проблему, выполните следующие действия:

  1. Вызовите метод users.get .

    Если вы получили ответ 200 , это значит, что пользователь уже существует в аккаунте Google Workspace клиента. Вы не можете добавить этого пользователя в аккаунт.

    Если вы получили ответ 403 forbidden , то либо домен в параметре основного адреса электронной почты не принадлежит клиенту, перепроданному повторно, либо основной адрес электронной почты ранее использовался для другого продукта Google, и перед успешным добавлением этого пользователя необходимо сначала подтвердить домен клиента.

  2. Если вы можете проверить домен клиента, сделайте следующее:

    1. Создайте временного пользователя-администратора с помощью метода users.insert и продолжите подготовку к последнему этапу проверки домена.
    2. При проверке домена добавьте временных пользователей в параметр owners[] тела запроса для вызова webResource.insert . Выполняйте этот вызов, пока не получите ответ 200 .
    3. После проверки домена переименуйте временное имя пользователя, используя метод users.patch или users.update .

  3. Если вы не можете проверить домен клиента, сделайте следующее:

    1. Создайте временного пользователя-администратора с помощью метода users.insert .
    2. Попросите вашего клиента войти в систему как временный пользователь и подтвердить свой домен через консоль администратора.
    3. После подтверждения домена клиент или вы можете переименовать временное имя пользователя. Для этого можно использовать методы users.patch или users.update .

412:limitExceeded

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

  • Для FLEXIBLE увеличьте параметр maximumNumberOfSeats .
  • Для ANNUAL увеличьте параметр numberOfSeats .