Braulio (core)

Braulio es una aplicación web bastante modesta que facilita la gestión de cuentas G-Suite y, en particular:

• Las tareas de alta y baja de alumnos y profesores.

• La gestión de grupos necesarios:

  • Departamentos.
  • Tutores.
  • Grupos de alumnos.
  • Equipos educativos.

Por supuesto, esta gestión puede hacerse manualmente a través de la interfaz oficial, pero Braulio está diseñada para hacer éstas específicamente, así que automatiza o semiautomatiza muchas de ellas y ahorra tiempo y esfuerzo.

El repositorio no contiene implementación de interfaz web alguna, sólo contiene el código Javascript que conecta con las APIs de Google. Para ella, consulte braulio-app.

Preparación del dominio

Para poder utilizar la aplicación es preciso:

• En admin.google.com>Seguridad>Permisos de la API>Control de acceso de aplicaciones eliminar las restricciones a "Administrador de G-Suite".

• En la consola de desarrollador:

  • Crear un nuevo proyecto.

  • En la pantalla de consentimiento, hacer que el proyecto sea de tipo interno y darle un nombre.

  • Crear credenciales:

    1. Un identificador de cliente para una aplicación web (que será el clientId en nuestra aplicación).
    2. Una clave de API (que será la apiKey en nuestra aplicación).

  • Habilitar las APIs:

    1. Admin SDK, que permite manipular las cuentas de G-Suite.
    2. Groups Settings API, que permite definir cuál es el acceso a las cuentas de grupo. Por ejemplo, si es posible que una cuenta externa, escriba a un grupo de G-Suite.
    3. Drive API, que permite leer y escribir en el Drive del usuario. En este proyecto, es necesario para poder guardar la configuración de la aplicación.
    4. Gmail API, que permite el envío de mensajes.

Organización del dominio

Las cuentas del instituto se organizarán del siguiente modo:

1. Tres unidades organizativas:

   • Profesores, para profesores.
   • Alumnos. para alumnos.
   • Otros, para cuentas que no sean de profesores ni de alumnos (p.e. una cuenta para la biblioteca del centro).

2. Dos grandes grupos relacionados con estas unidades organizativas:

   • claustro, que incluirá todos los grupos que representan departamentos didácticos o de formación profesional (lo que indirectamente supondrá que contenga a todos los profesores).
   • alumnos, que incluirá todos los grupos de alumnos (lo que indirectamente supondrá que contenga a todos los alumnos).

3. Grupos que contienen usuarios:

   • Un grupo por cada departamento didáctico, cada uno de los cuales contendrá a los profesores de tal departamento.
   • Un grupo por cada conjunto de tutores que se estime oportuno. La interfaz dejará libertad para crear estos grupos y marcar a los profesores que formen parte e ellos. Existirá, además, un grupo tutores que contenga todo estos grupos.
   • Un grupo por cada grupo de alumnos, cada uno de los cuales contendrá a los alumnos de tal grupo.
   • Un grupo por cada equipo educativo, cada uno de los cuales contendrá a los profesores que imparten clase en el grupo de alumnos correspondiente.

4. Cuentas de usuario:

   • Una para cada profesor, cada una de las cuales deberá estar en un departamento.

   • Una para cada alumno, cada una de las cuales deberá estar en un grupo de alumnos.

   • Otras cuentas que servirán para cualquier propósito:

     • Servicios del instituto (Biblioteca, Secretaría).
     • Cargos (en caso de que se prefiera una cuenta nueva a crearle un alias al que desempeña el cargo).

---

Nota

Sería conveniente también formar grupos de alumnos para cada asignatura, porque permitiría formar los grupos de Classroom, pero eso exige disponer de un método sencillo para obtener esos datos de Séneca y no existe. Es probable que los institutos antes de volcar los datos en Séneca, creen los grupos con alguna otra herramienta (p.e. hojas de cálculo) que permita una exportación más sencilla; pero al ser métodos semimanuales y no estar normalizados, no hay forma de crear una herramienta universal de importación.

---

Uso

El código depende de gapi-client, el cual debe cargarse siempre a través de una etiqueta script, se use cualquiera de los dos métodos que se enuncian a continuación.

Directamente en el navegador

Descargue el código dist/braulio-core.js y al final de su página HTML coloque los elementos script:

   <script src="https://apis.google.com/js/api.js"></script>
   <script src="braulio-core.js"></script>
</html>

En su código Javascript podrá utilizar el cliente Braulio a través de la función Braulio:

