Resolver problemas da API para revendedores

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

400:badRequest

Esse erro ocorre quando a assinatura é suspensa ou cancelada. Para mais informações, consulte Ativar uma assinatura.

400:invalid

Esse erro pode ocorrer por vários motivos.

Se você usa o método customers.insert, um dos clientes a seguir parâmetros de objeto são inválidos:

  • postalAddress.postalCode inválido.
  • postalAddress.countryCode não qualificado para revender o Google Workspace.
  • alternateEmail não pode estar no mesmo domínio que customerDomain

Para resolver esse problema, verifique se os parâmetros obrigatórios estão presentes e são válidos para com o cliente.

Se você estiver usando o método subscriptions.changeSeats, um dos seguintes problemas podem ter causado esse erro:

  • Não é possível reduzir o número de licenças dos tipos de plano anual. Considere alterar as configurações de renovação. para que a inscrição defina automaticamente (no momento da renovação) licenças iguais e a quantidade de usuários ativos na conta.
  • O número de licenças que você solicitou é menor do que o número de usuários atuais no do Compute Engine. Enviar uma mensagem ao cliente para informar que é preciso remover um usuário diminuir o número de licenças.
  • Você aumentou o parâmetro seat incorreto. No plano FLEX, aumente o parâmetro maximumNumberOfSeats e, para o plano ANNUAL, aumente o numberOfSeats.
  • Você tentou alterar o parâmetro licensedNumberOfSeats, que é uma parâmetro somente leitura.
  • Durante o período de teste, os clientes têm um limite máximo de 10 licenças por usuário. Iniciar um serviço pago em uma assinatura de teste sem custo financeiro para encerrar imediatamente o período de teste, iniciar o faturamento e remover a licença de 10 licenças ao limite máximo.

403:forbidden

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

403:usageLimits.dailyLimitExceeded

Esse erro ocorre quando você atinge a cota diária de chamadas para essa API. Para resolver esse problema, implemente um atraso de espera. Para mais informações, consulte Cotas e limites de uso.

Se você estiver tentando recuperar muitas assinaturas, considere usar o subscriptions.list sem especificar o customerId ou Parâmetros subscriptionId. É possível retornar no máximo cem assinaturas por a chamada. Use o parâmetro pageToken para continuar recuperando todas as assinaturas. em uma conta de revendedor.

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.

404:notFound

Ao usar o método customers.get, esse erro significa que o cliente ou domínio não existe para nenhuma conta do Google Workspace e que o está disponível.

412:conditionNotMet

Esse erro é causado por vários problemas diferentes.

Se você encontrar esse erro ao usar o subscriptions.changeRenewalSettings verifique se você está chamando esse método apenas nos seguintes Planos de pagamento de compromisso:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Se você encontrar esse erro ao usar o método subscriptions.delete, ele significa que não há um usuário administrador presente do Compute Engine. Para resolver esse problema, adicione um usuário administrador temporário e tente de novo.

Se você encontrar esse erro ao usar o método subscriptions.insert, ele significa que não é possível revender a SKU selecionada ou para os mercados emergentes para o cliente. Para resolver esse problema, aceite os Termos de Serviço aplicáveis.

429:usageLimits.quotaExceeded

Esse erro ocorre quando você ultrapassa o limite de consultas por segundo. Para resolver esse problema, implemente uma estratégia de espera de nova tentativa ou armazene os resultados em cache para menos chamadas de API. Para mais informações, consulte Cotas e limites de uso.

Se você estiver tentando recuperar muitas assinaturas, considere usar o subscriptions.list sem especificar o customerId ou Parâmetros subscriptionId. É possível retornar no máximo cem assinaturas por a chamada. Use o parâmetro pageToken para continuar recuperando todas as assinaturas. em uma conta de revendedor.