Os limites e as cotas protegem a infraestrutura do Google contra um processo automatizado que usa a API Reseller de maneira inadequada. Solicitações excessivas de uma API podem resultar de um simples erro de digitação ou de um sistema projetado de forma ineficiente que faz chamadas desnecessárias de API. Seja qual for a causa, bloquear o tráfego de uma fonte específica quando ele atinge um determinado nível é necessário para garantir a integridade geral do sistema do Google Workspace. Isso garante 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 solicitação da API, o aplicativo recebe uma
resposta de código de status HTTP. Um código de status 403 tem informações de erro
sobre entrada incorreta, e um código de status HTTP 503
tem informações de erro indicando quais cotas da 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
linha de execução), especialmente os erros de código de status 503, recomendamos que
o código detecte a exceção e, usando um
algoritmo
de desistência 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 cinco 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
concluída, o 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 tente novamente a chamada com falha. Além disso, defina um limite de novas tentativas.
Por exemplo, tente novamente uma solicitação de 5 a 7 vezes com diferentes tempos de atraso antes
de retornar 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 a geração. |
| Número máximo de usuários de 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 é 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 está na notação JavaScript Object Notation
JSON.
JSON é um formato comum da Internet que fornece um método de representação de estruturas de dados arbitrárias. O JSON é um formato de texto completamente independente da linguagem, mas usa convenções familiares para programadores de linguagens da família C, incluindo C, C++, C#, Java, JavaScript, Perl e Python. |
| Formato de hora | Todas as datas e horas estão no conversor de época em milissegundos. Esse formato se aplica aos valores do horário de criação da assinatura, do início e do término do compromisso de um plano e do término do período de teste sem custo financeiro de 30 dias. |