Cómo buscar y seleccionar APIs de Google

1. Antes de comenzar

En este codelab, se muestra cómo buscar y seleccionar APIs de Google, y cómo ver las métricas de las APIs.

Requisitos previos

  • Capacidad para navegar por la consola de Google Cloud

Qué aprenderás

Requisitos

2. Accede a las APIs desde la consola de Cloud

  1. En la consola de Cloud, selecciona 5854836f11d5d97b.png Menú de navegación > APIs y servicios > APIs y servicios habilitados.

El menú de navegación en la consola de Cloud que muestra

  1. En el panel de APIs & Services, haz clic en + ENABLE APIS AND SERVICES para ver las APIs disponibles.

El panel de APIs y servicios que muestra la opción HABILITAR APIS Y SERVICIOS.

En la página APIs y servicios, hay varias formas de buscar APIs. Si conoces el nombre de la API, puedes ingresarlo en el campo Buscar APIs y servicios en la parte superior de la página. También puedes filtrar las APIs por categoría con los filtros que se encuentran al costado de la página.

Una lista de APIs que se obtienen del campo Buscar APIs y servicios

  1. En el menú CATEGORY, selecciona Machine learning para ver solo las APIs de aprendizaje automático.

APIs filtradas por CATEGORÍA para mostrar solo las APIs de aprendizaje automático.

  1. En las APIs de aprendizaje automático, selecciona API de Cloud Natural Language para ver los detalles de esta API.
  2. Haz clic en HABILITAR para habilitar esta API en el proyecto correspondiente.

Panel de la API de Cloud Natural Language que muestra los botones HABILITAR y PROBAR ESTA API.

Cuando habilitas la API, se muestra su página de descripción general. Puedes ver las métricas de tu uso de esta API, que tiene muy poca información porque la habilitaste recientemente.

La página de descripción general de la API seleccionada que muestra las métricas de la API.

En un codelab futuro, obtendrás más información para crear credenciales, pero, si tienes curiosidad ahora, haz clic en CREATE CREDENTIALS y, luego, responde las preguntas que se presenten.

  1. Haz clic en ADMINISTRAR para volver al resumen del paso anterior.

Página de descripción general de la API de Cloud Natural Language

  1. Para probar la API (incluso antes de habilitarla), haz clic en PROBAR ESTA API.

Por lo general, esto te lleva a una página de la documentación de la API. Sin embargo, en el caso de algunas APIs, no hay una forma inmediata de probarlas porque tienen muchos métodos diferentes. Ese es el caso de la API de Cloud Natural Language.

Página de referencia de la API de Cloud Natural Language

  1. Selecciona el método analyzeEntitites.

Deberías ver una página web con detalles sobre los métodos de la API y un panel Prueba esta API.

Página del método analyzeEntities que muestra los detalles del método y un panel de Try this API.

  1. Para probar una consulta de ejemplo, agrega un objeto document al campo Cuerpo de la solicitud con estos parámetros. Haz clic en los íconos + para expandir las opciones de los campos.
  2. En el campo content:, ingresa el texto que deseas analizar.

En este ejemplo, se usa Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'..

  1. En el campo type:, selecciona PLAIN_TEXT.

El cuerpo de la solicitud debería verse de la siguiente manera:

Panel del cuerpo de la solicitud que muestra los parámetros del cuerpo de la solicitud.

Para obtener más información sobre cada parámetro, consulta la documentación.

  1. Desmarca la casilla de verificación Google OAuth 2.0 y, luego, haz clic en Ejecutar para obtener una respuesta con detalles sobre las entidades.

Respuesta 200 con detalles sobre las entidades.

  1. Desmarca la casilla de verificación Clave de API y, luego, haz clic en Ejecutar de nuevo.

Cuando ejecutes la consulta esta vez, obtendrás un error como este porque la API requiere credenciales para ejecutarse.

Respuesta 403 para la solicitud a la que le faltan credenciales.

  1. Selecciona la casilla de verificación Google OAuth 2.0 y, luego, vuelve a hacer clic en Ejecutar.

OAuth 2.0 proporciona los permisos de la API en tu cuenta y te muestra una advertencia.

Advertencia de OAuth 2.0 que indica que el Explorador de APIs de Google quiere acceder a tu Cuenta de Google.

