Publier des applications Google Chat

Après avoir créé une application Chat, vous pouvez la publier afin qu'elle soit accessible à certains utilisateurs ou groupes, à tous les membres de votre organisation Google Workspace ou à tous les utilisateurs de Google Chat.

Comment les utilisateurs découvrent et utilisent les applications Chat

Pour découvrir les applications Google Chat, les utilisateurs peuvent effectuer l'une des opérations suivantes:

  • Recherchez et installez des applications Chat depuis Google Chat ou Google Workspace Marketplace.
  • interagir avec une application ajoutée à un espace Chat ;
  • découvrir l'application dans son panneau de messages privés après qu'un administrateur Google Workspace l'a installée en son nom ;

Pour commencer à utiliser une application, les utilisateurs Google Chat peuvent démarrer un message privé avec l'application ou l'ajouter à un espace. Les utilisateurs peuvent également ajouter l'application en la mentionnant (@mentionnée). L'exemple suivant montre comment un utilisateur @ mentionne une application Chat pour l'ajouter à un espace:

Ajouter une application à un espace en saisissant "@" dans un message

Comment les administrateurs Google Workspace installent-ils les applications Chat ?

Les administrateurs Google Workspace peuvent trouver des applications Chat sur Google Workspace Marketplace et les installer pour les utilisateurs de leur organisation. Lorsqu'un administrateur installe une application Chat, celle-ci apparaît dans le panneau des messages privés des utilisateurs.

Les administrateurs Google Workspace peuvent également gérer l'utilisation d'applications Chat dans leur organisation Google Workspace et les ajouter à la liste d'autorisation. Si vous développez une application Chat pour une organisation qui utilise des listes d'autorisation, vous devez demander à un administrateur d'ajouter votre application Chat à la liste d'autorisation afin que les utilisateurs puissent la trouver et l'utiliser. Pour en savoir plus, consultez Autoriser les utilisateurs à installer des applications Chat dans l'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 mettre à la disposition des autres utilisateurs, procédez comme suit:

  1. Activer et configurer l'API Google Chat Lorsque vous configurez l'API, vous autorisez d'autres utilisateurs de Google Chat à accéder à votre application Chat à des fins de test.
  2. Publiez votre application avec le SDK Google Workspace Marketplace. Vous pouvez configurer votre application Chat pour qu'elle soit disponible pour les utilisateurs de votre organisation Google Workspace ou pour tous les utilisateurs Google Chat.
  3. Si votre organisation Google Workspace gère l'accès aux applications 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 votre 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:

Utilisateurs visés par l'application 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 ?
Votre petite équipe Authentifiez-vous en tant qu'utilisateur ou en tant qu'application. Dans le paramètre Visibilité, spécifiez les personnes ou les groupes Google autorisés à accéder à l'application.

Si votre compte Google Workspace nécessite l'ajout d'applications à la liste d'autorisation, vous ne pouvez spécifier que cinq 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 Chat. Les membres de l'équipe peuvent trouver et utiliser votre application Chat depuis Google Chat.
Votre grande équipe Authentifiez-vous en tant qu'utilisateur ou en tant qu'application. Dans le paramètre Visibilité, spécifiez les personnes ou les groupes Google qui doivent tester votre application Chat.

Après les tests, 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é.

Définissez Paramètres d'installation sur Individu + Administrateur.

Si votre compte Google Workspace nécessite l'ajout d'applications à la liste d'autorisation, demandez à un administrateur d'y ajouter votre application Chat afin que les utilisateurs puissent la trouver et l'utiliser. Pour en savoir plus, consultez Autoriser les utilisateurs à installer des applications Chat dans l'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 depuis Marketplace.

Votre organisation Google Workspace Authentifiez-vous en tant qu'utilisateur ou en tant qu'application. Dans le paramètre Visibilité, spécifiez les personnes ou les groupes Google qui doivent tester votre application Chat.

Après les tests, 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é.

Définissez Paramètres d'installation sur Individu + 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 depuis Marketplace.

Tout le monde (application Chat publique) Authentifiez-vous en tant qu'utilisateur ou en tant qu'application. Dans le paramètre Visibilité, spécifiez les personnes ou les groupes Google qui doivent tester votre application Chat.

Après les tests, publiez votre application Chat en mode public à l'aide des paramètres de Google Workspace Marketplace.

Définissez Visibilité de l'application sur Public.

Définissez Paramètres d'installation sur Individuel + Administrateur.

