Glossário

Interfaces de programação do aplicativo que operam em uma rede de computadores. Elas se comunicam usando protocolos de rede, incluindo HTTP e gRPC, e são frequentemente produzidas por organizações diferentes das que os utilizam.

APIs de rede expostas pelos serviços do Google. A maioria deles está hospedada em um domínio googleapis.com. Descubra as APIs do Google disponíveis usando o Console do Google Cloud e a API Service Usage. Esse termo não inclui outros tipos de APIs, como bibliotecas de cliente e SDKs.

Observação: todas as APIs do Google compartilham um modelo de uso comum: um consumidor de API consome um serviço de API gerenciado por um produtor de API. Isso permite que desenvolvedores e usuários tenham uma experiência simples e consistente em todas as APIs do Google.

O subconjunto de APIs do Google expostas pelos serviços do Google Cloud. Para mais informações, consulte APIs do Google Cloud.

Uma definição de service de buffers de protocolo. Geralmente é mapeada para uma interface na maioria das linguagens de programação. Uma interface de API pode ser implementada por qualquer número de Serviços da API.

A versão de uma interface de API ou de um grupo de interfaces, se elas forem definidas em conjunto. Uma versão de API é muitas vezes representada por uma string, como "v1", e apresenta solicitações de API e nomes de pacotes de Buffers de protocolo.

Uma operação individual dentro de uma interface de API. É representada em Buffers de protocolo por uma definição de rpc e normalmente é mapeada para uma função em uma interface na maioria das linguagens de programação.

Uma única invocação de um método de API. Geralmente é usada como unidade para faturamento, geração de registros, monitoramento e limitação de taxa.

É uma implementação implantada de uma ou mais interfaces de API, expostas em um ou mais endereços de rede, como API Cloud Pub/Sub.

Observação :API e API são termos usados com frequência para engenharia de software. Eles têm significados muito diferentes em contextos distintos. É altamente recomendável não definir os significados deles. Para as APIs do Google, API e service são usados como uma abreviação dos serviços de API fornecidos pelo Google, que estão listados no console do Google Cloud, em Biblioteca de APIs.

Refere-se ao título do produto voltado ao usuário de um serviço de API, como "API Cloud Pub/Sub".

Refere-se ao identificador lógico de um serviço de API. As APIs do Google usam nomes compatíveis com DNS RFC 1035 como nomes de serviço de API, como "pubsub.googleapis.com".

Refere-se a um endereço de rede que um serviço de API usa para atender às solicitações reais da API. Exemplos: https://pubsub.googleapis.com, https://content-pubsub.googleapis.com. Um único serviço pode ter mais de um endpoint.

A combinação de definições de Interface de API (arquivos .proto) e configurações de serviço de API (arquivos .yaml) usados para definir um serviço dela. O esquema para a definição de serviço da API do Google é google.api.Service.

Um serviço de API além dos componentes relacionados, como Termos de serviço, documentação, bibliotecas de cliente e compatibilidade com serviços, que é apresentado coletivamente aos clientes como um produto. Por exemplo, a API do Google Agenda. Às vezes, as pessoas se referem a um produto de API simplesmente como uma API.

A entidade que consome um serviço de API. Para as APIs do Google, normalmente é um projeto dele que tem o aplicativo cliente ou o recurso do servidor.

A entidade que produz um serviço de API. Para as APIs do Google, normalmente é um projeto dele que tem o serviço de API.

Um conjunto de servidores além da infraestrutura relacionada que implementa a lógica de negócios para um Serviço de API. Um servidor de back-end de API individual geralmente é chamado de servidor de API.

Um conjunto de servidores além da infraestrutura relacionada que oferece funcionalidade comum em todos os serviços de API, como balanceamento de carga e autenticação. Um servidor de front-end de API individual geralmente é chamado de proxy de API.

Observe que o front-end e o back-end da API podem ser executados lado a lado ou longe um do outro. Em alguns casos, eles podem ser compilados em um único binário de aplicativo e executados em um único processo.