Explicações sobre bibliotecas de cliente

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Com as bibliotecas de cliente, é mais fácil acessar as APIs do Google Cloud em uma linguagem com suporte. Embora seja possível usar as APIs do Google Cloud diretamente fazendo solicitações brutas ao servidor, as bibliotecas de cliente oferecem simplificações que reduzem significativamente a quantidade de código que você precisa escrever.

Neste documento, explicamos os diferentes tipos de bibliotecas de cliente que o Google fornece para APIs do Cloud. Saiba mais sobre as bibliotecas disponíveis para seu produto ou idioma escolhido na documentação do produto ou idioma.

Bibliotecas de cliente do Cloud

As bibliotecas de cliente do Cloud são a opção recomendada para acessar as APIs do Cloud de maneira programática, quando disponíveis. As bibliotecas de cliente do Cloud usam o modelo de biblioteca de cliente mais recente e:

  • Forneça código idiomático em cada linguagem para tornar as APIs do Cloud simples e intuitivas de usar.
  • Fornecer um estilo consistente em todas as bibliotecas de cliente para simplificar o trabalho com vários serviços do Cloud.
  • Gerencie todos os detalhes de baixo nível de comunicação com o servidor, incluindo a autenticação com o Google.
  • Pode ser instalado usando ferramentas conhecidas de gerenciamento de pacotes, como npm e pip.
  • Em alguns casos, isso proporciona benefícios de desempenho usando o gRPC. Para mais informações, consulte as APIs gRPC.

Encontre instruções de instalação e material de referência para a biblioteca de cliente do Cloud na página "Bibliotecas de cliente" das APIs do Cloud que você está usando. Você encontra links para começar a usar as bibliotecas de cliente do Cloud e a documentação de referência na página de bibliotecas do 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 gratuitamente

Bibliotecas de cliente de APIs do Google

Algumas APIs do Google Cloud não têm bibliotecas de cliente do Cloud disponíveis em todas as linguagens. Se você quiser usar uma dessas APIs e não houver uma biblioteca de cliente do Cloud para sua linguagem preferida, ainda será possível usar o estilo anterior de biblioteca de cliente, chamado de Bibliotecas de cliente da API do Google. Você também pode usar essas bibliotecas se fizer upgrade de um projeto que já as usa. Essas bibliotecas:

  • fornecem acesso apenas à interface REST da API. O gRPC não é compatível;
  • Tenha um código de interface gerado automaticamente que possa não ser tão idiomático quanto as bibliotecas de cliente do Cloud.
  • Gerencie todos os detalhes de baixo nível de comunicação com o servidor, incluindo a autenticação com o Google.
  • Pode ser instalado usando ferramentas conhecidas de gerenciamento de pacotes, como npm e pip.

Essas bibliotecas estão vinculadas na página "Bibliotecas de cliente" das APIs do Cloud relevantes.

Como usar a plataforma para dispositivos móveis do Firebase

O Firebase é a solução para criar aplicativos em dispositivos móveis em todo o Google. Ele oferece um SDK com código do cliente que permite acessar APIs do Cloud relevantes para dispositivos móveis em apps iOS, Android e da Web. Para informações sobre as APIs do Cloud compatíveis e como dar os primeiros passos com o Firebase, consulte a 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, escreva seu próprio código personalizado para acessar as APIs de serviço de nível inferior do serviço diretamente.

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, veja mais informações sobre como as APIs do Cloud funcionam com diferentes versões e implementações de HTTP nas Diretrizes de HTTP.

gRPC APIs

O gRPC é um sistema de chamada de procedimento remoto (RPC) neutro em relação à linguagem, à plataforma, ao código aberto e desenvolvido inicialmente no Google. Saiba mais em grpc.io. As APIs do Cloud ativadas para gRPC geralmente têm interfaces REST e RPC. Portanto, em vez de apenas usar JSON por HTTP para se comunicar com a interface REST, os clientes de API gRPC habilitados também podem usar buffers de protocolo e gRPC por HTTP2 para se comunicar com a interface da RPC. Para descobrir se uma API está ativada para gRPC, verifique as seções "APIs" e "Referência".

Se uma API Cloud estiver ativada para gRPC, será possível gerar suas próprias bibliotecas de cliente gRPC para ela em qualquer linguagem compatível com gRPC. Para fazer isso, você precisará da definição do serviço de buffers de protocolo da API (normalmente disponível no repositório no GitHub). Depois, siga as instruções da sua linguagem preferida em grpc.io para gerar e usar o cliente.

Se você não quer gerar seu próprio código gRPC, ainda pode se beneficiar do gRPC: um número crescente de bibliotecas de cliente do Cloud para APIs ativadas por gRPC usa gRPC em segundo plano" para se comunicar com os servidores do Google. Isso é significativamente mais eficiente em termos de capacidade e uso de CPU. O acesso a uma API usando gRPC pode aumentar a capacidade por CPU em até um fator de 10 em comparação com a API REST JSON. O Google planeja fazer upgrade do maior número possível de bibliotecas de cliente do Cloud para o gRPC. Enquanto isso, você ainda terá todas as outras vantagens do código de biblioteca de cliente do Google.

Outras formas de acessar as Cloud APIs

Se você não quiser acessar uma API de forma programática, poderá acessar algumas da mesma funcionalidade usando as ferramentas da Google Cloud CLI ou o Console do Google Cloud.