window.onload = function(e) {
   const cliente = Braulio("config.json", {
      clientId: "###---CLIENT ID---###",
      apiKey: "###---API KEY---###",
      hosted_domain: "iesmiinstituto.com"
   });
   // etc...
}

Desarrollando con NodeJS

Instale la librería en su directorio de desarrollo:

$ npm install git+https://github.com/sio2sio2/graulio-core.git

En el código Javascript que está escribiendo, importe la función:

import Braulio from "braulio-core";

const cliente = Braulio("config.json", {
         clientId: "###---CLIENT ID---###",
         apiKey: "###---API KEY---###",
         hosted_domain: "iesmiinstituto.com"
      });

Recuerde que en el código HTML deberá incluir la carga de gapi:

   <script src="https://apis.google.com/js/api.js"></script>
</html>

Inicialización (guía rápida)

window.onload = function(e) {
   // Elemento sobre el que pinchamos para
   // autenticarnos o salirnos de la aplicación.
   const ingresar = document.getElementById("ingresar");

   // Creamos nuestro resolutivo mayordomo
   const mayordomo = Braulio("config.json", {
            clientId: "###---CLIENT ID---###",
            apiKey: "###---API KEY---###",
            hosted_domain: "iesmiinstituto.com"
         });

   // Al cargarse convenientemente el autenticador de Google,
   // dotamos de funcionalidad al botón.
   mayordomo.on("succeed", function(e) {
      ingresar.addEventListener("click", e => {
         if(e.target.textContent === "Entrar") mayordomo.signin();
         else mayordomo.signout();

      });
   }):

   // Pero si no se carga bien no hay nada que hacer.
   mayordomo.on("failed", function(e) {
      ingresar.addEventListener("click", funcion(e) {
         alert("IMPOSIBLE CARGAR EL MÓDULO DE AUTENTICACIÓN")
      });
   });

   // Nos hemos autenticado con éxito,
   // pero aún puede no estar disponible la configuración.
   mayordomo.on("signedin", function(e) {
      ingresar.textContent = "Salir";

      // Podríamos habilitar elementos de la interfaz que no
      // requirieran la información contenida en el fichero de configuración
   });

   // Se ha cargado ya la configuración
   mayordomo.on("onready", functioN(e) {
      // Cuando e.action es "get" llegamos al evento habiendo
      // cargado normalmente la configuración existente.
      if(e.action === "get") console.log("Configuración cargada");
      else console.log("Configuración generada y cargada");

      // Habilitamos la interfaz, pòrque ya está todo
      // preparado para poder gestionar G-Suite.
   }):

   // Si al autenticarnos nos encontramos con que
   // no hay configuración previa (p.e. la primera
   // ver que ejecutamos la aplicación). Antes de generar
   // una inicial se lanza este evento.
   mayordomo.on("noconfig", function(e) {
      console.log("No hay configuración");

      // Quizás queramos hacer algo, aunque no es obligatorio.
   });


   // Ya generada una configuración inicial, se lanza este evento.
   mayordomo.on("preconfig", function(e) {
      console.log(this.config.content);  // Aquí está la configuración inicial

      // Es probable que queramos modificar la configuración
      // añadiendo departamentos, etc. de forma interactiva.
      // ...

      // Una vez modificada la configuración, la aplicación estará lista.
      this.fire("onready", {action: "set"});
   });

   // Nos hemos autenticado con éxito,
   // pero aún puede no estar disponible la configuración.
   mayordomo.on("signedout", function(e) {
      ingresar.textContent = "Entrar";

      // Deshabilitamos los elementos de la interfaz
      // que nos permiten gestionar G-Suite
   });

   mayordomo.init();
}

Échele un ojo al ejemplo de uso.

API

Inicialización

La inicialización podemos dividirla en tres tareas:

• La creación del objeto mediante la función Braulio.

      const mayordomo = Braulio("config.json", {
               clientId: "###---CLIENT ID---###",
               apiKey: "###---API KEY---###",
               hosted_domain: "iesmiinstituto.com"
            });

  El primer parámetro define el nombre que se usará para el fichero de configuración almacenado en el Drive del usuario que se autentica. El segundo argumento define los parámetros usandos en el proceso de autentición con Google.

