Migrer votre application Google Chat

Si vous fusionnez des organisations Google Workspace, vous devrez peut-être migrer votre application Chat pour qu'elle continue de fonctionner.

Avant de migrer votre application Chat, vérifiez auprès de l'administrateur de votre organisation si les paramètres d'administration l'affectent. La modification d'un paramètre d'administration peut rétablir toutes les fonctionnalités de votre application Chat et rendre la migration inutile. Par exemple, votre administrateur Google Workspace peut être amené à ajouter votre application Chat à une liste d'autorisation ou à autoriser les utilisateurs à installer des applications Chat. Pour en savoir plus, consultez Déterminer si les applications Google Chat doivent être migrées après la fusion des organisations Google Workspace.

Une fois que vous avez déterminé que vous devez migrer votre application Chat, suivez les trois étapes ci-dessous:

  1. Configurez l'environnement de votre application Chat en créant un projet Google Cloud dans l'organisation fusionnée, en activant des API et en configurant éventuellement l'écran de consentement OAuth 2.0.
  2. Redéployez votre application Chat à partir du nouveau projet Cloud.
  3. Ajoutez l'application Chat recréée aux espaces ou aux conversations Chat, puis désactivez l'application Chat d'origine.

Créer un projet Cloud dans l'organisation fusionnée et activer les API

La création d'un projet Cloud et l'activation des API pour l'application Chat dans l'organisation Google Workspace fusionnée permettent aux utilisateurs et aux groupes autorisés à accéder à l'application Chat de le faire sans erreur.

Créer un projet Cloud

console Google Cloud

  1. Dans la console Google Cloud, accédez à Menu > IAM et administration > Créer un projet.

    Accéder à la page Créer un projet

  2. Dans le champ Nom du projet, saisissez un nom descriptif pour votre projet.

    Facultatif: Pour modifier l'ID du projet, cliquez sur Modifier. Une fois le projet créé, l'ID ne pourra plus être modifié. Par conséquent, choisissez un ID qui répond à vos besoins tout au long de la durée de vie du projet.

  3. Dans le champ Emplacement, cliquez sur Parcourir pour afficher les emplacements potentiels pour votre projet. Cliquez ensuite sur Sélectionner.
  4. Cliquez sur Créer. La console Google Cloud accède à la page "Tableau de bord", et votre projet est créé en quelques minutes.

gcloud CLI

Dans l'un des environnements de développement suivants, accédez à la Google Cloud CLI ("gcloud"):

  • Cloud Shell: pour utiliser un terminal en ligne avec la gcloud CLI configurée, activez Cloud Shell.
    Activer Cloud Shell
  • Shell locale: pour utiliser un environnement de développement local, installez et initialize la gcloud CLI.
    Pour créer un projet Cloud, utilisez la commande "gcloud projects create" : 
    gcloud projects create PROJECT_ID
    Remplacez PROJECT_ID en définissant l'ID du projet que vous souhaitez créer.

Activer les API

L'API Google Chat doit être activée dans toutes les applications Chat. En fonction de la conception de votre application Chat, vous devrez peut-être activer d'autres API. Par exemple, si vous avez créé votre application Chat à l'aide de Google Cloud Functions, activez les API Cloud Build, Cloud Functions, Pub/Sub, Cloud Logging, Artifact Registry et Cloud Run. Pour vous assurer que l'application migrée fonctionne, il est recommandé d'activer dans le nouveau projet Cloud les mêmes API que celles activées dans l'ancien projet Cloud.

Pour activer une API, procédez comme suit:

console Google Cloud

  1. Dans la console Google Cloud, accédez à Menu > Plus de produits > Google Workspace > Bibliothèque de produits.

    Accéder à la bibliothèque de produits

  2. Cliquez sur l'API que vous souhaitez activer.
  3. Cliquez sur Activer.
  4. Pour activer d'autres API, répétez ces étapes.

Google Cloud CLI

  1. Installez ou ouvrez l'interface de ligne de commande (CLI) Google Cloud.

  2. Exécutez la commande services enable en spécifiant le service d'API à activer.

    gcloud services enable API_SERVICE_ID

