Nesta página, descrevemos algumas práticas recomendadas ao usar as bibliotecas de cliente do Cloud e as bibliotecas de cliente de APIs do Google, que ajudam a otimizar o desempenho e manter builds de produção confiáveis.
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 de expirado, o cliente da sessão atualiza o token de acesso automaticamente. Para um desempenho ideal, reutilize a mesma instância do cliente de sessão em todas as solicitações feitas pelo aplicativo e permita que o cliente atualize o token de acesso conforme necessário para todas as solicitações que precisarem ser executadas sob o mesmo conjunto de credenciais.
Além disso, algumas estratégias de autenticação usadas pelas bibliotecas de cliente têm limites de taxa associados a elas. Como cada instância do cliente tem seu próprio cache de credenciais, criar muitas em um curto período pode causar limitação de taxa, fazendo com que as solicitações da biblioteca falhem na autenticação.
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.
Fique por dentro
À medida que os recursos e as APIs do Google Cloudmudam, as bibliotecas de cliente também mudam. 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.