Os limites e as cotas protegem a infraestrutura do Google contra um processo automatizado que usa a API Reseller de maneira inadequada. O excesso de solicitações de uma API pode ser resultado de um erro de digitação inofensivo ou de um sistema projetado de forma ineficiente que faz chamadas desnecessárias para a API. Seja qual for a causa, bloquear o tráfego de uma fonte específica quando ele atinge um limite é necessário para a integridade geral do sistema do Google Workspace. Elas garantem que as ações de um desenvolvedor não afetem negativamente a comunidade de modo mais amplo.
Falhas de solicitação de API
No caso improvável de falha da sua solicitação de API, o aplicativo vai receber uma
resposta de código de status HTTP. Um código de status 403 tem informações de erro sobre entradas incorretas, e um código de status HTTP 503 tem informações de erro indicando quais cotas de API foram excedidas. Essas
respostas permitem que seu aplicativo personalizado detecte esses erros e tome as medidas
adequadas.
Erros baseados em tempo
Para todos os erros baseados em tempo (máximo de N coisas por N segundos por
thread), especialmente os erros de código de status 503, recomendamos que
seu código capture a exceção e, usando um algoritmo de
backoff exponencial,
aguarde um pequeno atraso antes de tentar novamente a chamada com falha. Um
exemplo da API Reseller para uma linha de execução
é aguardar 5 segundos e tentar novamente a chamada com falha. Se a solicitação for bem-sucedida, repita esse padrão para as outras linhas de execução. Se a segunda solicitação não for
bem-sucedida, o aplicativo vai reduzir a frequência da solicitação
até que uma chamada seja bem-sucedida. Por exemplo, aumente o atraso inicial de 5 segundos para 10 segundos e tente fazer a chamada novamente. Além disso, decida um limite de novas tentativas.
Por exemplo, tente fazer uma solicitação de 5 a 7 vezes com tempos de atraso diferentes antes de
o aplicativo retornar um erro ao usuário.
Limites
| Categorias de limites de API | Limites |
|---|---|
Assinatura purchaseOrderId |
Essa propriedade aceita até 80 caracteres de texto simples. |
Assinatura maxResults |
A string de consulta maxResults pode ter de 1 a 100 resultados.
O padrão é 20 resultados.
|
Token de transferência (customerAuthToken) |
O token de transferência de um cliente é válido por 30 dias após a geração. |
| Número máximo de usuários para um cliente | Dependendo do seu contrato, o número máximo de usuários pode ser 50.000 ou o máximo definido no contrato de revenda. |
| Solicitações não autorizadas | O Google não permite solicitações não autorizadas para a API Reseller. Uma solicitação é considerada não autorizada se nenhum token de autorização for fornecido. Para mais informações, consulte Saiba mais sobre autenticação e autorização. |
Outros tipos de limites
| Outros tipos de limites | Limitações e diretrizes |
|---|---|
| Formato de dados |
O formato dos dados é JavaScript Object Notation
JSON.
O JSON é um formato comum da Internet que oferece um método de representação de estruturas de dados arbitrárias. JSON é um formato de texto totalmente independente de linguagem, mas usa convenções conhecidas por programadores da família de linguagens C, incluindo C, C++, C#, Java, JavaScript, Perl e Python. |
| Formato de hora | Todos os carimbos de data/hora estão no conversor de época em milissegundos. Esse formato se aplica aos valores do horário de criação da assinatura, dos horários de início e término do período de fidelidade de um plano e do horário de término de um teste sem custo financeiro de 30 dias. |