As bibliotecas de cliente facilitam o acesso a Google Cloud APIs usando uma linguagem compatível. É possível usar as Google Cloud APIs diretamente fazendo solicitações brutas ao servidor, mas as bibliotecas de cliente oferecem simplificações que reduzem significativamente a quantidade de código que você precisa escrever. Isso é especialmente verdadeiro para a autenticação, porque as bibliotecas de cliente oferecem suporte a Application Default Credentials (ADC).
Se você aceitar configurações de credenciais (JSON, arquivos ou fluxos) de uma fonte externa (por exemplo, um cliente), revise os requisitos de segurança ao usar configurações de credenciais de uma fonte externa.
Usar o Application Default Credentials com as bibliotecas de clientes
Para usar o Application Default Credentials para autenticar um aplicativo, primeiro configure o ADC para o ambiente em que o aplicativo está em execução. Quando você usa a biblioteca de cliente para criar um cliente, essa biblioteca verifica e usa automaticamente as credenciais fornecidas ao ADC para autenticação nas APIs usadas pelo seu código. Seu aplicativo não precisa autenticar ou gerenciar tokens explicitamente. esses requisitos são gerenciados automaticamente pelas bibliotecas de autenticação.
Para um ambiente de desenvolvimento local, é possível configurar o ADC com suas credenciais de usuário ou com identidade temporária de conta de serviço usando a CLI gcloud. Para ambientes de produção, configure o ADC anexando uma conta de serviço.
Exemplo de criação de cliente
As amostras de código a seguir criam um cliente para o serviço do Cloud Storage. É provável que seu código precise de clientes diferentes. Estas amostras servem apenas para mostrar como criar um cliente e usá-lo sem qualquer código para autenticar explicitamente.
Antes de executar os exemplos a seguir, é preciso concluir as etapas a seguir:
Go
Java
Node.js
PHP
Python
Ruby
Usar chaves de API com bibliotecas de cliente
Você só pode usar chaves de API com bibliotecas de cliente para APIs que aceitam chaves de API. Além disso, a chave de API não pode ter uma restrição de API que impeça o uso dela para a API.
Para mais informações sobre chaves de API criadas no modo expresso, consulte as perguntas frequentes sobre o modo expresso do Google Cloud.
Este exemplo usa a API Cloud Natural Language, que aceita chaves de API, para demonstrar como fornecer uma chave de API à biblioteca.
C#
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.
C++
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.
Go
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.
Node.js
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.