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 un API Google Workspace.

Les guides de démarrage rapide de Google Workspace utilisent les bibliothèques clientes des API pour gérer certaines les détails du flux d'authentification et d'autorisation. Nous vous recommandons vous utilisez les bibliothèques clientes pour vos propres applications. Ce guide de démarrage rapide utilise d'authentification simplifiée, adaptée à un test environnement. Pour un environnement de production, nous vous recommandons de vous familiariser authentification et autorisation avant Choisir les identifiants d'accès adaptés à votre application.

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

Objectifs

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

Prérequis

• Un projet Google Cloud.

• Un compte Google Workspace Business ou Enterprise ayant accès à Google Chat.

Configurer votre projet Cloud

Si vous utilisez un nouveau projet Google Cloud pour suivre ce guide de démarrage rapide, vous devez la configurer et vous ajouter en tant qu'utilisateur test. Si vous avez déjà que vous avez réalisé ces étapes pour votre projet Cloud, passez à la section suivante.

Ouvrir votre projet Cloud dans la console Google Cloud

S'il n'est pas déjà ouvert, ouvrez le projet Cloud que vous prévoyez d'utiliser. pour cet exemple:

1. Dans la console Google Cloud, accédez à la page Sélectionner un projet.

   Sélectionner un projet Cloud

2. Sélectionnez le projet Google Cloud que vous souhaitez utiliser. Vous pouvez également cliquer sur Créer un projet et suivre les instructions à l'écran. Si vous créez un projet Google Cloud, vous devrez peut-être activer la facturation pour le projet.

Activer l'API Chat

Avant d'utiliser les API Google, vous devez les activer dans un projet Google Cloud. Vous pouvez activer une ou plusieurs API dans un même projet Google Cloud.

• Dans la console Google Cloud, activez l'API Google Chat.

  Activer l'API

Configurer l'écran de consentement OAuth

1. Dans la console Google Cloud, accédez au menu . > API et Services > Écran de consentement OAuth.

   Accéder à l'écran de consentement OAuth

2. Pour Type d'utilisateur, sélectionnez Interne, puis cliquez sur Créer.
3. Remplissez le formulaire d'inscription de l'application, puis cliquez sur Enregistrer et continuer.

4. Pour l'instant, vous pouvez ignorer l'ajout de champs d'application et cliquer sur Enregistrer et continuer. Par la suite, lorsque vous créerez une application à utiliser en dehors de votre d'une organisation Google Workspace, vous devez remplacer le Type d'utilisateur par Externe, puis : ajouter les niveaux d'autorisation requis par votre application.

5. Consultez le récapitulatif d'enregistrement de votre application. Pour apporter des modifications, cliquez sur Modifier. Si l'application l'inscription vous semble correcte, cliquez sur Retour au tableau de bord.

Configurer l'application Google Chat

Pour appeler l'API Google Chat, vous devez configurer un Application Google Chat. Pour les requêtes d'écriture, Google Chat attribue l'application Google Chat dans l'UI en utilisant les informations suivantes.

1. Dans la console Google Cloud, accédez à la page Configuration de l'API Chat:

   Accéder à la page "Configuration de l'API Chat"

2. Sous Application info (Informations sur l'application), saisissez les informations suivantes:

   1. Dans le champ App name (Nom de l'application), saisissez Chat API quickstart app.
   2. Dans le champ URL de l'avatar, saisissez https://developers.google.com/chat/images/quickstart-app-avatar.png
   3. Dans le champ Description, saisissez Quickstart for calling the Chat API.

3. Sous Fonctionnalités interactives, cliquez sur Activer les fonctionnalités interactives. désactivez les fonctionnalités interactives pour Application Chat

4. Cliquez sur Enregistrer.

Créer le script

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

chat/quickstart/Code.gs

Afficher sur GitHub

/**
 * This quickstart sample shows how to list spaces with user credential
 *
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.spaces.readonly'
 * referenced in the manifest file (appsscript.json).
 */
function listSpaces() {
  // Initialize request argument(s)
  // Filter spaces by space type (SPACE or GROUP_CHAT or DIRECT_MESSAGE)
  const filter = 'space_type = "SPACE"';

  // Iterate through the response pages using page tokens
  let responsePage;
  let pageToken = null;
  do {
    // Request response pages
    responsePage = Chat.Spaces.list({
      filter: filter,
      pageToken: pageToken
    });
    // Handle response pages
    if (responsePage.spaces) {
      responsePage.spaces.forEach((space) => console.log(space));
    }
    // Update the page token to the next one
    pageToken = responsePage.nextPageToken;
  } while (pageToken);
}

3. Cliquez sur Enregistrer .
4. Cliquez sur Projet sans titre, puis saisissez Guide de démarrage rapide, puis cliquez sur Renommer.

Configurer le script

Copier le numéro du projet Cloud

1. Dans la console Google Cloud, accédez au menu . > IAM et Administrateur > Paramètres.

   Accéder à la page Paramètres de la section IAM et administration

2. Dans le champ Numéro du projet, copiez la valeur.

Associer votre projet Google Cloud

1. Ouvrez le projet Apps Script.
2. Cliquez sur Paramètres du projet .
3. Sous Projet Google Cloud Platform (GCP), cliquez sur Changer de projet.
4. Dans Numéro de projet GCP, collez le numéro de projet Google Cloud.
5. Cliquez sur Définir un projet.

Activer l'API Google Chat

1. Ouvrez le projet Apps Script.

1. Cliquez sur Paramètres du projet .
2. Sous Paramètres généraux, activez l'option Afficher "appsscript.json" fichier manifeste dans l'éditeur.
3. Cliquez sur Éditeur , puis sélectionnez appscript.json et remplacez le contenu par le code suivant:

chat/quickstart/appsscript.json

Afficher sur GitHub

{
  "timeZone": "America/New_York",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.spaces.readonly"
  ],
  "chat": {},
  "dependencies": {
    "enabledAdvancedServices": [{
      "userSymbol": "Chat",
      "version": "v1",
      "serviceId": "chat"
    }]
  }
}

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.

<ph type="x-smartling-placeholder">

</ph> Ça a marché !

Parfait ! Pour en savoir plus, consultez la section de lecture complémentaire ci-dessous.

Un problème est survenu.

Dommage, décrivez-nous le problème rencontré. Consultez notre dépannage ci-dessous pour connaître les erreurs courantes et leurs solutions. Si vous avez trouvé un bug dans le code, <ph type="x-smartling-placeholder"></ph> signalez le problème sur GitHub ou envoyez une demande d'extraction.

Étapes suivantes

• Documentation sur les services avancés de Google Apps Script