Glosario

API conectadas en 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.

API de Google

  • API conectadas en red expuestas por servicios de Google. La mayoría de ellas se alojan en el dominio googleapis.com. Este término no incluye otros tipos de API, como bibliotecas cliente y SDK.

    Todas las API 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 usuarios tengan una experiencia simple y coherente en todas las API de Google.

API de Google Cloud

  • Los servicios de Google Cloud que exponen el subconjunto de API de Google. Para obtener más información, consulta API de 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 con 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.

    Para las API de Google, las nociones de API y servicio se usan como sinónimos del servicio de API. Se enumeran en Google Cloud Console en Biblioteca de API.

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 a la API reales. Un servicio de API puede tener varios extremos de servicio de API, como https://pubsub.googleapis.com y https://content-pubsub.googleapis.com

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 de Calendario de Google. En ocasiones, las personas hacen referencia 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.