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 requiere algunos pasos. 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 Forms.
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.

Crea y configura un nuevo proyecto de Apps Script

1. Con la misma Cuenta de Google que usaste para configurar tu proyecto de Google Cloud, ve al Panel de Apps Script y, luego, haz clic en Proyecto nuevo.
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 (Google Cloud), haz clic en Cambiar proyecto y, luego, ingresa el número del proyecto de Google Cloud que configuraste para la API de Forms.

Tu proyecto de Apps Script ya está configurado para acceder a la API de Forms. 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 permisos para los métodos que uses. Por ejemplo, si solo planeas recuperar respuestas de formularios, solo necesitas forms.responses.readonly. El alcance script.external_request es necesario 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 Forms con una llamada de 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 la misma Cuenta 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.