Il peut être nécessaire de configurer l'écran de consentement OAuth pour votre projet Cloud. Si vous avez déjà utilisé OAuth 2.0 pour l'autorisation, utilisez les mêmes champs d'application d'autorisation.

  1. Dans la console Google Cloud, accédez à Menu > API et services > Écran de consentement OAuth.

    Accéder à l'écran de consentement OAuth

  2. Sélectionnez le type d'utilisateur de votre application, puis cliquez sur Créer.
  3. Remplissez le formulaire d'enregistrement de l'application, puis cliquez sur Save and Continue (Enregistrer et continuer).

  4. Si vous créez une application pour l'utiliser en dehors de votre organisation Google Workspace, cliquez sur Ajouter ou supprimer des champs d'application. Nous vous recommandons de suivre les bonnes pratiques suivantes lors de la sélection des champs d'application:

    • Sélectionnez les champs d'application fournissant le niveau d'accès minimal requis par votre application. Pour obtenir la liste des champs d'application disponibles, consultez Champs d'application OAuth 2.0 pour les API Google.
    • Examinez les champs d'application répertoriés dans chacune des trois sections: champs d'application non sensibles, champs d'application sensibles et champs d'application restreints. Pour tous les champs d'application listés dans les sections "Vos champs d'application sensibles" ou "Vos champs d'application restreints", essayez d'identifier d'autres champs d'application non sensibles afin d'éviter des examens supplémentaires inutiles.
    • Certaines portées nécessitent un examen supplémentaire de la part de Google. Pour les applications utilisées uniquement en interne par votre organisation Google Workspace, les champs d'application ne sont pas répertoriés sur l'écran de consentement, et l'utilisation de champs d'application restreints ou sensibles ne nécessite pas d'examen supplémentaire de la part de Google. Pour en savoir plus, consultez la section Catégories de champs d'application.
  5. Après avoir sélectionné les champs d'application requis par votre application, cliquez sur Enregistrer et continuer.
  6. Si vous avez sélectionné le type d'utilisateur Externe, ajoutez des utilisateurs tests :
    1. Sous Utilisateurs test, cliquez sur Ajouter des utilisateurs.
    2. Saisissez votre adresse e-mail et celle de tout autre utilisateur test autorisé, puis cliquez sur Enregistrer et continuer.
  7. Consultez le résumé d'enregistrement de votre application. Pour apporter des modifications, cliquez sur Modifier. Si l'enregistrement de l'application semble correct, cliquez sur Back to Dashboard (Revenir au tableau de bord).

Redéployez votre application Chat vers le nouveau projet Cloud.

Selon que votre application Chat est conçue avec Apps Script, AppSheet ou un autre type de connexion, comme Python ou Java, le redéploiement de votre application Chat diffère légèrement. Dans les deux cas, vous n'avez pas besoin de recréer tout votre code, mais vous devez apporter quelques modifications.

Migrer la logique de l'application Chat

En fonction de l'architecture de votre application Chat, vous devrez peut-être migrer d'autres services vers le nouveau projet Cloud:

  • Pour les applications HTTP, vous devez également migrer le reste de la logique d'application créée à l'aide de Cloud Functions, Cloud Run ou App Engine.
  • Pour les applications de chat conversationnel qui utilisent le langage naturel, vous devez également migrer les agents Dialogflow.
  • Pour les applications Chat protégées par un pare-feu, vous devez également migrer les sujets Pub/Sub.

Configurer l'application Chat dans le nouveau projet Cloud

Pour redéployer votre application Chat créée avec un langage tel que Python ou Java, configurez l'application Chat dans votre nouveau projet Cloud.

  1. Dans la console Google Cloud, recherchez "API Google Chat" et cliquez sur API Google Chat, puis sur Gérer.

    Accéder à l'API Chat

  2. Cliquez sur l'onglet Configuration, puis saisissez les informations requises suivantes:

    • Nom de l'application: nom que les utilisateurs utilisent lorsqu'ils interagissent avec votre application Chat.
    • URL de l'avatar: URL HTTPS pointant vers une image graphique carrée (par exemple, PNG ou JPEG), au moins 128 x 128, qui apparaît en tant qu'avatar de votre application Chat.
    • Description: description de la finalité de l'application Chat qui s'affiche sous le nom de votre application Chat.

  3. Pour activer les fonctionnalités interactives, cliquez sur le bouton Activer les fonctionnalités interactives qui permet aux utilisateurs d'interagir avec votre application Chat et utilisez le tableau suivant pour terminer la configuration:

    Champ Description
    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 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 l'article Créer une application Google Chat Dialogflow qui comprend le langage naturel.
    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 une action spécifique avec laquelle ils souhaitent interagir. Pour en savoir plus, consultez Répondre aux commandes à barre oblique en tant qu'application Chat.
    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.

  4. Pour consigner les erreurs dans Cloud Logging chaque fois que l'application Chat renvoie une erreur, cochez la case Consigner les erreurs dans Logging. Pour en savoir plus, consultez la section Interroger les journaux d'erreurs pour les applications Chat.

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

Redéployer une application Chat Apps Script

