Práticas recomendadas de bibliotecas de clientes

A seguir, são apresentadas práticas recomendadas para ajudar você a obter o melhor desempenho e a melhor experiência possível ao usar as bibliotecas de cliente do Cloud e as bibliotecas de cliente Google API.

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 para 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 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.