Explicação sobre as bibliotecas de cliente e as APIs do Cloud

É possível usar as APIs do Google Cloud 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.

Este documento explica métodos para interagir com as APIs Google Cloud :

  • Bibliotecas de cliente do Cloud (recomendado)
  • Bibliotecas de cliente de APIs do Google
  • Firebase para dispositivos móveis
  • Seu próprio código de cliente

Para encontrar informações sobre biblioteca de cliente de um produto Google Cloud específico, consulte a seção de bibliotecas de cliente na documentação desse produto. Para conferir todas as bibliotecas de cliente do Cloud, geralmente organizadas por linguagem compatível, consulte Bibliotecas de cliente do Cloud.

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ível. As bibliotecas de cliente do Cloud usam o modelo de biblioteca de cliente mais recente e:

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

As instruções de instalação e os materiais de referência das bibliotecas de cliente do Cloud dependem da API Google Cloud específica e da linguagem de programação que você está usando. Para encontrar essas informações, consulte a documentação do produto Google Cloud específico. A maioria dos produtos inclui uma seção "Bibliotecas de cliente" na documentação, que fornece orientações específicas da linguagem, etapas de instalação e links para a referência detalhada da API.

Para encontrar a documentação de um produto específico, navegue pela biblioteca de APIs doGoogle Cloud .

Faça um teste

Se você começou a usar o Google Cloudagora, 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

Se as bibliotecas de cliente do Cloud não estiverem disponíveis na sua linguagem preferida para uma API específica, use as bibliotecas de cliente da API do Google. São um tipo mais antigo de biblioteca de cliente fornecida pelo Google.

Você também pode usar essas bibliotecas se estiver fazendo upgrade de um projeto que já as utiliza. Essas bibliotecas:

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

Usar a plataforma móvel 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 APIs Google Cloud relevantes para dispositivos móveis em apps iOS, Android e da Web. Para informações sobre as APIs Google Cloud compatíveis e como começar a usar o Firebase, consulte a documentação do Firebase.

Use seu próprio código de cliente

Se você é um desenvolvedor experiente e as bibliotecas de cliente do Cloud 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 APIs do Google Cloud expõem uma interface JSON/REST. 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 Google 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) de código aberto, independente de linguagem e plataforma, desenvolvido inicialmente no Google. Saiba mais em grpc.io. As APIs compatíveis com gRPC geralmente têm interfaces REST e RPC. Em vez de usar apenas JSON por HTTP para se comunicar com a interface REST, os clientes de API compatíveis com gRPC também podem usar buffers de protocolo e gRPC por HTTP2 para se comunicar com a interface RPC. Google Cloud Você pode descobrir se uma API é ativada por gRPC verificando a respectiva seção de APIs e referência.

Se uma Google Cloud API é habilitada para gRPC, você pode gerar suas próprias bibliotecas de cliente gRPC para ela em qualquer linguagem compatível com 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 poderá se beneficiar do gRPC: um número crescente de bibliotecas de cliente do Cloud para APIs habilitadas para gRPC usa o gRPC "nos bastidores" 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 fazer o 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 maneira programática, acesse algumas das mesmas funcionalidades usando as ferramentas da Google Cloud CLI ou o consoleGoogle Cloud .