• La definición de las tareas relacionadas con la autenticación.

  La función anterior no crea más que el mayordomo, porque antes de hacer algo es necesario prescribir qué debe hacerse ante una autenticación, un error en la carga de la autenticación, etc. Para ello es necesario asignar acciones a los distintos eventos:

  Evento	Se dispara cuando....
  succeed	se inicializó con éxito.
  failed	error en la inicialización.
  signedin	se produjo la autenticación.
  noconfig	no hay configuración previa.
  preconfig	se acaba de generar una conf. inicial.
  configerror	no se completa correctamente la conf.
  onready	estamos listos para empezar,

  Existen, además, otros eventos no relacionados con la inicialización:

  Evento	Se dispara cuando....
  signedout	se ha completado desautenticación.
  savedconfig	se ha guardado la configuración,
  onreset	nos desvinculamos de la configuración.

  

• La inicialización propiamente dicha a través del método .init():

     mayordomo.init();

  Esto arrancará el proceso de inicialización y, dependiendo del caso, irá desencadenando los eventos correspondientes (razón por la cual debía estar definido qué hacerse antes de utilizar el método).

Autenticación

La autenticación tiene asociados dos métodos:

Método	Descripción
signin()	Arranca el proceso de autenticación.
signout()	Desconecta la aplicación,

Por ello, en el ejemplo de código propuesto en la guía rápida, asociamos estos dos métodos al botón que designamos para entrar y salir de la aplicación:

ingresar.addEventListener("click", e => {
   if(e.target.textContent === "Entrar") mayordomo.signin();
   else mayordomo.signout();
});

---

Nota

No obstante, si el usuario ya se encontraba autenticado (p.e. porque se había consultado previamente el correo de Gmail), esta autenticación será automática y no requerirá explícitmanete ejecutar el método.

---

Para cuando se completa el ingreso o la salida, hay dos eventos:

Evento	Se desencadena cuando...
signedin	... el usuario abre una sesión.
signedout	... el usuario sale de la sesión.

Es importante significar que completar con éxito la autenticación, no significa que estemos en disposición de gestionar G-Suite, ya que la aplicación necesita también leer el fichero de configuración. Esta es un acción que sólo puede realizarse tras la autenticación, por lo que al desencadenarse el evento onready, podemos estar seguros de que la aplicación ya está lista para que el usuario interactúe plenamente con ella.

Eventos

Ya se han enumerado todos los eventos reconocibles y cuándo se disparan. Es, sin embargo, pertinente profundizar en ellos.

Hay varios métodos relacionados con la manipulación de eventos:

Evento	Descripción
on(nombre, func)	Registra la función en el evento nombre.
once(nombre, func)	Registra la función para ejecutarse una sola vez.
off(nombre, func)	Cancela el registro de la función del evento nombre.
off(nombre)	Cancela todas las acciones asociadas al evento nombre.
fire(nombre, obj)	Dispara las funciones del evento nombre.

Un ejemplo de uso, lo tenemos recogido en el código inicial:

   // Se ha cargado ya la configuración
   mayordomo.on("onready", functioN(e) {
      if(e.action === "set") console.log("Configuración generada y cargada");
      else console.log("Configuración cargada");
   }):

Para todos los tipos de eventos el objeto e disponible en las funciones disparadas incluye:

Atributo	Descripción
type	Tipo de evento disparado (signedin, failed, etc).
target	El propio objeto mayordomo.

En algunos tipos, puede presentar algún atributo más. El evento onready añade:

Atributo	Descripción
action	Con valor get indica que se desencadena al leer la configuración guardada.

En el caso de .fire(), si se le proporciona como argumento un objeto adicional, los atributos de éste se añaden a los del objeto evento disponible en las funciones disparadas:

   mayordomo,fire("onready", {action: "set"});

Configuración

La aplicación necesita almacenar información adicional referente a:

• el grupo que representará al claustro y contendrá todos los departamentos didácticos.
• el grupo que representará a los alumnos y contendrá todos los grupos de clase.
• el grupo que incluya a todos los tutores.
• los puestos adcritos a los distintos departamentos didácticos. Por ejemplo, es necesario conocer que el profesor con puesto 10590006 pertenece al departamento de Matemáticas.

Para ello usa un fichero en formato JSON que se almacena en el directorio para datos de aplicaciones del Drive del usuario administrador y que tiene esta estructura:

