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 guides de démarrage rapide Google Workspace utilisent les bibliothèques clientes des 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 renseigner sur l'authentification et l'autorisation avant de choisir les identifiants d'accès appropriés pour votre application.

Créer un Google Apps Script qui envoie des requêtes à l'API People

Objectifs

  • Créez le script.
  • Activez l'API People.
  • Exécutez l'exemple.

Prérequis

  • Un domaine Google Workspace pour lequel l'accès aux API est activé.
  • Un compte Google dans ce domaine avec des 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:

people/quickstart/quickstart.gs
/**
 * Print the display name if available for 10 connections.
 */
function listConnectionNames() {
  try {
    /**
     * List the 10 connections/contacts of user
     * @see https://developers.google.com/people/api/rest/v1/people.connections/list
     */
    const connections = People.People.Connections.list('people/me', {
      pageSize: 10,
      personFields: 'names,emailAddresses'
      // use other query parameter here if needed.
    });
    connections.connections.forEach((person) => {
      // if contacts/connections is available, print the name of person.
      if (person.names && person.names.length === 0) {
        console.log('No display name found for connection.');
        return;
      }
      console.log(person.names[0].displayName);
    });
  } catch (err) {
    // TODO (developer) - Handle exception from People API
    console.log('Failed with error %s', err.message);
  }
}

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

Activer l'API People

  1. Ouvrez le projet Apps Script.
  2. Cliquez sur Éditeur .
  3. À côté de Services, cliquez sur Ajouter un service .
  4. Sélectionnez l'API People et 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 au bas de la fenêtre.

Étapes suivantes