Llamar a las API de Google mediante OAuth 2.0 en Make

El módulo HTTP > Make a request puede enviar solicitudes a una API de Google mediante una conexión OAuth 2.0. La configuración tiene tres partes: preparar el proyecto en Google Cloud, autorizar la conexión en Make y definir la solicitud HTTP.

Antes de empezar, identifica en la documentación de la API de Google el endpoint, el método, los ámbitos de autorización y el cuerpo que requiere la operación. Solicita solo los ámbitos necesarios. Las pantallas de Google Cloud y Make pueden cambiar, por lo que conviene comparar cada paso con la fuente oficial de Make y con la documentación de la API elegida.

1. Preparar el proyecto de Google Cloud

1. Accede a Google Cloud Console y crea o selecciona un proyecto.
2. Abre APIs & Services > Library.
3. Busca la API que vas a utilizar y habilítala.
4. Abre la configuración de consentimiento OAuth y completa la información de la aplicación.
5. Define la audiencia según tu caso. Si el proyecto permanece en pruebas, añade las cuentas que podrán autorizarlo como usuarios de prueba.
6. En la sección de marca, revisa los dominios autorizados que indica la guía oficial de Make.

La publicación, la verificación y el acceso de usuarios dependen de la política vigente de Google y del tipo de datos solicitado. No publiques una aplicación ni amplíes su audiencia sin revisar primero esas condiciones.

2. Crear las credenciales OAuth

En Google Cloud, crea un cliente OAuth de tipo Web application. Añade como URI de redirección autorizada la dirección que especifica actualmente Make para este módulo:

https://www.integromat.com/oauth/cb/oauth2

Después de crear el cliente, Google mostrará un identificador y un secreto de cliente. Guarda ambos en un gestor seguro y utilízalos únicamente en la conexión correspondiente. No los pegues en documentación, repositorios, capturas ni mensajes.

3. Establecer la conexión en Make

1. Crea o abre un escenario y añade HTTP > Make a request.
2. En Authentication type, selecciona OAuth 2.0.
3. Crea una conexión nueva y elige el flujo Authorization Code.
4. Usa como URI de autorización https://accounts.google.com/o/oauth2/v2/auth.
5. Usa como URI de token https://oauth2.googleapis.com/token.
6. Añade los ámbitos exigidos por la operación. Si incluyes varios, selecciona el separador SPACE según la guía oficial.
7. Introduce el identificador y el secreto del cliente en sus campos respectivos.
8. Si necesitas acceso sin una autorización interactiva en cada ejecución, revisa los parámetros access_type=offline y prompt=consent que documenta Make.
9. Guarda la conexión y completa el consentimiento de Google con la cuenta autorizada.

No copies ámbitos de otro ejemplo sin comprobarlos. Una solicitud de Google Sheets, Google Drive o cualquier otro servicio puede exigir permisos distintos. El Google APIs Explorer y la documentación de cada servicio indican los valores aplicables.

4. Configurar la solicitud HTTP

Define el módulo a partir de la documentación del endpoint:

• URL: endpoint completo de la API.
• Method: método HTTP requerido, como GET, POST, PATCH o DELETE.
• Headers y Query: solo los parámetros que exija la operación.
• Body content type: normalmente application/json cuando la API recibe JSON.
• Body: estructura válida con los campos permitidos por el endpoint.

Por ejemplo, la fuente oficial muestra una solicitud POST a https://sheets.googleapis.com/v4/spreadsheets para crear una hoja de cálculo. Un cuerpo reducido puede tener esta forma:

{
  "properties": {
    "title": "Hoja creada desde Make"
  },
  "sheets": [
    {
      "properties": {
        "title": "Datos iniciales"
      }
    }
  ]
}

Usa datos de prueba y una cuenta sin información crítica durante la primera ejecución. Revisa tanto la respuesta del módulo como el recurso creado o modificado en Google.

Solución de problemas

Si la autorización falla, comprueba en este orden:

1. La API necesaria está habilitada en el proyecto correcto.
2. La cuenta está autorizada por la audiencia o figura como usuario de prueba.
3. La URI de redirección coincide exactamente con la indicada por Make.
4. El identificador y el secreto pertenecen al mismo cliente OAuth.
5. Las URI de autorización y token no contienen espacios ni cambios.
6. Los ámbitos corresponden al endpoint y usan el separador correcto.
7. La conexión de Make se autorizó con la cuenta que tiene acceso al recurso.
8. El método, la URL, los parámetros y el cuerpo cumplen la documentación de la API.

Los mensajes de consentimiento, verificación y publicación son responsabilidad de Google y pueden variar. Si una pantalla no coincide con esta explicación, detén la configuración y sigue la documentación oficial de Make sobre OAuth 2.0 para las API de Google junto con la documentación actual de Google.