{
   "contenedores": {
      "claustro": { "id": "### identificador del grupo ###" },
      "alumnos": {"id": "### identificador del grupo ###" },
      "tutores": {"id": "### identificador del grupo ###" },
   },
   "ou": {
      "claustro": { "orgUnitId": "### identificador de la ou ###" },
      "alumnos": { "orgUnitId": "### identificador de la ou ###" },
      "misc": { "orgUnitId": "### identificador de la ou ###" }
   },
   "esquemas": {
      "claustro": {
         "schemaId": "### Identificador del esquema ###"
      },
      "alumnos": {
         "schemaId": "### Identificador del esquema ###"
      }
   },
   "departamentos": [
      { 
         "id": "### Identificador del grupo de Filosofía ###",
         "puestos": [ "/[0-1][0-9]590001/" ]
      },
      {
         "id": "### Identificador del grupo de Lenguas Clásicas ###",
         "puestos": [ "00590002" , "00590003" ]
      }
   ],
   "oferta": [
      {
         "descripcion": "Enseñanza Secundaria Obligatoria",
         "nombre": "ESO",
         "abreviatura": "ESO"
      },
      {
         "descripcion": "Bachillerato",
         "nombre": "Bacbillerato",
         "abreviatura": "Bac"
      }
   ]
}

El fichero almacena identificadores para evitar que una manipulación manual de alguno de los nombres de grupo inutilice la aplicación. Al completarse con éxito la autenticación, se intenta cargar el fichero de configuración:

• Si lo encuentra, hará consultas para obtener los nombres, direcciones y descripciones, de los grupos y la ruta de las unidades organizativas y los campos de los esquema de usuario a partir de los identificadores almacenados. Una vez completada esta tarea se disparará el evento onready.
• Si no lo encuentra, disparará el evento noconfig, generará un fichero de configuración predeterminado y disparará el evento preconfig, útil por si se quiere habilitar que el usuario pueda modificar ese fichero predefinido.

Además incluye la relación de enseñanzas que oferta el instituto que se usa como base para denominar los nombres de grupos: [Nivel][Abreviatura]-[Letra] (p.e. 1ESO-A o 2Bac-C). La aplicación debería habilitar un mecanismo para añadir más enseñanzas.

mayordomo.on("noconfig", function(e) {
    // Aquí podemos incluir algún aviso de que no hay configuració inicial
});

mayordomo.on("preconfig", function(e) {
    // En este punto ya se ha generado el fichero predefinido y podemos
    // habilitar algún mecanismo interactivo para que el usuario lo altere.
    // Después de los cambios, lo lógico es que nosotros mismo forcemos
    // el evento "onready":

    this.fire("onready", {action: "set"});
});

 meyordomo.on("onready", function(e) {
    if(e.action === "get") console.log("Configuración cargada");
    else console.log("Configuración generada correctamente");

    // Ahora podemos habilitar por completo la interfaz.
 });

Por otra parte, el mayordomo dispone del atributo config que es un objeto con algunos atributos y métodos útiles:

Atributos	Descripción
config.content	Objeto con la configuración.
config.id	Identificador del fichero de configuración.
config.status	Devuelve el estado: PRECONFIG, READY.
config.obtenerDpto(dpto)	Devuelve la info del dpto.
config.set(content, merge)	Guarda una nueva configuración.
config.merge(adicional)	Añade configuración adicional.
config.remove()	Elimina la configuración.

Es importante tener presente cinco cosas:

1. Una configuración completa tendrá estado READY; mientras que una configuración que se está áun generando tendrá estado PRECONFIG.

2. El método config.obtenerDpto(dpto) devuelve la información completa del departmanto contenida en la configuración. Para ello es necesario suministrar:

   • O una cadena con el identificador del grupo o su dirección de correo:

     const matematicas = mayordomo.config.obtenerDpto("matematicas@miinstituto.com");

   • O un objeto de la forma {puesto: "CODIGO-PUESTO"} para obtener el departamento a través de un puesto de desempeño:

     const matematicas = mayordomo.config.obtenerDpto({puesto : "10590006"});

3. config.merge(adicional) mezcla la configuración actual (accesible a través de config.content con la proporcionada como argumento). Al mezclar los departamentos, el método es inteligente y sólo mezcla información de un mismo departamento. Para borrar un departamento, basta con poner su identificador a null. Por ejemplo, esto:

      config.merge({
        // El resto de propiedades quedará igual, pues no indicamos nada.
         departamentos: [
            {
              id: null,
              email: "lengua@miinstituto.com"
            }
         ]
      });

   borrará el departamento de lengua de la configuración (que no de G-Suite). El método identifica los departamento con su dirección de correo, por lo que para que funcione es necesario que todos la tengan expresa.

