Resolver problemas da API Directory

Esta página descreve alguns problemas comuns que você pode encontrar ao usar a API Directory como revendedor.

400:badRequest

Esse erro ocorre quando um valor de parâmetro incorreto é transmitido para o 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 de usuário exclusivo.

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

  • Parâmetro customer: use apenas o customerId 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 domain parâmetro só vai retornar 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 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 ao cliente para reativar o acesso à API Admin SDK. Para mais informações, consulte Controlar o acesso à API.

Se você estiver tentando receber a contagem de usuários licenciados atuais 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 quando o cliente desativou o acesso do revendedor ao Admin Console.

Para resolver esse problema, chame o customers.get método antes de fazer chamadas para verificar a propriedade do revendedor do cliente ou peça ao cliente para reativar o acesso do revendedor ao Admin Console. Para mais informações, consulte Acessar o Admin Console de um cliente.

403:usageLimits.accessNotConfigured

Esse erro ocorre quando a API não está ativada no projeto na nuvem do Google. Para resolver esse problema, acesse o console do Google Cloud e ative a API. Para mais informações, consulte Ativar as APIs do Google Workspace.

409:duplicate

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

  • Conta do Google Workspace atual em que você está tentando adicionar o usuário.
  • Outro produto do Google (que não seja 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 Google Workspace do cliente Google Workspace. Não é possível adicionar esse usuário à conta.

    Se você receber uma resposta 403 forbidden, o domínio no parâmetro de e-mail principal não é um cliente revendido ou o e-mail principal já foi usado para um produto diferente do Google, e o domínio do cliente precisa ser verificado antes que esse usuário possa ser adicionado.

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

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

  3. Se você não puder verificar o domínio do cliente, faça o seguinte:

    1. Crie um usuário administrador temporário usando o users.insert método.
    2. Peça ao cliente para fazer login como usuário temporário e verificar o domínio pelo Admin Console.
    3. Depois que o domínio for verificado, o cliente ou você poderá renomear o nome de usuário temporário. Você pode usar os métodos users.patch ou os users.update métodos.

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âmetro maximumNumberOfSeats.
  • Para ANNUAL, aumente o parâmetro numberOfSeats.