Como a API REST do Google Meet é um serviço compartilhado, aplicamos cotas e limitações para garantir que ela seja usada de forma justa por todos os usuários e para proteger o desempenho geral do sistema do Google Workspace.
Se você exceder uma cota, geralmente vai receber uma resposta com o código de status HTTP 429: Too many requests. Se isso acontecer, use um algoritmo de espera exponencial e tente de novo mais tarde. Desde que você fique dentro das cotas por minuto, não há limite para o número de solicitações que podem ser feitas por dia.
A tabela a seguir detalha os limites de consulta:
| Cotas | |||||
|---|---|---|---|---|---|
| Solicitações de leitura |
|
||||
| Solicitações de gravação |
|
||||
|
Solicitações de gravação reduzidas
(Usado para solicitações |
|
||||
Resolver erros de cota com base no tempo
Para todos os erros baseados em tempo (máximo de N solicitações por X minutos), recomendamos que seu código capture a exceção e use um backoff exponencial truncado para garantir que seus dispositivos não gerem carga excessiva.
A espera exponencial é uma estratégia padrão de tratamento de erros para aplicativos de rede. Um algoritmo de espera exponencial repete solicitações usando tempos de espera exponencialmente crescentes entre as solicitações, até um tempo máximo de espera. Se as solicitações ainda não forem bem-sucedidas, é importante que os atrasos entre elas aumentem com o tempo até que a solicitação seja bem-sucedida.
Exemplo de algoritmo
Um algoritmo de espera exponencial repete solicitações exponencialmente, aumentando o tempo de espera entre novas tentativas até um tempo máximo de espera. Exemplo:
- Faça uma solicitação para a API Google Meet.
- Se a solicitação falhar, aguarde 1 +
random_number_millisecondse tente de novo. - Se a solicitação falhar, aguarde 2 +
random_number_millisecondssegundos e tente de novo. - Se a solicitação falhar, aguarde 4 +
random_number_millisecondssegundos e tente de novo. - E assim por diante, até um tempo
maximum_backoff. - Continue aguardando e tentando novamente até um número máximo de novas tentativas, sem aumentar o tempo de espera entre elas.
em que:
- O tempo de espera é
min(((2^n)+random_number_milliseconds), maximum_backoff), comnincrementado em 1 para cada iteração (solicitação). random_number_millisecondsé um número aleatório de milissegundos menor ou igual a 1.000. Isso ajuda a evitar casos em que muitos clientes são sincronizados por alguma situação e todos tentam novamente ao mesmo tempo, enviando solicitações em ondas sincronizadas. O valor derandom_number_millisecondsé recalculado após cada nova tentativa de solicitação.maximum_backoffcostuma ser 32 ou 64 segundos. O valor adequado depende do caso de uso.
O cliente pode continuar tentando novamente depois de maximum_backoff.
As novas tentativas após esse ponto não precisam continuar aumentando o tempo de espera. Por
exemplo, se um cliente usar um tempo maximum_backoff de 64 segundos, depois de atingir
esse valor, ele poderá tentar novamente a cada 64 segundos. Em algum momento,
os clientes precisam ser impedidos de tentar novamente infinitas vezes.
O tempo de espera entre novas tentativas e o número de novas tentativas depende do seu caso de uso e das condições da rede.
Preços
Todo uso da API Google Meet está disponível sem custo adicional. Exceder os limites de solicitações de cota não gera cobranças extras, e sua conta não é faturada.
Solicitar aumento de cota
Dependendo do uso de recursos do seu projeto, talvez seja necessário solicitar um ajuste de cota. As chamadas de API feitas por uma conta de serviço são consideradas como se usassem uma única conta. Solicitar uma cota ajustada não garante a aprovação. As solicitações de ajuste de cota que aumentam significativamente o valor da cota podem levar mais tempo para serem aprovadas.
Nem todos os projetos têm as mesmas cotas. À medida que você usa mais o Google Cloud, os valores de cota podem precisar aumentar. Caso espere um aumento de uso significativo, solicite o ajuste das cotas na página "Cotas" do console do Google Cloud.
Para saber mais, consulte os seguintes recursos:
- Sobre os ajustes de cota
- Conferir o uso e os limites atuais da cota
- Solicitar um limite de cota maior