Configura un proyecto de Apps Script

Configurar un proyecto de Apps Script para llamar a la API de Google Forms directamente a través de una llamada a REST es sencillo. Si ya configuraste un proyecto de Google Cloud, haz lo siguiente:

1. Crea un nuevo proyecto de Apps Script.
2. Cambia el número de proyecto de Google Cloud asociado para que coincida con el proyecto que habilitaste para la API de Formularios de Google.
3. Edita el archivo de manifiesto (appsscript.json) para agregar los permisos de OAuth necesarios.
4. Agrega código de Apps Script para recuperar un token de OAuth y realizar una llamada a REST con el token.

A continuación, se muestra una breve explicación de estos pasos.

Crea y configura un nuevo proyecto de Apps Script

1. Con el mismo ID de Google con el que configuraste tu proyecto de GCP, ve al Panel de Apps Script y, luego, haz clic en Nuevo proyecto.
2. Una vez que se abra el proyecto, haz clic en Configuración del proyecto.
3. Selecciona la casilla de verificación Mostrar el archivo de manifiesto "appsscript.json" en el editor.
4. En la sección Proyecto de Google Cloud Platform (GCP), haz clic en Cambiar proyecto y, luego, ingresa el número del proyecto de GCP que configuraste para la API de Forms.

Tu proyecto de Apps Script ahora está configurado para acceder a la API de Formularios de Google. El siguiente paso obligatorio es agregar los permisos de OAuth adecuados.

Agrega permisos de OAuth

Para generar un token de OAuth con el alcance adecuado en Apps Script, debes establecer los alcances requeridos en el archivo de manifiesto del proyecto.

1. En el editor, abre appsscript.json.

2. Agrega los permisos al cuerpo del manifiesto.

   Nota: Cada método de API tiene sus propios requisitos específicos de alcance de OAuth (ejemplo). Solo debes incluir los permisos para los métodos que usas. Por ejemplo, si solo planeas recuperar respuestas de formularios, solo necesitas forms.responses.readonly. El alcance de script.external_request es obligatorio para permitir que Apps Script llame a un servicio de REST externo.

   {
     ...
   "oauthScopes": [
       "https://www.googleapis.com/auth/script.external_request",
       "https://www.googleapis.com/auth/drive",
       "https://www.googleapis.com/auth/drive.readonly",
       "https://www.googleapis.com/auth/forms.body",
       "https://www.googleapis.com/auth/forms.body.readonly",
       "https://www.googleapis.com/auth/forms.responses.readonly"
     ],
    ...
    }
   

3. Haz clic en Save project y corrige los errores de sintaxis si es necesario. Ahora tu proyecto debería poder llamar a la API de Formularios de Google a través de una llamada a REST.

Agrega código de Apps Script para llamar a la API

Antes de escribir el código para llamar a un formulario, debes identificar un formulario de tu propiedad que tenga respuestas y anotar su ID. El ID del formulario se puede encontrar en la URL cuando editas el formulario:

https://docs.google.com/forms/d/<FORM_ID>/edit

Para llamar a la API, usarás una llamada UrlFetchApp de Apps Script.

1. Abre Code.gs y agrega el siguiente código:

   forms-api/snippets/retrieve_all_responses.gs

   Ver en GitHub
    function callFormsAPI() {
     console.log('Calling the Forms API!');
     const formId = '<YOUR_FORM_ID>';
   
     // Get OAuth Token
    const OAuthToken = ScriptApp.getOAuthToken();
    console.log('OAuth token is: ' + OAuthToken);
    const formsAPIUrl = 'https://forms.googleapis.com/v1/forms/' + formId + '/' + 'responses';
    console.log('formsAPIUrl is: ' + formsAPIUrl);
    const options = {
       'headers': {
         Authorization: 'Bearer ' + OAuthToken,
         Accept: 'application/json'
       },
       'method': 'get'
     };  
   const response = UrlFetchApp.fetch(formsAPIUrl, options);
    console.log('Response from forms.responses was: ' + response);
   }

2. Reemplaza YOUR_FORM_ID por el valor que anotaste antes.

   Ejemplo: var formId = 'tL5ygBC8zpbTnTp76JCZdIg80hA-cnpbTnTjnsewCKJH';

3. Haz clic en Save project y corrige los errores de sintaxis si es necesario.

Prueba el código

1. Haz clic en Ejecutar.
2. Autoriza el proyecto según sea necesario con el mismo ID de Google que antes.

Una vez que comience, deberías ver una respuesta en el Registro de ejecución similar a esta:

Execution started
Calling the Forms API!
OAuth token is: ya29.a0ARrdaM8IMjtlv…
formsAPIUrl is: https://forms.googleapis.com/v1beta/forms/…/responses
Response from Forms.responses was: {
"responses": [
    {
      "responseId":"...",
      "createTime": "2021-03-25T01:23:58.146Z",
      "lastSubmittedTime": "2021-03-25T01:23:58.146607Z",
      "answers": {
        "1e9b0ead": {
          "questionId": "1e9b0ead",
          "textAnswers": {
            "answers": [
              {
                "value": "Red"
              }
            ]
          }
        },
        "773ed8f3": {
          "questionId": "773ed8f3",
          "textAnswers": {
            "answers": [
              {
                "value": "Tesla"
              }
            ]
          }
        }
      }
    }
  ]
}
Execution completed

Próximos pasos

Una vez que hayas llamado correctamente a la API con Apps Script, consulta la documentación de referencia y experimenta con otras llamadas a la API.