Tous les utilisateurs de Google Workspace peuvent trouver et installer votre application Chat dans Google Chat, et la consulter dans Google Workspace Marketplace. Seuls les administrateurs Google Workspace peuvent installer votre application depuis Marketplace.

Activer et configurer l'API Google Chat

Configurez un projet pour votre application dans la console Google Cloud, puis activez l'API Google Chat:

  1. 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
  2. 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.
  3. Ouvrez votre projet dans . Dans la liste des API, cliquez sur API Google Chat.
  4. Sélectionnez l'onglet Configuration et saisissez les informations concernant l'application, comme décrit dans le tableau suivant.

Lorsque vous enregistrez la configuration de l'application, celle-ci devient disponible pour les utilisateurs spécifiés dans votre organisation Google Workspace.

Paramètres de configuration de l'API Google Chat

Champ Description
Nom de l'application Nom utilisé par les utilisateurs lorsqu'ils interagissent avec votre application Chat.
URL de l'avatar Une URL HTTPS pointant vers une image graphique carrée (par exemple, PNG ou JPEG), d'une taille minimale de 128 x 128, qui s'affichera en tant qu'avatar de votre application Chat.
Description Description des fonctionnalités de l'application Chat qui s'affiche sous le nom de votre application Chat.
Fonctionnalité Ensemble de champs qui déterminent la manière dont l'application Chat peut interagir avec les utilisateurs:
  • Recevoir des messages privés : les utilisateurs peuvent trouver l'application Chat et lui envoyer des messages directement dans Google Chat.
  • Rejoindre des espaces et des conversations de groupe: les utilisateurs peuvent ajouter l'application Chat aux espaces et aux conversations de groupe.
Paramètres de connexion Le point de terminaison de l'application Chat, qui est l'un des éléments suivants:
  • URL de l'application: point de terminaison HTTPS qui héberge l'implémentation de l'application Chat.
  • Projet Apps Script: ID de déploiement d'un projet Apps Script mettant en œuvre une application Chat.
  • Nom du sujet Cloud Pub/Sub: un sujet Cloud Pub/Sub auquel l'application Chat s'abonne en tant que point de terminaison.
  • Dialogflow: enregistre l'application Chat avec une intégration Dialogflow. Pour en savoir plus, consultez la documentation Dialogflow sur l'intégration à Google Chat.
Commandes à barre oblique Commandes qui peuvent être présentées aux utilisateurs dans Google Chat. Permet aux utilisateurs de voir les actions principales de votre application Chat dans Google Chat et de choisir l'action avec laquelle ils souhaitent interagir.
Aperçus de liens Formats d'URL reconnus par l'application Chat qui fournissent du contenu supplémentaire lorsque les utilisateurs envoient des liens. Pour en savoir plus, consultez Prévisualiser les liens.
Visibilité Jusqu'à cinq personnes ou un ou plusieurs groupes Google autorisés à consulter et à installer votre application Chat. Utilisez ce champ pour tester votre application Chat ou la partager avec votre équipe. Pour en savoir plus, consultez Paramètres de visibilité et de publication de votre application Chat.

Accorder des autorisations de configuration aux applications

Vous pouvez autoriser des utilisateurs spécifiques à accéder à la page de configuration de l'application. Pour ce faire, utilisez les rôles IAM Propriétaire des applications Chat et Lecteur d'applications Chat. Les utilisateurs disposant 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 peuvent y accéder en accédant à la console de leur projet comme suit:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Publier votre application avec le SDK Google Workspace Marketplace

Le SDK Google Workspace Marketplace vous permet d'effectuer l'une des opérations suivantes:

  • Publiez votre application Chat publiquement et autorisez tous les utilisateurs de Google Chat à l'ajouter à un espace.
  • Publiez votre application Chat dans votre organisation Google Workspace.
  • Rendez votre application visible pour les administrateurs Google Workspace afin qu'ils puissent l'installer pour les utilisateurs de leur organisation. Pour être visible par les administrateurs Google Workspace, votre application doit comporter la messagerie directe.

Avant de publier votre application à l'aide du SDK Google Workspace Marketplace, procédez comme suit:

  1. Testez votre application Chat en l'installant depuis Chat. Assurez-vous que votre application est entièrement fonctionnelle et qu'elle n'est pas en cours de développement.
  2. Consultez les exigences de publication et assurez-vous que votre application les respecte. Consultez la section Domaines d'examen.
  3. 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.