Descripción general del uso de la API

En esta guía, se proporciona una descripción general del uso de la API de Dialogflow y su documentación de referencia.

REST, gRPC y bibliotecas cliente

Puedes acceder a la API a través de REST, gRPC o una de las bibliotecas cliente proporcionadas (compiladas en gRPC).

Bibliotecas cliente

Google proporciona bibliotecas cliente para que muchos idiomas populares puedan acceder a esta API. Si el lenguaje de programación deseado es compatible con las bibliotecas cliente, debes usar esta opción.

Ventajas Desventajas
Las mantiene Google.
Autenticación incorporada.
Reintentos integrados.
Identimática para cada idioma
Cuerpo de la solicitud HTTP de búfer de protocolo eficiente.
No está disponible para todos los lenguajes de programación.

REST

Esta API es compatible con REST. Consulta la referencia de REST de .

Ventajas Desventajas
Interfaz JSON sencilla.
Compatible con muchas herramientas y bibliotecas de Google y de terceros.
Debes crear tu propio cliente.
Debes implementar autenticación.
Debes implementar reintentos.
Cuerpo de solicitud HTTP menos eficiente.
Esta transmisión no es compatible con la transmisión de REST.

gRPC

Esta API es compatible con gRPC. Consulta la referencia de RPC, que proporciona una descripción genérica de los tipos, métodos y campos generados para una biblioteca de gRPC.

Ventajas Desventajas
Admite muchos lenguajes de programación.
Cuerpo de la solicitud HTTP de búfer de protocolo eficiente.
Debes generar tu propio cliente desde los búferes de protocolo proporcionados por Google.
Debes implementar autenticación.
Debes implementar reintentos.

Tipo, método y nombres de campo

Según si usas bibliotecas cliente, REST o gRPC, el tipo, los métodos y los nombres de campo para la API varían de alguna manera:

  • REST se organiza por jerarquías de recursos y sus métodos.
  • Las bibliotecas cliente y gRPC se organizan por servicios y sus métodos.
  • Los nombres de campos REST usan mayúsculas y minúsculas, aunque el servicio de API aceptará un camel case o snake case.
  • Los nombres de campo de gRPC usan snake case.
  • Los nombres de campos de la biblioteca cliente usan camel case o snake case, según el nombre idiomático para el idioma.

Versiones de API

Las siguientes versiones de la API están disponibles:

  • V2: estable y disponible de manera general.
  • V2Beta1: Se usa para compartir las funciones Beta más recientes y futuras.