Como a API REST do Google Meet é um serviço compartilhado, aplicamos cotas e limitações para garantir que ela seja usada de maneira justa por todos os usuários e proteger o desempenho geral do sistema do Google Workspace.
Se você exceder uma cota, normalmente receberá uma resposta de código de status HTTP 429: Too many requests
. Se isso acontecer, use um algoritmo de espera
exponencial e tente novamente mais tarde. Desde que você não ultrapasse as cotas por minuto, não há limite para o número de solicitações que podem ser feitas por dia.
A tabela a seguir mostra os limites das consultas:
Cotas | |||||
---|---|---|---|---|---|
Solicitações de leitura |
|
||||
Solicitações de gravação |
|
||||
Solicitações de gravação reduzidas
Usado para solicitações |
|
Resolver erros de cota baseada em tempo
Para todos os erros baseados em tempo (máximo de N solicitações por X minutos), recomendamos que o código detecte a exceção e use uma espera exponencial truncada para garantir que os 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 tiverem sido bem-sucedidas, é importante aumentar o atraso entre elas até que elas sejam bem-sucedidas.
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_milliseconds
e tente novamente. - Se a solicitação falhar, aguarde 2 +
random_number_milliseconds
e tente novamente. - Se a solicitação falhar, aguarde 4 +
random_number_milliseconds
e tente novamente. - E assim por diante, até um tempo
maximum_backoff
. - Continue aguardando e tentando até um número máximo de novas tentativas, mas não aumente o período de espera entre elas.
onde:
- O tempo de espera é
min(((2^n)+random_number_milliseconds), maximum_backoff)
, comn
incrementado em 1 para cada iteração (solicitação). random_number_milliseconds
é um número aleatório de milissegundos inferior 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 de uma só vez, enviando solicitações em ondas sincronizadas. O valor derandom_number_milliseconds
é recalculado após cada nova solicitação de nova tentativa.maximum_backoff
costuma ser 32 ou 64 segundos. O valor apropriado 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 de 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 indefinidamente.
O tempo de espera entre novas tentativas e o número de novas tentativas depende do caso de uso e das condições da rede.
Preços
É possível usar a API Google Meet sem custo adicional. Exceder os limites de solicitação 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 aumento de cota. As chamadas de API por uma conta de serviço são consideradas como usando uma única conta. A solicitação para aumentar a cota não garante a aprovação. Grandes aumentos de cota podem levar mais tempo para serem aprovados.
Nem todos os projetos têm as mesmas cotas. Conforme você usa cada vez mais o Google Cloud ao longo do tempo, suas cotas podem precisar aumentar. Caso espere um aumento de uso significativo, solicite um ajuste de cotas na página "Cotas" no console do Google Cloud.
Para saber mais, consulte os recursos a seguir:
- Sobre solicitações de aumento de cota
- Ver o uso e os limites atuais da sua cota
- Solicitar um limite de cota maior