Os limites e as cotas protegem a infraestrutura do Google contra processos automatizados que usam a API Reseller de maneira inadequada. O excesso de solicitações pode ser resultado de um erro de digitação ou de um design de sistema ineficiente. Para garantir a integridade do sistema do Google Workspace, o Google bloqueia o tráfego de fontes específicas quando ele atinge determinados níveis. Isso garante que as ações de um desenvolvedor não afetem negativamente a comunidade.
Falhas de solicitação de API
Se uma solicitação de API falhar, seu aplicativo vai receber um código de status HTTP. Um código de status 403 indica entrada incorreta, e um código 503 indica que as cotas da API foram excedidas. Use essas respostas para detectar erros e tomar medidas.
Erros baseados em tempo
Para erros baseados em tempo, especialmente códigos de status 503, use um algoritmo de espera exponencial. Aguarde um pequeno atraso antes de tentar novamente a chamada com falha. Por
exemplo, aguarde 5 segundos e tente novamente. Se for bem-sucedido, repita o padrão para
outras linhas de execução. Se a segunda solicitação falhar, reduza a frequência de
solicitações até que uma chamada seja bem-sucedida. Também é recomendável decidir um limite de novas tentativas, como 5 a 7
vezes.
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 revendedor. |
| Solicitações não autorizadas | O Google não permite solicitações não autorizadas para a API Reseller. Uma solicitação é 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 de dados é JavaScript Object Notation
(JSON).
O JSON é um formato comum da Internet para representar estruturas de dados arbitrárias. É um formato de texto independente de linguagem que usa convenções conhecidas por programadores da família de linguagens C, incluindo C, C++, C#, Java, JavaScript, Perl e Python. |
| Formato de hora | Datas e horas usam o conversor de época em milissegundos. Esse formato se aplica ao horário de criação da assinatura, aos horários de início e término do compromisso do plano e aos horários de término do teste sem custo financeiro. |