Pour redéployer votre application Chat créée avec Apps Script, remplacez le numéro du projet Cloud auquel le projet Apps Script est associé par le numéro de votre nouveau projet Cloud. Ensuite, copiez votre ID de déploiement Apps Script et collez-le sur la page de configuration de l'application Chat dans la console Google Cloud.

Copier votre numéro de projet Cloud

  1. 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

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

Définir votre numéro de projet Google Cloud dans votre projet Apps Script

  1. Accédez à Apps Script.

    Accéder à Apps Script

  2. Dans le projet Apps Script de l'application Chat, 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 du projet Google Cloud.

  5. Cliquez sur Définir un projet.

Copiez l'ID de déploiement de votre projet Apps Script

  1. En haut à droite d'Apps Script, cliquez sur Déployer > Gérer les déploiements.
  2. Sous ID de déploiement, cliquez sur Copier.
  3. Cliquez sur OK.

Reconfigurer et redéployer votre application Chat

  1. Dans la console Google Cloud, recherchez "API Google Chat" et cliquez sur API Google Chat, puis sur Gérer.

    Accéder à l'API Chat

  2. Cliquez sur l'onglet Configuration, puis saisissez les informations requises suivantes:

    • Nom de l'application: nom que les utilisateurs utilisent lorsqu'ils interagissent avec votre application Chat.
    • URL de l'avatar: URL HTTPS pointant vers une image graphique carrée (par exemple, PNG ou JPEG), au moins 128 x 128, qui apparaît en tant qu'avatar de votre application Chat.
    • Description: description de la finalité de l'application Chat qui s'affiche sous le nom de votre application Chat.

  3. Pour activer les fonctionnalités interactives, cliquez sur le bouton Activer les fonctionnalités interactives qui permet aux utilisateurs d'interagir avec votre application Chat:

  4. Sous "Paramètres de connexion", sélectionnez Projet Apps Script.

  5. Dans le champ ID de déploiement, collez l'ID de déploiement que vous avez précédemment copié.

  6. Pour terminer la configuration, consultez le tableau de la section Configurer l'application Chat dans le nouveau projet Cloud.

  7. Cliquez sur Enregistrer.

Redéployer une application Chat AppSheet

Pour redéployer votre application Chat créée avec AppSheet dans votre nouveau projet Cloud, copiez l'application dans le nouveau projet Cloud.

Mettre à jour le compte de service

Si votre application Chat s'authentifie en tant qu'application et utilise un compte de service pour appeler les API Google, mettez à jour les détails du compte de service de l'application Chat. Pour en savoir plus, consultez S'authentifier en tant qu'application Chat.

Partager votre application Chat

Avant que votre application Chat ne soit disponible pour les utilisateurs de la nouvelle organisation, votre administrateur devra peut-être autoriser manuellement l'accès à l'application Chat. Pour en savoir plus, consultez Comment les administrateurs Google Workspace installent-ils les applications Chat ?.

Passer à la nouvelle application Chat

Maintenant que l'application Chat est migrée vers la nouvelle organisation, il est temps de la publier. Ajoutez-la aux espaces Chat ou aux messages privés, puis supprimez-y l'ancienne application Chat afin que les utilisateurs n'envoient des messages qu'à l'application Chat migrée.

Ajouter la nouvelle application Chat aux espaces Chat

  1. Accédez à Chat.

    Accéder à Chat

  2. Cliquez sur un message privé ou un espace.

  3. Cliquez sur le menu déroulant à côté du nom de l'espace ou de la personne, puis sélectionnez Applications et intégrations.

  4. Cliquez sur Ajouter des applications.

  5. Saisissez le nom de l'application, sélectionnez-la dans la liste, puis cliquez sur Add (Ajouter).

  6. Répétez ces étapes pour chaque espace ou message privé auquel vous souhaitez ajouter l'application Chat.

Supprimer l'ancienne application Chat des espaces Chat

  1. Accédez à Chat.

    Accéder à Chat

  2. Cliquez sur un message privé ou un espace.

  3. Cliquez sur le menu déroulant à côté du nom de l'espace ou de la personne, puis sélectionnez Applications et intégrations.

  4. À côté de l'ancienne application Chat non migrée, cliquez sur Plus d'options , puis sur Exclure de l'espace.

  5. Répétez ces étapes pour chaque espace ou message privé dont vous souhaitez supprimer l'ancienne application Chat.

Désactiver l'ancienne application Chat

Pour empêcher les utilisateurs d'employer l'ancienne application Chat et les encourager à utiliser la nouvelle application, désactivez l'ancienne application Chat et annulez sa publication dans Google Workspace Marketplace.