4. config.set() guarda la configuración en el Drive:

   • Si no se le proporciona nada, guardará el propio contenido de la configuración (config.content).

   • Si se le proporciona contenido, y el argumento merge se evalúa a falso, éste sustituirá totalmente al que ya haya (el que se puede consultar con config.content).

   • Si se le proporciona contenido y el argumento merge se evalúa a verdadero, se mezcla este contenido con el ya existente. Por tanto, es equivalente a:

     
        nayordomo.config.merge(content);  // Mezcla.
        mayordomo.config.set();           // Guarda en disco.
     
     

5. config.remove() elimina exclusivamente el fichero de configuración, pero no los grupos o las unidades organizativas declaradas en tal fichero. Si se desea eliminar esa estructura habrá de llevarlo acabo de forma independiente.

Manipulación

Los métodos de manipulación de las cuentas de G-Suite se encuentra dentro del objeto mayordomo.api. En principio, hay cuatro entidades de alto nivel que serán las que tengamos principalmente que utilizar en una ulterior aplicación:

• Profesores.
• Departamentos.
• Alumnos.
• Grupos de clase.

con meodos y atributos, algunos de los cuales comparten. Esto se debe a que internamente heredan de clases de más bajo nivel según el esquema:

Describiremos desde la base hasta las cuatro entidades terminales para exponer primero los métodos comunes e ir gradualmente introduciendo las particularidades de cada entidad.

Manipulación a bajo nivel

EntidadBase define los siguientes métodos:

Métodos	Descripción
crear(entidad)	Crea la entidad.
actualizar(entidad)	Actualiza la entidad.
borrar(id)	Borra la entidad con el ID suministrado.
operar(entidad)	Crea, actualiza o borra la entidad.
obtener(id, params)	Obtiene la entidad del ID suministrado.

SEGUIR...

Manipulación a alto nivel

Podemos manipular profesores, departamentos, alumnos y grupos (de clase) directamente a través de los objetos:

Objetos	Descripción
api.profesor	Métodos de manipulación de profesores.
api.dpto	Métodos de manipulación de departamentos.
api.alumno	Métodos de manipulación de alumnos.
api.clase	Métodos de manipulación de grupos de clase.

Estas cuatro entidades disponen todas ellas de métodos para:

• crearlas (crear)
• modificarlas (actualizar)
• borrarlas (borrar)
• obtener la información de una de ellas (obtener)
• listar todas las disponibles (listar).

Además, disponen del método operar que realiza la operación de crear, actualizar o borrar dependiendo de cómo pasemos su argumento. Lo trataremos en profundidad al analizar las cuatro a continuación, aunque los aspectos generales de estos módulos comunes se analizarán con la primera de ellas.

Profesores

Un profesor tiene particularidades que obligan a sus métodos a realizar trabajo extra:

• Desempeñan un puesto, lo cual les hace pertenecer indefectiblemente a un departamento.
• Pueden ser tutores de algún curso.
• Pueden ser jefes de departamento.
• Pueden estar de baja y ser sustituidos por otro profesor.
• Pueden disponer de una o varias taquillas.
• Pueden haber cesado en su puesto, pero seguir operativa la cuenta.

Por ello, se ha definido un esquema de usuario con los siguientes campos:

1. puesto cuyo valor es el código del puesto de desempeño.
2. tutoria con la denominación del grupo de clase del que es tutor (p.e. 2ESO-A).
3. cese cuyo valor es la fecha de cese. Todo profesor cuya fecha de cese sea anterior o igual a la del día actual, se considera cesado.
4. sustituto cuyo valor será el identificador de la cuenta de profesor que lo sustituya. Si su valor es 0, el profesor no tiene sustituto.
5. jefe, que será verdadero, si el profesor es el jefe de su departamento.
6. taquilla que es un array que contiene los códigos de las taquillas asignadas.

Aunque los campos forman parte del esquema profesor y pueden manipilarse como tales, puede modificarse de modo más sencillo.

Para manipular profesores los métodos disponibles son los siguientes:

Métodos	Descripción
profesor.listar(args)	Lista todos los profesores.
profesor.obtener(id)	Obtiene la información de un profesor
profesor.crear(info)	Crea un nuevo profesor.
profesor.actualizar(info)	Actualiza un profesor.
profesor.borrar(id)	Borra un profesor.
profesor.operar(info)	Crea, actualiza o borrar según el caso.
profesor.cesar(id, fecha)	Cesa un profesor.
profesor.sustituir(sustituto, sustituido)	Crea un sustituto.
profesor.obtenerCampo(nombre, profesor)	Devuelve el grupo de dpto asociado al puesto.
profesor.grupos(id)	Lista los grupos a los que pertenece un profesor.

