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 Google Chat.
Objectifs
- Configurer l'environnement
- Créez et configurez le script.
- Exécutez le script.
Prérequis
- 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 le configurer et vous ajouter en tant qu'utilisateur de test. Si vous avez déjà effectué ces étapes pour votre projet Cloud, passez à la section suivante.
Ouvrez votre projet Cloud dans la console Google Cloud.
Si ce n'est pas déjà fait, ouvrez le projet Cloud que vous prévoyez d'utiliser pour cet exemple:
- Dans la console Google Cloud, accédez à la page Sélectionner un projet.
- 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 ce 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.
Configurer l'écran d'autorisation OAuth
- Dans la console Google Cloud, accédez à Menu > > Branding.
- Si vous avez déjà configuré , vous pouvez configurer les paramètres suivants de l'écran d'autorisation OAuth dans Branding (Marquage), Audience (Audience) et Data Access (Accès aux données). Si le message Pas encore configuré s'affiche, cliquez sur Commencer:
- Sous Informations sur l'application, dans Nom de l'application, saisissez un nom pour l'application.
- Dans Adresse e-mail d'assistance utilisateur, choisissez une adresse e-mail d'assistance à laquelle les utilisateurs peuvent vous contacter s'ils ont des questions sur leur consentement.
- Cliquez sur Suivant.
- Sous Audience, sélectionnez Interne.
- Cliquez sur Suivant.
- Sous Coordonnées, saisissez une adresse e-mail à laquelle vous pourrez être informé de toute modification apportée à votre projet.
- Cliquez sur Suivant.
- Sous Terminer, consultez le Règlement sur les données utilisateur dans les services d'API Google et, si vous acceptez, sélectionnez J'accepte le Règlement sur les données utilisateur dans les services d'API Google.
- Cliquez sur Continuer.
- Cliquez sur Créer.
- Pour l'instant, vous pouvez ignorer l'ajout d'autorisations. À l'avenir, lorsque vous créerez une application à utiliser en dehors de votre organisation Google Workspace, vous devrez définir le type d'utilisateur sur Externe. Ajoutez ensuite les champs d'application d'autorisation dont votre application a besoin. Pour en savoir plus, consultez le guide complet Configurer le consentement OAuth.
Configurer l'application Google Chat
Pour appeler l'API Google Chat, vous devez configurer une application Google Chat. Pour toutes les requêtes d'écriture, Google Chat attribue l'application Google Chat dans l'UI à l'aide des informations suivantes.
Dans la console Google Cloud, accédez à la page Configuration de l'API Chat:
Sous Informations sur l'application, saisissez les informations suivantes:
- Dans le champ Nom de l'application, saisissez
Chat API quickstart app
. - Dans le champ URL de l'avatar, saisissez
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - Dans le champ Description, saisissez
Quickstart for calling the Chat API
.
- Dans le champ Nom de l'application, saisissez
Sous Fonctionnalités interactives, cliquez sur le bouton d'activation/de désactivation Activer les fonctionnalités interactives pour désactiver les fonctionnalités interactives de l'application Chat.
Cliquez sur Enregistrer.
Créer le script
- Accédez à script.google.com/create pour créer un script.
- Remplacez le contenu de l'éditeur de script par le code suivant:
- Cliquez sur Enregistrer
.
- Cliquez sur Projet sans titre, saisissez Premiers pas, puis cliquez sur Renommer.
Configurer le script
Copiez le numéro du projet Cloud
-
Dans la console Google Cloud, accédez à Menu > IAM et administration
> Paramètres.
Accéder à la page Paramètres de la section IAM et administration
- Dans le champ Numéro du projet, copiez la valeur.
Associer votre projet Google Cloud
- Ouvrez le projet Apps Script.
- Cliquez sur Paramètres du projet .
- Sous Projet Google Cloud Platform (GCP), cliquez sur Changer de projet.
- Dans Numéro de projet GCP, collez le numéro du projet Google Cloud.
- Cliquez sur Définir un projet.
Activer l'API Google Chat
- Ouvrez le projet Apps Script.
- Cliquez sur Paramètres du projet .
- Sous Paramètres généraux, activez Afficher le fichier manifeste "appsscript.json" dans l'éditeur.
- Cliquez sur Éditeur
appscript.json
, puis remplacez son contenu par le code suivant:
, sélectionnez le fichier
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:
- Cliquez sur Examiner les autorisations.
- Choisissez un compte.
- Cliquez sur Autoriser.
Le journal d'exécution du script s'affiche en bas de la fenêtre.