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

На этой странице описаны некоторые распространенные проблемы, с которыми вы можете столкнуться при использовании Directory 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 .