Guide de démarrage rapide de Google Apps Script

Les guides de démarrage rapide expliquent comment configurer et exécuter une application qui appelle une API Google Workspace.

Les démarrages rapides Google Workspace utilisent les bibliothèques clientes de l'API pour gérer certains détails du flux d'authentification et d'autorisation. Nous vous recommandons d'utiliser les bibliothèques clientes pour vos propres applications. Ce guide de démarrage rapide utilise une approche d'authentification simplifiée adaptée à un environnement de test. Pour un environnement de production, nous vous recommandons de vous familiariser avec l'authentification et l'autorisation avant de choisir les identifiants d'accès appropriés pour votre application.

Créez un script Google Apps qui envoie des requêtes à l'API du SDK Admin.

Objectifs

  • Configurez l'environnement.
  • Créez et configurez le script.
  • Exécutez le script.

Prérequis

  • Un domaine Google Workspace avec l'accès à l'API activé.
  • Un compte Google dans ce domaine disposant de droits d'administrateur.

  • Accès à Google Drive

Créer le script

  1. Accédez à script.google.com/create pour créer un script.
  2. Remplacez le contenu de l'éditeur de script par le code suivant:

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
  };
  try {
    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) {
      console.log('%s: %s (%s)', activity.id.time, activity.actor.email,
          activity.events[0].name);
    }
  } catch (err) {
    // TODO (developer)- Handle exception from the Report  API
    console.log('Failed with error %s', err.message);
  }
}

  1. Cliquez sur Enregistrer .
  2. Cliquez sur Projet sans titre, saisissez Premiers pas, puis cliquez sur Renommer.

Configurer le script

Activer l'API SDK Admin

  1. Ouvrez le projet Apps Script.
  1. Cliquez sur Éditeur .
  2. À côté de Services, cliquez sur Ajouter un service  .
  3. Sélectionnez l'API Admin Reports, puis cliquez sur Ajouter.

Exécuter l'exemple

Dans l'éditeur Apps Script, cliquez sur Exécuter.

La première fois que vous exécutez l'exemple, vous êtes invité à autoriser l'accès:

  1. Cliquez sur Examiner les autorisations.
  2. Choisissez un compte.
  3. Cliquez sur Autoriser.

Le journal d'exécution du script s'affiche en bas de la fenêtre.

Étapes suivantes