Nesta página, descrevemos alguns problemas comuns que você pode encontrar envolvendo a API Directory como revendedor.
400:badRequest
Esse erro ocorre quando um valor de parâmetro incorreto é transmitido ao método.
Se você estiver usando o método users.get
, verifique se o valor transmitido para o parâmetro userKey
é o endereço de e-mail principal, o endereço de e-mail do alias ou
o ID do usuário exclusivo do usuário.
Se estiver usando o método users.list
, verifique os seguintes parâmetros:
- Parâmetro
customer
: use apenas ocustomerId
que foi gerado pelo Google. Não use o domínio real do cliente. Recomendamos o uso desse parâmetro porque, se um cliente tiver domínios secundários, o uso do parâmetrodomain
retornará apenas usuários com endereços de e-mail nesse domínio específico. - Parâmetro
domain
: use apenas o domínio real do cliente. Não use o
customerId
que foi gerado pelo Google.
403:domainCannotUseApis
Esse erro ocorre quando o cliente desativou o acesso de revendedor à API Admin SDK. Para resolver esse problema, peça para o cliente reativar o acesso à API Admin SDK. Para mais informações, consulte Controlar o acesso à API.
Se você estiver tentando ver a contagem de usuários licenciados e receber esse
erro, em vez de chamar o método users.list
, use o campo licensedNumberOfSeats
do recurso de assinatura.
403:forbidden
Esse erro ocorre quando você não é o proprietário do cliente ou seu cliente desativou o acesso do revendedor ao Admin Console.
Para resolver esse problema, chame o
método customers.get
antes de fazer chamadas para verificar a propriedade do revendedor do cliente ou peça para o
cliente reativar o acesso do revendedor ao Admin Console. Saiba mais em Acessar o Admin Console de um cliente.
403:usageLimits.accessNotConfigured
Esse erro ocorre quando a API não está ativada no projeto do Google Cloud. Para resolver esse problema, acesse o console do Google Cloud e ative a API. Para mais informações, consulte Ativar APIs do Google Workspace.
409:duplicate
Esse erro ocorre quando você está tentando adicionar um novo usuário, mas o e-mail principal do cliente já existe em uma das seguintes opções:
- Conta atual do Google Workspace a que você está tentando adicionar.
- Outro produto do Google (não o Google Workspace).
Para resolver esse problema, faça o seguinte:
Chame o método
users.get
Se você receber uma resposta
200
, significa que o usuário já existe na conta do Google Workspace do cliente. Não é possível adicionar este usuário à conta.Se você receber uma resposta
403 forbidden
, significa que o domínio no parâmetro de e-mail principal não é um cliente de revenda ou o e-mail principal foi usado anteriormente para outro produto do Google, e o domínio do cliente precisa ser verificado antes de adicionar o usuário.Se você conseguir verificar o domínio do cliente, faça o seguinte:
- Crie um usuário administrador temporário usando o
método
users.insert
e continue o provisionamento para a etapa final de verificação de domínio. - Ao verificar o domínio, adicione os usuários temporários ao parâmetro
owners[]
do corpo da solicitação para a chamadawebResource.insert
. Faça esta chamada até receber uma resposta200
. - Depois que o domínio for verificado, renomeie o nome de usuário temporário usando os métodos
users.patch
ouusers.update
.
- Crie um usuário administrador temporário usando o
método
Se não for possível verificar o domínio do cliente, faça o seguinte:
- Crie um usuário administrador temporário usando o
método
users.insert
. - Peça para seu cliente fazer login como usuário temporário e verificar o domínio dele no Admin Console.
- Depois que o domínio for verificado, o cliente ou você pode renomear o
nome de usuário temporário. Você pode usar os métodos
users.patch
ouusers.update
.
- Crie um usuário administrador temporário usando o
método
412:limitExceeded
Esse erro ocorre quando o cliente atinge o limite máximo de licenças. Para
resolver esse problema, use o método subscriptions.changeSeats
e, dependendo do plano de assinatura, use o seguinte:
- Para
FLEXIBLE
, aumente o parâmetromaximumNumberOfSeats
. - Para
ANNUAL
, aumente o parâmetronumberOfSeats
.