Explicação das bibliotecas cliente

As bibliotecas cliente facilitam o acesso às Google Cloud APIs a partir de um idioma suportado. Embora possa usar as Google Cloud APIs diretamente fazendo pedidos não processados ao servidor, as bibliotecas cliente oferecem simplificações que reduzem significativamente a quantidade de código que tem de escrever.

Este documento explica os diferentes tipos de bibliotecas cliente que a Google oferece para as APIs Cloud. Também pode saber mais sobre as bibliotecas disponíveis para o produto ou o idioma da sua escolha na documentação do produto ou do idioma.

Bibliotecas cliente do Cloud

As bibliotecas cliente da Cloud são a opção recomendada para aceder às APIs Cloud de forma programática, quando disponíveis. As bibliotecas cliente da nuvem usam o modelo de biblioteca cliente mais recente e:

• Fornecer código idiomático em cada idioma para tornar as APIs Cloud simples e intuitivas de usar.
• Oferecer um estilo consistente nas bibliotecas cliente para simplificar o trabalho com vários serviços na nuvem.
• Processar todos os detalhes de baixo nível da comunicação com o servidor, incluindo a autenticação com a Google.
• Pode ser instalado através de ferramentas de gestão de pacotes familiares, como npm e pip.
• Em alguns casos, oferecem-lhe vantagens de desempenho através da utilização do gRPC. Para mais informações, consulte as APIs gRPC.

Pode encontrar instruções de instalação e material de referência para a biblioteca cliente da nuvem na página Bibliotecas cliente das APIs Cloud que está a usar. Pode encontrar links para começar a usar as bibliotecas de cliente da Google Cloud e a respetiva documentação de referência na página das bibliotecas de cliente da Google Cloud.

Experimente

Se for um novo utilizador do Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em cenários reais. Os novos clientes também recebem 300 USD em créditos gratuitos para executar, testar e implementar cargas de trabalho.

Comece gratuitamente

Bibliotecas cliente de APIs Google

Algumas APIs Google Cloud não têm bibliotecas cliente do Google Cloud disponíveis em todos os idiomas. Se quiser usar uma destas APIs e não existir uma biblioteca cliente da nuvem para a sua linguagem preferida, pode continuar a usar o estilo anterior de biblioteca cliente, denominado bibliotecas cliente de APIs Google. Também pode usar estas bibliotecas se estiver a atualizar um projeto que já as usa. Estas bibliotecas:

• Fornecer acesso apenas à interface REST da API; o gRPC não é suportado.
• Ter código de interface gerado automaticamente que pode não ser tão idiomático como as bibliotecas de cliente da Google Cloud.
• Processar todos os detalhes de baixo nível da comunicação com o servidor, incluindo a autenticação com a Google.
• Pode ser instalado através de ferramentas de gestão de pacotes familiares, como npm e pip.

Estas bibliotecas estão associadas na página de bibliotecas de cliente para as APIs Cloud relevantes.

Usar a plataforma móvel do Firebase

O Firebase é a solução da Google para criar aplicações em dispositivos móveis. Oferece um SDK com código do cliente que lhe permite aceder a APIs Google Cloud relevantes para dispositivos móveis a partir de apps iOS, Android e Web. Para obter informações sobre as APIs Cloud suportadas e como começar a usar o Firebase, consulte a documentação do Firebase.

Usar o seu próprio código do cliente

Se for um programador experiente e as bibliotecas cliente da Google não satisfizerem as suas necessidades específicas, pode escrever o seu próprio código personalizado para aceder diretamente às APIs de serviços de nível inferior do serviço.

APIs REST/HTTP

Todas as APIs Cloud expõem uma interface JSON/REST tradicional simples. Se precisar de escrever o seu próprio código personalizado para aceder diretamente à API REST através de uma biblioteca cliente HTTP de terceiros, pode saber mais sobre como as APIs Cloud funcionam com diferentes versões e implementações HTTP nas diretrizes HTTP.

APIs gRPC

O gRPC é um sistema de chamadas de procedimento remoto (RPC) de código aberto, independente de linguagem e plataforma, inicialmente desenvolvido na Google. Pode saber mais em grpc.io. Geralmente, as APIs Cloud compatíveis com gRPC têm interfaces REST e RPC, pelo que, em vez de usar apenas JSON através de HTTP para comunicar com a interface REST, os clientes de API compatíveis com gRPC também podem usar buffers de protocolo e gRPC através de HTTP2 para comunicar com a interface RPC. Pode saber se uma API tem o gRPC ativado consultando a respetiva secção de APIs e referência.

Se uma API Cloud tiver o gRPC ativado, pode gerar as suas próprias bibliotecas cliente gRPC para a mesma em qualquer idioma suportado pelo gRPC. Para o fazer, precisa da definição do serviço dos protocol buffers da API (normalmente, disponível no repositório no GitHub). Em seguida, pode seguir as instruções para o seu idioma preferencial em grpc.io para gerar e usar o seu cliente.

Se não quiser gerar o seu próprio código gRPC, pode continuar a beneficiar do gRPC: um número crescente de bibliotecas cliente da nuvem para APIs compatíveis com gRPC usam o gRPC "nos bastidores" para comunicar com os servidores da Google. Isto é significativamente mais eficiente em termos de débito e utilização da CPU. O acesso a uma API através do gRPC pode aumentar o débito por CPU até 10 vezes em comparação com a API JSON REST. A Google planeia atualizar o maior número possível de bibliotecas de cliente do Google Cloud para gRPC. Entretanto, continua a ter todas as outras vantagens do código da biblioteca de cliente da Google.

Outras formas de aceder às APIs Cloud

Se não quiser aceder a uma API por programação, pode aceder a algumas das mesmas funcionalidades através das ferramentas na CLI Google Cloud ou através da Google Cloud consola.