Glossário

APIs de rede

  • 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 e serviços

  • 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.

APIs do Google Cloud

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

Interface de API

  • 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.

Versão 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.

Método de API

  • 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.

Solicitação de API

  • 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.

Serviço de API

  • É 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.

Título da API

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

Nome do serviço da API

  • 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".

Endpoint de serviço da API

  • 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.

Definição de serviço de API

  • 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.

Produto de API

  • 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.

Consumidor de 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.

Produtor de API

  • 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.

Back-end 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.

Front-end 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.