Une fois que vous avez créé une application de chat, vous pouvez la publier afin qu'elle soit accessible à certains utilisateurs ou groupes, à tous les membres de votre organisation Google Workspace, ou à tout utilisateur de Google Chat disposant d'un compte Google Workspace.
Comment les utilisateurs découvrent et utilisent les applications Google Chat
Les utilisateurs peuvent découvrir et utiliser des applications de différentes manières:
- Rechercher des applications dans Google Chat
- Interagir avec une application qui a été ajoutée à un espace Chat
- Découvrir l'application dans son panneau "Messages privés" après qu'un administrateur Google Workspace l'a installée en son nom.
Pour commencer à utiliser une application, les utilisateurs de Google Chat peuvent lui envoyer un message privé ou l'ajouter à un espace en le sélectionnant dans la liste des destinataires proposée, comme indiqué ci-dessous:
Les utilisateurs peuvent également affiner la liste des destinataires proposée en @mentionnant le nom de l'application. Par exemple, si vous publiez une application appelée "Scheduler Bot" et qu'un utilisateur de votre organisation saisit "@sch", Google Chat suggère votre application comme option de saisie semi-automatique.
Les administrateurs Google Workspace peuvent également trouver des applications de chat sur Google Workspace Marketplace et les installer pour les utilisateurs de leur organisation. Lorsque les administrateurs installent une application de chat, elle apparaît dans le panneau des messages privés des utilisateurs.
Les administrateurs Google Workspace peuvent également gérer et ajouter à la liste d'autorisation l'utilisation des applications de chat dans leur organisation Google Workspace. Si vous développez une application de chat pour une organisation qui utilise des listes d'autorisation, vous devez demander à un administrateur d'ajouter votre application Chat à la liste d'autorisation pour que les utilisateurs puissent la trouver et l'utiliser. Pour en savoir plus, consultez Autoriser les utilisateurs à installer des applications de chat dans la documentation d'aide pour les administrateurs Google Workspace.
Configurer et publier votre application Chat à l'aide de la console Google Cloud
Pour publier votre application Chat et la rendre disponible pour d'autres personnes, procédez comme suit:
- Activer et configurer l'API Google Chat Lorsque vous configurez l'API, vous autorisez les autres utilisateurs de Google Chat à accéder à votre application Chat à des fins de test.
- Publiez votre application avec le SDK Google Workspace Marketplace. Vous pouvez configurer votre application de chat pour qu'elle soit mise à la disposition des utilisateurs de votre organisation Google Workspace ou de tous les utilisateurs de Google Chat.
- Si votre organisation Google Workspace gère l'accès aux applications de chat, demandez à votre administrateur Google Workspace d'ajouter l'application à la liste d'autorisation de l'organisation.
Paramètres de visibilité et de publication de l'application Chat
Le tableau suivant explique comment configurer les paramètres de l'API Google Chat et du SDK Google Workspace Marketplace en fonction de l'audience de votre application Chat:
. . . .| Je suis en train de créer une application de chat... | Méthode d'authentification | Paramètres de l'API Google Chat | Paramètres du SDK Google Workspace Marketplace | Où mon application Chat est-elle publiée ? |
|---|---|---|---|---|
| ...Pour ma petite équipe | Authentifiez-vous en tant qu'utilisateur ou en tant qu'application. | Dans le paramètre Visibilité, spécifiez les personnes et/ou les groupes Google qui peuvent accéder à l'application.
Si votre compte Google Workspace nécessite que les applications soient ajoutées à la liste d'autorisation, vous ne pouvez spécifier que 5 adresses e-mail individuelles au maximum (vous ne pouvez pas spécifier de groupes Google). |
Vous n'avez pas besoin de configurer le SDK Google Workspace Marketplace pour votre application de chat. | Les membres d'équipe peuvent rechercher et utiliser votre application de chat à partir de Google Chat. |
| ...Pour mon équipe nombreuse | Authentifiez-vous en tant qu'utilisateur ou en tant qu'application. | Dans le paramètre Visibilité, spécifiez des personnes et/ou des groupes Google pour tester votre application de chat.
Une fois les tests effectués, publiez votre application Chat dans votre organisation Google Workspace à l'aide des paramètres du SDK Google Workspace Marketplace. |
Définissez Visibilité de l'application sur Privée. Définissez Paramètres d'installation sur Particulier + Administrateur. Si votre compte Google Workspace nécessite que les applications soient ajoutées à la liste d'autorisation, demandez à un administrateur d'ajouter votre application Chat à la liste d'autorisation pour que les utilisateurs puissent la trouver et l'utiliser. Pour en savoir plus, consultez Autoriser les utilisateurs à installer des applications de chat dans la documentation d'aide pour les administrateurs Google Workspace. |
Tous les membres de votre organisation Google Workspace peuvent rechercher et installer votre application Chat dans Google Chat, et la consulter dans Google Workspace Marketplace. Les utilisateurs et les administrateurs Google Workspace peuvent installer votre application à partir de Marketplace. |
| ...Pour mon organisation Google Workspace | Authentifiez-vous en tant qu'utilisateur ou en tant qu'application. | Dans le paramètre Visibilité, spécifiez des personnes et/ou des groupes Google pour tester votre application de chat.
Une fois les tests effectués, publiez votre application Chat dans votre organisation Google Workspace à l'aide des paramètres du SDK Google Workspace Marketplace. |
Définissez Visibilité de l'application sur Privée. Définissez Paramètres d'installation sur Particulier + Administrateur. |
Tous les membres de votre organisation Google Workspace peuvent rechercher et installer votre application Chat dans Google Chat, et la consulter dans Google Workspace Marketplace. Seuls les administrateurs Google Workspace peuvent installer votre application à partir de Marketplace. |
| ...pour tous (application de chat publique) | Authentifiez-vous en tant qu'application. | Dans le paramètre Visibilité, spécifiez des personnes et/ou des groupes Google pour tester votre application de chat.
Après le test, publiez votre application Chat en mode public dans les paramètres de Google Workspace Marketplace. |
Définissez Visibilité de l'application sur Public. Définissez Paramètres d'installation sur Particulier + Administrateur. |
Tous les utilisateurs Google Workspace peuvent rechercher et installer votre application Chat dans Google Chat, et la consulter dans Google Workspace Marketplace. Seuls les administrateurs Google Workspace peuvent installer votre application à partir de Marketplace. |
Activer et configurer l'API Google Chat
Configurez un projet pour votre application dans le Google API Console et activez l'API Google Chat.
- Utilisez le bouton ci-dessous pour créer un projet (ou en sélectionner un existant) et y ajouter un compte de service. Attribuez au compte de service le rôle Propriétaire du projet.
Activer l'API - Enregistrez la clé JSON téléchargée. Votre application peut utiliser cette clé pour authentifier les messages qu'elle envoie aux espaces de manière asynchrone.
- Ouvrez votre projet dans API Console. Dans la liste des API, cliquez sur API Google Chat.
- Sélectionnez l'onglet Configuration, puis saisissez les informations de l'application, comme décrit dans le tableau suivant.
Lorsque vous enregistrez la configuration, votre application devient disponible pour les utilisateurs spécifiés de votre organisation Google Workspace.
Paramètres de configuration de l'API Google Chat
| Champ | Description |
|---|---|
| Nom de l'application | Nom que les utilisateurs utilisent lorsqu'ils interagissent avec votre application. |
| URL de l'avatar | URL HTTPS pointant vers une image graphique carrée (par exemple, PNG ou JPEG), d'au moins 128 x 128, qui apparaîtra comme avatar pour votre application. |
| Description | Description des fonctionnalités qui s'affiche sous le nom de votre application. |
| Fonctionnalité | Ensemble de champs qui déterminent les événements pouvant déclencher l'application:
|
| Paramètres de connexion | Le point de terminaison de l'application, qui est l'un des suivants:
|
| Commandes à barre oblique | Commandes susceptibles d'apparaître dans Google Chat Permet aux utilisateurs d'afficher les actions de base de votre application dans Google Chat et de choisir une action spécifique avec laquelle ils souhaitent interagir. |
| Déploiement de lien | Formats d'URL reconnus par l'application et fournissant du contenu supplémentaire lorsque les utilisateurs envoient des liens. Pour en savoir plus, consultez Supprimer des liens. |
| Visibilité | Jusqu'à cinq personnes ou un ou plusieurs groupes Google qui peuvent voir et installer votre application de chat. Utilisez ce champ pour tester votre application ou la partager avec votre équipe. Pour en savoir plus, consultez Paramètres de visibilité et de publication de votre application de chat. |
Accorder des autorisations pour la configuration de l'application
Vous pouvez accorder à des utilisateurs spécifiques l'accès à la page de configuration de l'application. Pour ce faire, utilisez les rôles IAM Propriétaire des applications de chat et Lecteur des applications de chat. Les utilisateurs dotés de ces rôles ne peuvent pas accéder à la page de configuration de l'application via le tableau de bord API et services, mais ils peuvent accéder à la page de configuration en naviguant dans la console pour leur projet comme suit:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=your-project-id
Publier votre application avec le SDK Google Workspace Marketplace
Utilisez le SDK Google Workspace Marketplace pour:
- Publiez votre application en mode public et autorisez tous les utilisateurs de Google Chat à l'ajouter à un espace.
- Publiez votre application sur votre domaine.
- Rendez les administrateurs visibles à Google Workspace afin qu'ils puissent installer l'application pour les utilisateurs de leur organisation. Pour être visible par les administrateurs Google Workspace, votre application doit comporter un message privé.
Avant de publier votre application à l'aide du SDK Google Workspace Marketplace, procédez comme suit:
- Testez votre application Chat en l'installant à partir de Chat. Assurez-vous que votre application est entièrement fonctionnelle et qu'elle n'est pas en cours de développement.
- Passez en revue les exigences de publication et vérifiez que votre application les respecte toutes. Consultez la section Domaines d'examen.
- Notez le numéro de version de votre application. Vous en aurez besoin pour configurer le SDK Google Workspace Marketplace.
Lorsque vous êtes prêt à publier, consultez Présentation: publier une application.
Désactiver l'application Chat
Une fois la page de configuration enregistrée, un champ "État de l'application" s'affiche. Ce champ vous permet de contrôler si l'application est En ligne ou Désactivée.
Pour désactiver une application de chat:
- Ouvrez Google Cloud Console.
- Si nécessaire, sélectionnez le projet Google Cloud qui héberge l'application de chat :
- À côté de "Google Cloud", cliquez sur la flèche vers le bas . Une boîte de dialogue répertoriant les projets en cours s'affiche.
- Sélectionnez le projet qui héberge l'application de chat migrée.
- Cliquez sur Ouvrir.
- Recherchez l'API Google Chat, puis cliquez sur API Google Chat.
- Cliquez sur Gérer.
- Cliquez sur Configuration
- Dans la section "État de l'application", sélectionnez Désactivé.
- Cliquez sur Enregistrer.