Como llamar a una API con Google Apps Script

En muchas ocasiones nos puede hacer falta conectarnos a una API con Google Apps Script para obtener datos o para informar de algo que pase en nuestros spreadsheets a un servicio de terceros.

La forma de hacerlo es mediante una llamada a UrlFetchApp. Esto que os explicaré no es fácil pero su potencia es inacabable. Podréis conectaros a Jira, Trello, o cualquier servicio que se os ocurra abriendo todo un mundo para vuestras aplicaciones hechas con Google Apps Script.

Aquí os dejo un ejemplo:

function GetAPIData(parametro)
{
    var api = "aqui_va_el_endpoint_de_la_api";  // API URL
 
    //Esto son solo ejemplos. Cada API tendra sus variables de header que tendreis que verlo en su documentación
    var headers = {
      "user_key" : "api_key",
      "Content-Type" : "application/json",
    };

   //Esto son solo ejemplos. Cada API define su payload en la documentación
    var payload =
    { 
       'value_to_search': value,
       'date' : 'today'
    }
 
    var options =
    {
      'headers': headers,
      'method' : "POST",
      'payload' : JSON.stringify(payload)
    };

    var response = UrlFetchApp.fetch(api, options);

    //Generalmente las APIs devuelven JSON aunque podrían devolver otras cosas
    var json = JSON.parse(response.getContentText());
    return json;
}

El tema tiene su miga y su complejidad. No dudéis en hacerme llegar vuestros problemas.

Espero que os sirva

Nos vemos