profesor.listar(args) devuelve un objeto thenable con la lista de profesores. El argumento permite afinar la búsqueda añadiendo parámetros a la búsqueda. Algunos, sin embargo, se aplican por defecto, como la proyección para ver los campos propios del profesor. o limitar la búsqueda a la unidad organizativa a la que pertenecen los profesores. A los parámetros estándar añade:

• cesado que es un atajo para mostrar los profesores que han cesado.

• activo, que es un atajo para mostrar los profesores en activo, esto es, aquellos que ni han sido sustituidos ni han cesado.

• jefe, con valor true, muestra sólo aquellos profesores que son jefes de departamento. Si el valor es el identificador o la dirección de un departamento, entonces sólo mostrará la lista de jefes de ese departmento (en principio único, que puede haber varios si un jefe ha sido sustituido, ya que el sustituto hereda la condición de jefe de departamento).

let request = mayordomo.api.profesor.listar({cesado: true});
request.then(cesados => {
   console.log("DEBUG", cesados);  // Array de profesores cesados.
});

request = mayordomo.api.profesor.listar({activo: true});
request.then(activos => {
   console.log("DEBUG", activos);  // Array de profesores activos
});

Además, la petición se comporta también como un iterable asíncrono, por lo que dentro de una función asíncrona puede obtenerse la lista del siguiente modo:

for await(const cesado of request) {
   console.log("DEBUG", cesado);
}

SEGUIR...

Departamentos

Alumnos

Grupos de clase

Procesamiento por lotes

Para llevar a cabo varias acciones en serie (p.e. dar de alta una lista de profesores) es muy conveniente usar:

Clase	Descripción
Batch	Procesar en conjunto de varias peticiones.

que se encargará no solo de ejecutarlas, sino también de espaciar mínimamente la petición para evitar alcanzar los límites dispuestos por Google.

Para comenzar el procesamiento de varias peticiones debe crearse un objeto:

const batch = new mayordomo.api.Batch();

El objeto es un Thenable que dispone de algunos métodos:

Métodos	Descripción
add(item, params)	Añade una petición al procesamiento.
then(callback)	Método típo de los objetos thenables.

El método add() permite añadir una nueva petición al procesamiento, para lo cual es necesario proporcionar dos argumentos: el segundo sirve para facilitar un identificador (id) a la petición o indicar una función de formateo (formatter), que modifique la respuesta de la petición. Sin embargo, Las peticiones ya definidas en la librería definen ya un identificador y una función de formaceo apropiada, por lo que podemos prencindir de la inclusión de estos parámentros:

   batch.add(mayordomo.api.profesor.borrar("profesor1"));

Cuando se han añadido todas las peticiones que se quieren llevar a cabo en bloque, hay dos alternativas para recuperar los resultados de tales peticiones:

1. Haciendo uso de la interfaz Thenable que presenta el objeto, o sea, así:

      batch.then(resultados => {
         console.log(resultados);
      });

   o, si estamos dentro de una función asíncrona:

      const resultados = await batch.end();
      console.log(resultados);

   El objeto resultados estará disponible sólo cuando se hayan completado todas las peticiones que componen el procesamiento. Las claves de este objeto de resultados son los identificadores de cada petición y los valores un objeto que describe individualmente el resultado de la petición correspondiente. Más adelante, describiremos dicho objeto.

2. Utiliando el objeto como un iterador asíncrono:

      for await (const [id, resultado] of batch) {
         console.log(`ID: ${id} -- RES: ${resultado}`);
      }

   La diferencia fundamental con respecto al método anterior, más allá de la formal, es que se irán obteniendo los resultados según vayan estando disponibles, en vez de tener que esperar a que se completen todas las peticiones.

El objeto de resultado para cada petición tiene la siguiente forma:

{
   value: { usuario o grupo },
   operacion: "actualizar", // o "crear" o "borrar", etc.
   error: {
      code: CODIGO_NUMERICO,
      raw: { objeto de error proporcionado por google }
   }
}

aunque value sólo estará disponible cuando la petición haya tenido éxito (salvo al borrar en cuyo caso el valor es false); y error, cuando este no haya tenido lugar, tendrá código 0 y no dispondrá del atributo raw.

Accedamos como accedamos a los resultados, podremos volver a consultar éstos, pero seremos incapaces de añadir nuevas peticiones a través del objeto add().