Si permites el acceso, obtendrás la misma respuesta que con las claves de API. Si usas la API en una app y necesitas otorgar acceso a personas que conocen sus credenciales, debes usar OAuth 2.0. Si es suficiente con que la app acceda a la API para el usuario, puedes usar claves de API.

3. Consulta tus métricas de la API con el Explorador de métricas

Puedes ver el historial de llamadas de cualquier API individual en la página de descripción general de la API, como se muestra en el paso 6 de Cómo acceder a las APIs desde Cloud Console. Sin embargo, para ver más métricas sobre el uso de todas las APIs, usa el Explorador de métricas.

  1. En la sección Operaciones del f6b6844bf5688982.png menú de navegación, haz clic en Monitoring > Explorador de métricas.

La sección Operaciones del menú de navegación muestra las opciones Monitoring y Metrics explorer seleccionadas.

  1. En el menú Tipo de recurso, selecciona API consumida como el tipo de métrica. (Si no la ves, anula la selección de la casilla de verificación Solo mostrar activos).

ca850c4295ef4ec9.png

  1. En el menú Métrica, selecciona una de las métricas individuales para las APIs, como Recuento de solicitudes, para ver cuántas APIs se llamaron en el período determinado.

El Explorador de métricas muestra las métricas de APIs consumidas para el recuento de solicitudes.

  1. Para personalizar aún más el resultado, establece un agregador y ajusta el período. El Explorador de métricas muestra las métricas de APIs consumidas para el recuento de solicitudes con un agregador y un período especificados.

4. Usa OAuth 2.0 Playground para probar APIs

También puedes usar OAuth 2.0 Playground para probar las APIs de Google. Con OAuth 2.0 Playground, puedes seleccionar una API, autorizarla y, luego, enviar solicitudes y ver las respuestas en la ventana de la consola de OAuth 2.0 Playground.

  1. Abre OAuth 2.0 Playground.

OAuth 2.0 Playground que muestra una lista de las APIs que puedes probar.

  1. Haz clic en Cloud Natural Language API > https://www.googleapis.com/auth/cloud-language > https://www.googleapis.com/auth/cloud-platform > Authorize APIs.

OAuth 2.0 Playground que muestra las APIs de Cloud Natural Language seleccionadas.

  1. Si es necesario, accede a tu Cuenta de Google y, luego, haz clic en Permitir para obtener un código de autorización.
  2. Haz clic en Intercambiar código de autorización para tokens.

Panel Exchange authorization code for tokens, desde el que puedes hacer clic en Exchange authorization code for tokens.

Ahora puedes realizar una solicitud a la API.

  1. Haz clic en Enumera operaciones posibles para examinar todas las posibles llamadas a la API.

Anteriormente, abriste la página de información del documento de la API de Natural Language analyzeEntities, por lo que puedes ver que la URL de la solicitud HTTP es la siguiente:

https://language.googleapis.com/v1beta2/documents:analyzeEntities

Esta es una solicitud POST.

Configura el panel de solicitud a la API, desde donde puedes seleccionar el método HTTP, registrar el URI de la solicitud, ingresar el cuerpo de la solicitud y enviarla.

  1. Ingresa la información del URI de la solicitud y agrega un cuerpo de la solicitud.

Puedes usar el mismo cuerpo que usaste en el Explorador de APIs.

Panel del cuerpo de la solicitud.

  1. Haz clic en Cerrar > Enviar la solicitud.

Deberías obtener resultados similares a los de esta imagen:

Panel de solicitud y respuesta de OAuth 2.0 después de publicar la solicitud.

No dudes en experimentar con otras APIs en OAuth 2.0 Playground.

5. Limpia

No se recomienda tener una clave de API sin restricciones para los proyectos. Si alguien obtiene acceso a ella, podrá usarla sin necesidad de autenticarse.

Para borrar esta clave de API, sigue estos pasos:

  1. Haz clic en f6b6844bf5688982.png Menú de navegación > APIs y servicios > Credenciales.
  2. En Claves de API, selecciona la clave que deseas borrar y, luego, haz clic en 247adf2e1d1eae4b.png.
  3. Del mismo modo, en lugar de preocuparte por que la clave privada de tu cuenta de servicio no esté protegida, en Cuentas de servicio, selecciona la cuenta de servicio que deseas borrar y, luego, haz clic en 247adf2e1d1eae4b.png.

6. Felicitaciones

¡Felicitaciones! Aprendiste a buscar y seleccionar APIs de Google, y a ver sus métricas.