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 métodos de interação com as Google Cloud APIs:
- Bibliotecas de cliente do Google Cloud (recomendado)
- Bibliotecas cliente de APIs Google
- Firebase mobile
- O seu próprio código de cliente
Para encontrar informações da biblioteca de cliente de um Google Cloud produto específico, consulte a secção de bibliotecas de cliente na documentação desse produto. Para ver todas as bibliotecas cliente do Google Cloud, muitas vezes organizadas por idioma suportado, consulte Bibliotecas cliente do Google Cloud.
Bibliotecas cliente do Cloud
As bibliotecas cliente da Google Cloud são a opção recomendada para aceder às APIs Google 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 Google Cloud APIs intuitivas de usar.
- Oferecer um estilo consistente nas bibliotecas de cliente para simplificar o trabalho com vários serviços. 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
npmepip. - Em alguns casos, oferecem-lhe vantagens de desempenho através da utilização do gRPC. Para mais informações, consulte as APIs gRPC.
As instruções de instalação e os materiais de referência das bibliotecas cliente da Google Cloud dependem da Google Cloud API específica e da linguagem de programação que está a usar. Para encontrar estas informações, consulte a documentação do produto Google Cloud específico. A maioria dos produtos inclui uma secção "Bibliotecas de cliente" na respetiva documentação, que fornece orientações específicas do idioma, passos de instalação e links para a referência detalhada da API.
Pode encontrar a documentação de um produto específico ao procurar na Google Cloud biblioteca de APIs.
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 gratuitamenteBibliotecas cliente de APIs Google
Se as bibliotecas cliente da nuvem não estiverem disponíveis para a sua linguagem preferida para uma API específica, pode usar as bibliotecas cliente de APIs Google. Estas são um tipo anterior de biblioteca de cliente fornecida pela 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
npmepip.
Use 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 de cliente que lhe permite aceder a Google Cloud APIs relevantes para dispositivos móveis a partir de apps iOS, Android e Web. Para obter informações sobre as Google Cloud APIs suportadas e como começar a usar o Firebase, consulte a documentação do Firebase.
Use o seu próprio código de cliente
Se for um programador experiente e as bibliotecas cliente da nuvem 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 Google Cloud APIs expõem uma interface JSON/REST. 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 funcionam com diferentes versões e implementações HTTP nas diretrizes HTTP. Google Cloud
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. As APIs com gRPC geralmente 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 da API com gRPC também podem usar buffers de protocolo e gRPC através de HTTP2 para comunicar com a interface RPC. Google Cloud Pode saber se uma API tem o gRPC ativado verificando as respetivas APIs e secção de referência.
Se uma Google Cloud API tiver o gRPC ativado, pode gerar as suas próprias bibliotecas cliente gRPC para a mesma em qualquer linguagem suportada pelo gRPC. Para o fazer, precisa da definição do serviço de buffers de protocolo 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.