As APIs Google Cloud são interfaces programáticas para os serviços da Google Cloud Platform. São uma parte fundamental da Google Cloud Platform, o que lhe permite adicionar facilmente o poder de tudo, desde a computação à rede, ao armazenamento e à análise de dados baseada em aprendizagem automática, às suas aplicações.
Acerca das APIs Cloud
As APIs Cloud são expostas como serviços de API de rede aos clientes, como a API Cloud Pub/Sub. Normalmente, cada API Cloud é executada num ou mais subdomínios de googleapis.com, como pubsub.googleapis.com, e fornece interfaces JSON HTTP e gRPC aos clientes através da Internet pública e de redes de nuvem privada virtual (VPC). Os clientes podem enviar pedidos HTTP e gRPC
diretamente para os pontos finais da API Cloud ou através de bibliotecas cliente.
As APIs Cloud fazem parte da categoria APIs Google Enterprise na Trusted Cloud biblioteca de APIs da consola.
Existem dois tipos de Trusted Cloud APIs:
APIs baseadas em recursos, que usam o projeto associado aos recursos acedidos para faturação e quota.
APIs baseadas no cliente, que usam o projeto associado ao cliente que acede aos recursos para faturação e quota.
Aceder às APIs Cloud
Pode aceder às APIs Cloud a partir de aplicações de servidor com as nossas bibliotecas cliente em muitas linguagens de programação populares, a partir de apps para dispositivos móveis através dos SDKs do Firebase, ou através de clientes de terceiros. Também pode aceder às APIs Google Cloud com a CLI Google Cloud ou a consola Google Cloud.
Se está a usar as APIs Cloud pela primeira vez, consulte o artigo Introdução sobre como usar as APIs Cloud.
Suporte de HTTP e gRPC
Todas as APIs Cloud fornecem uma interface HTTP JSON simples que pode chamar diretamente ou através das bibliotecas cliente das APIs Google. A maioria das APIs Cloud também fornece uma interface gRPC que pode chamar através das bibliotecas cliente do Google Cloud, que oferecem melhor desempenho e usabilidade. Também pode usar clientes de terceiros.
Para mais informações sobre as nossas bibliotecas de cliente, consulte o artigo Bibliotecas de cliente explicadas.
Para mais informações sobre a autenticação para usar as APIs Google, consulte os métodos de autenticação na Google e a autenticação para usar bibliotecas cliente.
Encriptação TLS
Todas as APIs Cloud só aceitam pedidos seguros através da encriptação TLS.
- Se estiver a usar uma das nossas bibliotecas de cliente, a encriptação em trânsito é processada pela biblioteca.
- Se estiver a usar o seu próprio cliente gRPC, tem de fazer a autenticação junto da Google (o que requer TLS) seguindo as instruções no guia de autenticação gRPC.
- Se estiver a criar o seu próprio cliente HTTP, consulte as nossas diretrizes de HTTP.
Pode saber mais sobre como o tráfego para os Trusted Cloud by S3NS serviços é protegido no nosso guia de segurança Encriptação em trânsito.
Private Service Connect
Os clientes empresariais querem frequentemente aceder às APIs Cloud de forma privada por motivos de segurança e conformidade. Pode usar o Private Service Connect para configurar e gerir esse acesso nas suas redes VPC.
Para mais informações, consulte o artigo Configurar o Private Service Connect.
Exemplos passo a passo
Consulte os seguintes guias passo a passo que usam as bibliotecas cliente para algumas APIs populares:
- API Cloud Billing Budget com Node.js.
- API Cloud Billing Budget com Python.
- Cloud Logging com Node.js.
- Cloud Logging com Python.
- Cloud Logging com Go.
- Cloud Logging com Java.
- Speech-to-Text com Node.js.
- Conversão de voz em texto com Python.
- Conversão de voz em texto com o Go.
- Conversão de voz em texto com Java.
Guia de design de APIs
Independentemente do tipo de interface, todas as APIs Google Cloud usam princípios de design orientados para recursos, conforme descrito no nosso guia de design de APIs, o que garante que as APIs Google Cloud têm uma experiência de programador simples e consistente. Pode consultar o nosso guia de design de APIs para compreender melhor as APIs Cloud.
Se quiser estudar a definição da interface das APIs Cloud, pode visitar o repositório das APIs Google no GitHub.
Limitar a sua utilização
As APIs Cloud são partilhadas entre milhões de programadores e utilizadores. Para garantir uma utilização justa e minimizar os riscos de abuso, todas as APIs Google Cloud estão a aplicar limites de taxa e quotas de recursos na utilização, conhecidas como quotas. Também pode usar estas cotas para controlar os seus gastos em produtos do Google Cloud reduzindo os seus próprios limites de cotas. Se precisar de mais quotas do que os limites predefinidos, tem de enviar pedidos de aumento da quota.
Para mais informações, consulte o artigo Limitar a utilização da API.
Monitorizar a utilização
A maioria das APIs Google Cloud fornece informações detalhadas sobre a utilização da API pelo seu projeto, incluindo níveis de tráfego, taxas de erro e latências. Ajuda a priorizar rapidamente problemas com aplicações que usam APIs Cloud. Pode ver estas informações no Painel de controlo da API da Google Cloud na Trusted Cloud consola. Também pode criar painéis de controlo e alertas personalizados no Cloud Monitoring.
Para mais informações, consulte o artigo Monitorizar a utilização da API.
APIs Google Enterprise
As APIs Google Enterprise são APIs de alta estabilidade, prontas para utilização empresarial com opções de apoio técnico disponíveis.
Para mais informações, consulte as APIs Google Enterprise.