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

As bibliotecas de cliente permitem acessar as APIs Google Cloud de maneira programática com menos código boilerplate, lidando com a autenticação e a comunicação de baixo nível com o servidor. Este documento explica os seguintes métodos para interagir com as APIs Google Cloud :

• Bibliotecas de cliente do Cloud (recomendado)
• Bibliotecas de cliente de APIs do Google
• A plataforma de desenvolvimento do Firebase
• Seu próprio código de cliente

Para encontrar informações sobre a biblioteca de cliente de um produto Google Cloud específico, consulte a seção de bibliotecas de cliente na documentação desse produto.

Bibliotecas de cliente do Cloud

Embora seja possível usar as APIs do Google Cloud diretamente fazendo solicitações brutas ao servidor, as bibliotecas de cliente do Cloud oferecem simplificações que reduzem significativamente a quantidade de código que você precisa escrever. As bibliotecas de cliente do Cloud são a opção recomendada para acessar as APIs do Cloud de maneira programática, porque usam o modelo de biblioteca de cliente mais recente e:

• Forneça código idiomático em cada linguagem para tornar as APIs Google Cloud intuitivas de usar.
• Oferecer um estilo consistente em todas as bibliotecas de cliente para simplificar o trabalho com vários serviços do Google Cloud .
• Cuidam de todos os detalhes de baixo nível da 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, oferecem benefícios de performance usando o 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 para cada 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 sem custos financeiros

Bibliotecas de cliente de APIs do Google

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

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

• fornecem acesso apenas à interface REST da API. O gRPC não é compatível;
• Ter código de interface gerado automaticamente que pode não ser tão idiomático quanto as bibliotecas de cliente do Cloud.
• Cuidam de todos os detalhes de baixo nível da 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.

Usar a plataforma de desenvolvimento do Firebase

O Firebase é a plataforma de serviços do Google projetada para oferecer suporte a todo o ciclo de vida de desenvolvimento de apps. Ele oferece SDKs multiplataforma para ajudar você e os agentes de IA a criar e executar apps para plataformas Apple, Android, Web, Flutter, Unity e C++.

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ê for um desenvolvedor experiente e as bibliotecas de cliente do Cloud não atenderem às suas necessidades específicas, escreva seu próprio código personalizado para acessar diretamente as APIs de serviço de nível mais baixo.

REST/HTTP APIs

Todas as APIs 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 Google Cloud funcionam com diferentes versões e implementações 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, inicialmente desenvolvido no Google. Saiba mais em grpc.io. As APIs compatíveis com gRPC Google Cloud geralmente têm interfaces REST e RPC. Assim, 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. Para saber se uma API é compatível com gRPC, consulte a seção "APIs e referência".

Se uma API Google Cloud estiver ativada para gRPC, você poderá gerar suas próprias bibliotecas de cliente gRPC para ela em qualquer linguagem compatível com gRPC. Para isso, você precisa da definição de serviço de buffers de protocolo da API, que geralmente está disponível no repositório no GitHub.

Em seguida, siga as instruções do seu idioma preferido em grpc.io para gerar e usar seu cliente.

Se você não quiser gerar seu próprio código gRPC, ainda poderá se beneficiar dele. Um número crescente de bibliotecas de cliente do Cloud para APIs compatíveis com gRPC usam o gRPC "por baixo dos panos" para se comunicar com os servidores do Google. Isso é muito mais eficiente em termos de capacidade de processamento e uso da CPU. O acesso a uma API usando gRPC pode aumentar a capacidade de processamento por CPU em até 10 vezes em comparação com a API REST JSON. O Google planeja fazer upgrade do máximo possível de bibliotecas de cliente do Cloud para gRPC. Enquanto isso, você ainda terá todas as outras vantagens do código da biblioteca de cliente do Google.

Outras formas de acessar as APIs do Cloud

Se você não quiser acessar uma API de maneira programática, poderá acessar algumas das mesmas funcionalidades usando as ferramentas na Google Cloud CLI ou usando o consoleGoogle Cloud .