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 Script qui envoie des requêtes à l'API Gmail.

Objectifs

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

Prérequis

  • Un compte Google pour lequel Gmail est activé

  • 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:

gmail/quickstart/quickstart.gs
/**
 * Lists all labels in the user's mailbox
 * @see https://developers.google.com/gmail/api/reference/rest/v1/users.labels/list
 */
function listLabels() {
  try {
    // Gmail.Users.Labels.list() API returns the list of all Labels in user's mailbox
    const response = Gmail.Users.Labels.list('me');
    if (!response || response.labels.length === 0) {
      // TODO (developer) - No labels are returned from the response
      console.log('No labels found.');
      return;
    }
    // Print the Labels that are available.
    console.log('Labels:');
    for (const label of response.labels ) {
      console.log('- %s', label.name);
    }
  } catch (err) {
    // TODO (developer) - Handle exception on Labels.list() API
    console.log('Labels.list() API failed with error %s', err.toString());
  }
}

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

Configurer le script

Activer l'API Gmail

  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 Gmail, 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