Glossário

APIs em rede

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

APIs do Google

  • APIs em rede expostas pelos serviços do Google. A maioria deles está hospedada em um domínio googleapis.com. Esse termo não inclui outros tipos de APIs, como bibliotecas de clientes e SDKs.

    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 os usuários tenham uma experiência simples e consistente nas APIs do Google.

APIs Google Cloud

  • O subconjunto de APIs do Google expostas pelos serviços do Google Cloud. Para mais informações, consulte APIs do 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.

    Para APIs do Google, as noções de API e serviço são usadas como sinônimos do serviço da API. Elas estão listadas no Console do Google Cloud em Biblioteca de APIs.

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. Um serviço de API pode ter vários endpoints de serviço de API, como https://pubsub.googleapis.com e https://content-pubsub.googleapis.com

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.