Limites e cotas protegem a infraestrutura do Google de um processo automatizado que usa a API Revendedor de maneira inadequada. Solicitações excessivas de uma API podem ser o resultado de um erro de digitação inofensivo ou podem resultar de um sistema projetado de maneira ineficiente que faz chamadas de API desnecessárias. Seja qual for a causa, bloquear o tráfego de uma origem específica quando ele atingir determinado nível é necessário para a integridade geral do sistema do Google Workspace. Ele garante que as ações de um desenvolvedor não afetem negativamente a comunidade em geral.
Falhas na solicitação de API
No caso improvável de falha da solicitação de API, o aplicativo recebe 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 da API foram excedidas. Essas
respostas permitem que o 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 para N segundos por
linha de execução), especialmente os erros de código de status 503, recomendamos que
seu código capture a exceção e, usando
um algoritmo de
espera exponencial,
aguarde um pequeno atraso antes de tentar a chamada com falha. Um
exemplo da API revendedor para uma linha de execução
é esperar cinco segundos e repetir 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, seu aplicativo precisará 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 repita a chamada com falha. Decida também um limite de tentativas.
Por exemplo, repita uma solicitação de cinco a sete vezes com tempos de atraso diferentes antes
que o aplicativo retorne um erro ao usuário.
Limites
| Categorias de limite da 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 ser gerado. |
| Número máximo de usuários por cliente | Dependendo do seu contrato, o número máximo de usuários pode ser 50.000 ou o máximo definido no seu contrato de revendedor. |
| Solicitações não autorizadas | O Google não permite solicitações não autorizadas à API para revendedores. Uma solicitação é considerada não autorizada se nenhum token de autorização é fornecido. Para mais informações, acesse 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 está no JSON JavaScript Object Notation.
JSON é um formato comum da Internet que fornece um método para representar estruturas de dados arbitrárias. JSON é um formato de texto completamente independente de linguagem, mas que usa convenções já conhecidas pelos programadores da família C, incluindo C, C++, C#, Java, JavaScript, Perl e Python. |
| Formato de hora | Todos os horários estão no conversor de época em milissegundos. Esse formato se aplica aos valores do horário de criação da assinatura, aos horários de início e término do compromisso de um plano e ao horário de término do teste sem custo financeiro de 30 dias. |