As bibliotecas de cliente facilitam o acesso APIs do Google Cloud de um idioma com suporte. É possível usar as APIs do Google Cloud diretamente com solicitações brutas ao servidor, as bibliotecas de cliente simplificam que reduzem significativamente a quantidade de código que você precisa escrever.
Este documento explica os diferentes tipos de bibliotecas de clientes que o Google oferece para as APIs do Cloud. Você também pode saber mais sobre os serviços bibliotecas para seu produto ou idioma de sua escolha na na documentação do Google Cloud.
Bibliotecas de cliente do Cloud
Bibliotecas de cliente do Cloud são a opção recomendada para acessar as APIs do Cloud de maneira programática, em que disponíveis. As bibliotecas de cliente do Cloud usam o modelo mais recente e:
- Forneçam código idiomático em cada idioma para tornar as APIs do Cloud simples e intuitivas de usar.
- Fornecer um estilo consistente nas bibliotecas de cliente para simplificar o trabalho com elas. vários serviços de nuvem.
- processam todos os detalhes de baixo nível de comunicação com o servidor, incluindo autenticação com o Google;
- Podem ser instalados usando ferramentas de gerenciamento de pacotes conhecidas, como
npmepip. - em alguns casos, trazem benefícios de desempenho usando gRPC. Para mais Para mais informações, consulte as APIs gRPC.
Você pode encontrar instruções de instalação e material de referência para os do Cloud na página Bibliotecas de cliente para a APIs do Cloud que você está usando. Você pode encontrar links para começar a usar as bibliotecas de cliente do Cloud e a documentação de referência na página Bibliotecas de cliente do Cloud.
Faça um teste
Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
Comece a usar gratuitamenteBibliotecas de cliente de APIs do Google
Algumas APIs do Google Cloud não têm bibliotecas de cliente do Cloud disponíveis em todas idiomas. Se você quiser usar uma dessas APIs e não houver uma biblioteca de cliente do Cloud na sua linguagem preferida, ainda será possível usar o estilo anterior de biblioteca de cliente, chamado de Bibliotecas de cliente das APIs do Google. Você também pode usar essas bibliotecas se estiver fazendo upgrade de um projeto que já as usa. Essas bibliotecas:
- fornecem acesso apenas à interface REST da API. O gRPC não é compatível;
- Ter um código de interface gerado automaticamente que pode não ser tão idiomático quanto o bibliotecas de cliente do Cloud.
- Lidar com todos os detalhes de baixo nível de comunicação com o servidor, incluindo como autenticar com o Google.
- Pode ser instalado usando ferramentas conhecidas de gerenciamento de pacotes, como
npmepip.
Há links para essas bibliotecas na página das bibliotecas de cliente do Cloud APIs de terceiros.
Como usar a plataforma para dispositivos móveis do Firebase
O Firebase é a solução que abrange todos os serviços do Google para a criação de aplicativos em dispositivos móveis. Ele oferece um SDK com código de cliente que permite acessar conteúdo relevante para dispositivos móveis APIs do Cloud de apps iOS, Android e da Web. Para saber mais sobre os recursos APIs do Cloud e como começar a usar o Firebase, consulte o Documentação do Firebase.
Como usar seu próprio código de cliente
Se você é um desenvolvedor experiente e as bibliotecas de cliente do Google não atendem às suas necessidades específicas, é possível escrever seu próprio código personalizado para acessar diretamente as APIs de nível inferior do serviço.
REST/HTTP APIs
Todas as Cloud APIs expõem uma interface JSON/REST simples. Se você precisar escrever seu próprio código personalizado para acessar diretamente a API REST usando uma biblioteca de cliente HTTP de terceiros, saiba mais sobre como as APIs do Cloud funcionam com diferentes versões e implementações do HTTP nas Diretrizes de HTTP.
gRPC APIs
O gRPC é um sistema de chamada de procedimento remoto (RPC) neutro em relação a linguagem e plataforma, de código aberto e desenvolvido inicialmente pelo Google. Saiba mais em grpc.io. As APIs do Cloud com suporte a gRPC geralmente têm interfaces REST e RPC. Portanto, em vez de usar apenas JSON sobre HTTP para se comunicar com a interface REST, os clientes de API com suporte a gRPC também podem usar buffers de protocolo e gRPC sobre HTTP2 para se comunicar com a interface RPC. Você pode descobrir se uma API O gRPC foi ativado verificando a seção APIs e Referência.
Se uma API do Cloud for ativada para gRPC, você poderá gerar suas próprias bibliotecas de cliente gRPC para ela em qualquer linguagem aceita pelo gRPC. Para isso, você precisa da definição do serviço de buffers de protocolo da API, normalmente disponível no repositório no GitHub (em inglês). Siga as instruções referentes à sua linguagem favorita no grpc.io para gerar e usar o cliente.
Se você não quiser gerar seu próprio código gRPC, ainda é possível aproveitar o gRPC: um número crescente de bibliotecas de cliente do Cloud para APIs com gRPC usa o gRPC. "em segundo plano" para se comunicar com os servidores do Google. Isso é significativamente mais eficiente em termos de capacidade e uso da CPU: acessar uma API usando gRPC pode aumentar a capacidade por CPU em até 10 vezes em comparação com a API REST JSON. O Google planeja atualizar o maior número possível de bibliotecas de cliente do Cloud possível para gRPC. enquanto isso, você ainda tem todas as outras vantagens do código da biblioteca de cliente do Google.
Outras formas de acessar as Cloud APIs
Se você não quiser acessar uma API de maneira programática, acesse algumas das mesmas funcionalidades usando as ferramentas da CLI do Google Cloud ou o console do Google Cloud.