Explicações sobre bibliotecas de cliente

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 ao fazer 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 interface 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:

• Fornecer código idiomático em cada linguagem para tornar as APIs do Cloud simples e intuitivo de usar.
• Fornecer um estilo consistente nas bibliotecas de cliente para simplificar o trabalho com elas. vários serviços de nuvem.
• Lidar com todos os detalhes de baixo nível de comunicação com o servidor, incluindo como autenticar com o Google.
• Podem ser instalados usando ferramentas de gerenciamento de pacotes conhecidas, como npm e pip.
• Em alguns casos, oferecem benefícios de desempenho usando gRPC. Para mais Para mais informações, consulte as APIs gRPC.

Você encontra 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ê encontra links para começar a usar Bibliotecas de cliente do Cloud e a respectiva documentação de referência sobre o página Bibliotecas de cliente do Cloud.

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 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á que os 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;
• 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 npm e pip.

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 todo o Google para a criação de aplicativos em dispositivos móveis dispositivos. 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ê for um desenvolvedor experiente e as bibliotecas de cliente do Google não atenderem aos seus necessidades específicas, você pode escrever seu próprio código personalizado para acessar a interface APIs de serviço de nível inferior.

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 um serviço biblioteca de cliente HTTP, você pode saber mais sobre como as APIs do Cloud funcionam diferentes versões e implementações de HTTP na Diretrizes 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 ativadas para gRPC geralmente têm interfaces REST e RPC. Por isso, em vez do que apenas usar JSON em HTTP para se comunicar com a interface REST, a API gRPC ativada os clientes também podem usar buffers de protocolo e gRPC em 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. em qualquer linguagem compatível com gRPC. Para fazer isso, você vai precisar do URL buffers de protocolo definição de serviço (normalmente disponível em no GitHub. Depois, siga as instruções no idioma de sua preferência no grpc.io para gerar e usar seu 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 de processamento e uso de CPU, acessando uma API o uso do gRPC pode aumentar a capacidade por CPU até 10 vezes em comparação para 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, poderá acessar alguns das mesmas funcionalidades usando as ferramentas Google Cloud CLI ou a Console do Google Cloud.