Resolver problemas da API Directory

Esta página descreve alguns problemas comuns que você pode encontrar envolvendo o Directory API como revendedor.

400:badRequest

Esse erro ocorre quando um valor de parâmetro incorreto é transmitido para o método.

Se estiver usando o método users.get, verifique se o valor transmitido ao userKey é o endereço de e-mail principal do usuário, o endereço de e-mail do alias ou um ID de usuário exclusivo.

Se estiver usando o método users.list, verifique os seguintes parâmetros:

• Parâmetro customer: use apenas o customerId que foi gerado pelo Google. Não use o domínio do cliente. Recomendamos o uso deste porque, se um cliente tiver domínios secundários, usar o domain retorna apenas os 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 a permissão de
  customerId que foi gerado pelo Google.

403:domainCannotUseApis

Esse erro ocorre quando o cliente desativa o acesso do revendedor à API Admin SDK. Para resolver esse problema, peça para seu cliente reativar o acesso ao a API Admin SDK. Para mais informações, consulte Controle o acesso à API.

Se você estiver tentando ver a contagem de usuários licenciados atuais e receber esta mensagem: em vez de chamar o método users.list, use o campo licensedNumberOfSeats no recurso de assinatura.

403:forbidden

Esse erro ocorre quando o cliente não é seu ou ele desativou o recurso o acesso do revendedor ao Admin Console.

Para resolver esse problema, chame o método Método customers.get antes de fazer chamadas para confirmar a propriedade do revendedor do cliente ou pergunte ao seu reativar o acesso do revendedor ao Admin Console. Para mais informações, consulte Acesse 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 problema, acesse o console do Google Cloud e ative a API. Para mais informações, consulte Ative as APIs do Google Workspace.

409:duplicate

Esse erro ocorre quando você tenta adicionar um novo usuário, mas a o e-mail principal já existe em um dos seguintes:

• Conta atual do Google Workspace a que você está tentando adicionar o usuário.
• Outro produto do Google (não o Google Workspace).

Para resolver esse problema, faça o seguinte:

1. Chame o método users.get.

   Se você receber uma resposta 200, o usuário já existe na conta do Conta do Google Workspace. Não é possível adicionar este usuário à conta.

   Se você receber uma resposta 403 forbidden, significa que o domínio na instância principal O parâmetro de e-mail 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 deve ser verificado antes que este usuário possa ser adicionado.

2. Se você conseguir verificar o domínio do cliente, faça o seguinte:

   1. Crie um usuário administrador temporário usando o Método users.insert e continue o provisionamento até a etapa final de verificação do domínio.
   2. Ao verificar o domínio, adicione os usuários temporários ao owners[] do corpo da solicitação da webResource.insert. Faça esta chamada até receber uma resposta de 200.
   3. Após a verificação do domínio, renomeie o nome de usuário temporário usando o users.patch ou o users.update métodos.

3. Se não for possível verificar o domínio do cliente, faça o seguinte:

   1. Crie um usuário administrador temporário usando o método users.insert.
   2. Peça para seu cliente fazer login como usuário temporário e verificar no Admin Console.
   3. Após a verificação do domínio, o cliente ou você pode renomear nome de usuário temporário. Você pode usar o método users.patch ou o users.update métodos.

412:limitExceeded

Esse erro ocorre quando seu cliente atinge o limite máximo de licenças por usuário. Para resolver o problema, use o método subscriptions.changeSeats. e, dependendo do plano de assinatura, use o seguinte:

• Para FLEXIBLE, aumente o parâmetro maximumNumberOfSeats.
• Para ANNUAL, aumente o parâmetro numberOfSeats.