Resolver problemas da API para revendedores

Esta página descreve alguns problemas comuns que você pode encontrar envolvendo a API Reseller.

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ê estiver usando o método customers.insert, um dos parâmetros do objeto do cliente abaixo será inválido:

  • postalAddress.postalCode inválido.
  • postalAddress.countryCode não está 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 necessários estão presentes e são válidos para o cliente.

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

  • Não é possível reduzir as licenças para tipos de plano anual. Considere mudar as configurações de renovação. para que a assinatura defina automaticamente (no momento da renovação) assentos iguais ao número de usuários ativos na conta.
  • O número de licenças solicitado é menor do que o número de usuários atuais na conta. Envie uma mensagem ao cliente informando que ele precisa remover um usuário antes de diminuir a quantidade de assentos.
  • Você aumentou o parâmetro de assento incorreto. Para o plano FLEX, aumente o parâmetro maximumNumberOfSeats e, para o plano ANNUAL, aumente o parâmetro numberOfSeats.
  • Você tentou mudar o parâmetro licensedNumberOfSeats, que é somente leitura.
  • Durante o período de teste, os clientes têm um limite máximo de 10 assentos. Iniciar um serviço pago a partir de uma assinatura de teste sem custo financeiro para encerrar imediatamente o período de teste, iniciar o faturamento e remover o limite máximo de 10 lugares.

403:forbidden

Esse erro ocorre quando você não é o proprietário do cliente ou quando ele desativou o acesso de 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 recuo. Para mais informações, consulte Limites de uso e cotas.

Se você estiver tentando recuperar muitas assinaturas, use o método subscriptions.list sem especificar os parâmetros customerId ou subscriptionId. Você pode retornar no máximo 100 assinaturas por 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 esse problema, acesse o console do Google Cloud e ative a API. Para mais informações, consulte Ativar as APIs do Google Workspace.

404:notFound

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

412:conditionNotMet

Esse erro é causado por vários problemas diferentes.

Se você encontrar esse erro ao usar o método subscriptions.changeRenewalSettings, verifique se 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, isso significa que não há um usuário administrador na conta do Google Workspace. Para resolver esse problema, adicione um usuário administrador temporário e tente novamente.

Se você encontrar esse erro ao usar o método subscriptions.insert, significa que não é possível revender o SKU selecionado ou ao cliente do mercado emergente. 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 nova tentativa de espera ou armazene em cache os resultados para fazer menos chamadas de API. Para mais informações, consulte Limites de uso e cotas.

Se você estiver tentando recuperar muitas assinaturas, use o método subscriptions.list sem especificar os parâmetros customerId ou subscriptionId. Você pode retornar no máximo 100 assinaturas por chamada. Use o parâmetro pageToken para continuar recuperando todas as assinaturas em uma conta de revendedor.