Seguem-se as práticas recomendadas para ajudar a conseguir um desempenho ideal e a melhor experiência possível quando usar as bibliotecas cliente da Google Cloud e as bibliotecas cliente das APIs Google.
Reutilize objetos e sessões de clientes
Quando fizer pedidos com a mesma biblioteca, deve reutilizar o mesmo objeto cliente para muitos pedidos, sempre que possível, em vez de criar um novo para cada pedido. Os pedidos da mesma instância partilham instâncias de credenciais de autenticação.
O pedido inicial feito por uma instância de um cliente de sessão executa a autenticação, a autorização e a geração de tokens de acesso. Este processamento pode demorar vários segundos, uma vez que ocorre através da 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). Após a expiração, o cliente da sessão atualiza automaticamente o token de acesso. Para um desempenho ideal, deve reutilizar a mesma instância do cliente da sessão para todos os pedidos feitos pela sua aplicação e permitir que o cliente atualize o token de acesso conforme necessário para todos os pedidos que precisam de ser executados com o mesmo conjunto de credenciais.
Além disso, algumas estratégias de autenticação usadas pelas bibliotecas cliente têm limites de taxa associados. Uma vez que cada instância do cliente tem a sua própria cache de credenciais, a criação de demasiadas instâncias num curto período pode incorrer em limites de taxa, o que faz com que os pedidos da biblioteca falhem a autenticação.
Fixe dependências para produção
Quando instalar as bibliotecas a partir de um gestor de pacotes, como npm ou pip, é importante fixar as versões através da respetiva gestão de versões incorporada para utilização em produção. Isto garante que as compilações usam sempre as mesmas versões destas bibliotecas. Isto é especialmente
importante se optar por usar clientes beta, cuja superfície da API pode mudar. A documentação da biblioteca relevante indica isto na documentação do pacote da biblioteca.
Mantenha-se atualizado(a)
À medida que as capacidades e as APIs do Trusted Cloud by S3NSmudam, o mesmo acontece com as bibliotecas cliente. As bibliotecas de cliente mudam frequentemente, e muitas delas recebem atualizações e lançamentos diários. Para ter a melhor experiência de apoio técnico possível, deve manter-se a par das versões. Muitas das bibliotecas suportam a versão semântica para facilitar a determinação do trabalho necessário para uma atualização. Se estiver a ter um desempenho degradado (ou um problema) e estiver a usar uma versão mais antiga de uma biblioteca cliente, pondere atualizá-la para tirar partido de todas as melhorias nas versões mais recentes.