Guide de démarrage rapide de Google Apps Script

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

Les guides de démarrage rapide expliquent comment configurer et exécuter une application qui appelle une API Google Workspace. 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 adaptés à votre application.

Dans Apps Script, les guides de démarrage rapide Google Workspace utilisent les services avancés de Google pour appeler les API Google Workspace et gérer certains détails du flux d'authentification et d'autorisation.

Objectifs

  • Configurer l'environnement
  • Créer et configurer le script
  • Exécuter le script

Prérequis

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

  • Accès à Google Drive

Créer le script

  1. Créez un script dans l'éditeur Apps Script en accédant à script.google.com/create.
  2. Remplacez le contenu de l'éditeur de script par le code suivant :

people/quickstart/quickstart.gs
/**
 * @typedef {Object} EmailAddress
 * @see https://developers.google.com/people/api/rest/v1/people#Person
 * @property {string} value
 * Note: This is a partial definition.
 */

/**
 * @typedef {Object} Name
 * @see https://developers.google.com/people/api/rest/v1/people#Person
 * @property {string} displayName
 * Note: This is a partial definition.
 */

/**
 * @typedef {Object} Person
 * @see https://developers.google.com/people/api/rest/v1/people#Person
 * @property {Name[]} names
 * @property {EmailAddress[]} [emailAddresses]
 * Note: This is a partial definition.
 */

/**
 * @typedef {Object} Connection
 * @see https://developers.google.com/people/api/rest/v1/people.connections/list
 * @property {Person[]} connections
 * Note: This is a partial definition.
 */

/**
 * Print the display name if available for 10 connections.
 */
function listConnectionNames() {
  // Use the People API to list the connections of the logged in user.
  // See: https://developers.google.com/people/api/rest/v1/people.connections/list
  if (!People || !People.People || !People.People.Connections) {
    throw new Error("People service not enabled.");
  }
  const connections = People.People.Connections.list("people/me", {
    pageSize: 10,
    personFields: "names,emailAddresses",
  });
  if (!connections.connections) {
    console.log("No connections found.");
    return;
  }
  for (const person of connections.connections) {
    if (
      person.names &&
      person.names.length > 0 &&
      person.names[0].displayName
    ) {
      console.log(person.names[0].displayName);
    } else {
      console.log("No display name found for connection.");
    }
  }
}

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

Configurer le script

Activer l'API People

Ouvrez le projet Apps Script.

  1. Cliquez sur Éditeur .
  2. À côté de Services, cliquez sur Ajouter un service .
  3. Sélectionnez API People , 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