Práticas recomendadas de bibliotecas de clientes

Veja a seguir as práticas recomendadas para ajudar você a alcançar o melhor desempenho e a melhor experiência possível ao usar as Bibliotecas de cliente do Cloud e as bibliotecas de cliente das APIs do Google.

Reutilizar objetos e sessões do cliente

Ao fazer pedidos com a mesma biblioteca, reutilize o mesmo objeto de cliente para muitos pedidos, quando possível, em vez de criar um novo para cada pedido. Solicitações da mesma instância compartilharão instâncias de credenciais de autenticação.

A solicitação inicial feita por uma instância de um cliente de sessão executa autenticação, autorização e geração de token de acesso. Esse processamento pode levar vários segundos, como acontece na rede. Para chamadas adicionais na mesma instância do cliente, o cliente da sessão reutiliza o mesmo token de acesso enquanto for válido (normalmente uma hora). Depois que ele expirar, o cliente da sessão atualizará o token de acesso automaticamente. Para um desempenho ideal, reutilize a mesma instância do cliente da sessão para todas as solicitações feitas pelo seu aplicativo e permita que o cliente atualize o token de acesso conforme necessário. para todas as solicitações que precisam ser executadas no mesmo conjunto de credenciais.

Além disso, algumas estratégias de autenticação usadas pelas bibliotecas clientes têm limites de taxa associados a elas. Como cada instância do cliente possui seu próprio cache de credenciais, a criação de muitas em um pequeno período de tempo pode resultar em um limite de taxa, causando uma falha na autenticação das solicitações da biblioteca.

Fixar dependências para produção

Ao instalar as bibliotecas a partir de um gerenciador de pacotes, como npm ou pip, é importante fixar as versões usando seu controle de versão interno para uso de produção. Isso garante que os builds usem consistentemente as mesmas versões dessas bibliotecas. Isso é especialmente importante se você escolher usar clientes beta que podem sofrer alterações na superfície da API. A documentação da biblioteca relevante observa isso na documentação do pacote da biblioteca.

Mantenha-se atualizado

À medida que os recursos e as APIs do Google Cloud mudam, o mesmo ocorre com as bibliotecas de clientes. As bibliotecas de cliente mudam frequentemente, com muitas delas vendo atualizações e lançamentos diários. Para obter a melhor experiência de suporte possível, mantenha-se atualizado com os lançamentos. Muitas das bibliotecas oferecem suporte a versões semânticas para facilitar a determinação do trabalho que uma atualização terá. Se você estiver tendo um desempenho degradado (ou um problema) e estiver usando uma versão mais antiga de uma biblioteca de cliente, considere atualizá-la para aproveitar todas as melhorias nas versões mais recentes.