Glosario

APIs de red

• Interfaces de programación de aplicaciones que operan a través de una red de computadoras. Se comunican con protocolos de red, como HTTP y, con frecuencia, las producen organizaciones diferentes a las que las consumen.

Las APIs de Google

• APIs de red expuestas por los servicios de Google La mayoría de ellas se alojan en el dominio googleapis.com. Puedes descubrir las APIs de Google disponibles con la consola de Google Cloud y la API de Service Usage. Este término no incluye otros tipos de APIs, como bibliotecas cliente y SDKs.

  Nota: Todas las APIs de Google comparten un modelo de uso común: un consumidor de API consume un servicio de API administrado por un productor de API. Esto permite que los desarrolladores y los usuarios tengan una experiencia simple y coherente en todas las APIs de Google.

APIs de Google Cloud

• Subconjunto de las API de Google expuestas por los servicios de Google Cloud. Para obtener más información, consulta APIs de Google Cloud.

Interfaz de API

• Una definición service de búferes de protocolo. Por lo general, se asigna a una interfaz en la mayoría de los lenguajes de programación. Cualquier cantidad de ser de servicios de API puede implementar una interfaz de API.

Versión de API

• La versión de una interfaz de API o un grupo de interfaces de API si se definen juntas. Una versión de API se suele representar con una string, como “v1”, y se presenta en las solicitudes a las API y nombres de paquete de búferes de protocolo.

Método de API

• Una operación individual dentro de una interfaz de API. Se representa en búferes de protocolo mediante una definición rpc y se suele asignar a una función en una interfaz en la mayoría de los lenguajes de programación.

Solicitud a la API

• Una sola invocación de un método de API. Se suele usar como la unidad de facturación, registro, supervisión y límite de frecuencia.

Servicio de API

• Una implementación de una o más interfaces de API, expuestas en una o más direcciones de red, como la API de Cloud Pub/Sub.

  Nota: Tanto API como API son términos que se usan con frecuencia para la ingeniería de software. Significan cosas muy diferentes en distintos contextos. Te recomendamos que no definas sus significados. En el caso de las APIs de Google, API y service se usan como una abreviatura de los servicios de API que proporciona Google, que se enumeran en la consola de Google Cloud, en la Biblioteca de API.

Título de la API

• Se refiere al título de producto de un servicio de API para el usuario, como “API de Cloud Pub/Sub”.

Nombre del servicio de API

• Se refiere al identificador lógico de un servicio de API. Las API de Google usan nombres compatibles con DNS RFC 1035 como nombres de servicios de la API, como “pubsub.googleapis.com”.

Extremo del servicio de API

• Se refiere a una dirección de red que un servicio de API usa para cumplir las solicitudes reales a la API. Ejemplos: https://pubsub.googleapis.com y https://content-pubsub.googleapis.com. Un solo servicio puede tener más de un extremo.

Definición de servicio de API

• La combinación de definiciones de interfaz de API (archivos .proto) y configuraciones de servicio de API (archivos .yaml) que se usa para definir un servicio de API. El esquema para la definición del servicio de la API de Google es google.api.Service.

Producto de API

• Un servicio de API y sus componentes relacionados (como las Condiciones del Servicio, documentación, bibliotecas cliente y asistencia del servicio) se presentan de manera colectiva a los clientes como un producto. Por ejemplo, la API del Calendario de Google. En ocasiones, las personas se refieren a un producto de API solo como una API.

Consumidor de API

• La entidad que consume un servicio de API. Para las API de Google, suele ser un proyecto de Google que posee la aplicación cliente o el recurso del servidor.

Productor de API

• La entidad que produce un servicio de API. Para las API de Google, suele ser un proyecto de Google que posee el servicio de API.

Backend de API

• Un conjunto de servidores y de infraestructuras relacionadas que implementan la lógica empresarial para un servicio de API. Un servidor individual de backend de API se suele llamar servidor de API.

Frontend de API

• Un conjunto de servidores y de infraestructuras relacionadas que proporcionan una funcionalidad común en todos los servicios de API, como el balanceo de cargas y la autenticación. Un servidor individual de frontend de API se suele llamar proxy de API.

  Ten en cuenta que el frontend y el backend de API pueden ejecutarse cerca o alejados entre ellos. En algunos casos, pueden compilarse en un solo objeto binario de aplicación y ejecutarse en un solo proceso.