Guía de inicio rápido de Google Apps Script

Crea una secuencia de comandos de Google Apps Script que realice solicitudes a la API del SDK de Admin.

En las guías de inicio rápido, se explica cómo configurar y ejecutar una app que llama a una API de Google Workspace. En esta guía de inicio rápido, se usa un enfoque de autenticación simplificado que es adecuado para un entorno de pruebas. En el caso de un entorno de producción, te recomendamos que obtengas información sobre la autenticación y la autorización antes de elegir las credenciales de acceso adecuadas para tu app.

En Apps Script, las guías de inicio rápido de Google Workspace usan servicios avanzados de Google para llamar a las APIs de Google Workspace y controlar algunos detalles del flujo de autenticación y autorización.

Objetivos

  • Configurar el entorno
  • Crear y configurar la secuencia de comandos
  • Ejecutar la secuencia de comandos

Requisitos previos

  • Un dominio de Google Workspace con el acceso a la API habilitado.
  • Una Cuenta de Google en ese dominio con privilegios de administrador

  • Acceso a Google Drive

Crea la secuencia de comandos

  1. Para crear una secuencia de comandos nueva en el editor de Apps Script, ve a script.google.com/create.
  2. Reemplaza el contenido del editor de secuencias de comandos por el siguiente código:

adminSDK/reports/quickstart.gs
/**
 * List login events for a Google Workspace domain.
 * @see https://developers.google.com/admin-sdk/reports/reference/rest/v1/activities/list
 */
function listLogins() {
  const userKey = "all";
  const applicationName = "login";
  const optionalArgs = {
    maxResults: 10,
  };
  if (!AdminReports || !AdminReports.Activities) {
    throw new Error("Enable the AdminReports Advanced Service.");
  }
  const response = AdminReports.Activities.list(
    userKey,
    applicationName,
    optionalArgs,
  );
  const activities = response.items;
  if (!activities || activities.length === 0) {
    console.log("No logins found.");
    return;
  }
  // Print login events
  console.log("Logins:");
  for (const activity of activities) {
    if (
      activity.id?.time &&
      activity.actor?.email &&
      activity.events?.[0]?.name
    ) {
      console.log(
        "%s: %s (%s)",
        activity.id.time,
        activity.actor.email,
        activity.events[0].name,
      );
    }
  }
}

  1. Haz clic en Guardar .
  2. Haz clic en Proyecto sin título, escribe Guía de inicio rápido y haz clic en Cambiar nombre.

Configura la secuencia de comandos

Habilita la API del SDK de Admin

Abre el proyecto de Apps Script.

  1. Haz clic en Editor .
  2. Junto a Servicios, haz clic en Agregar un servicio .
  3. Selecciona la API del SDK de Admin y haz clic en Agregar.

Ejecuta la muestra

En el editor de Apps Script, haz clic en Ejecutar.

La primera vez que ejecutes la muestra, se te solicitará que autorices el acceso:

  1. Haz clic en Revisar permisos.
  2. Elige una cuenta.
  3. Haz clic en Permitir.

El registro de ejecución de la secuencia de comandos aparece en la parte inferior de la ventana.

Próximos pasos