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 des paramètres d'administration l'affectent. La modification d'un paramètre d'administration peut restaurer la fonctionnalité complète de votre application Chat et rendre la migration inutile. Par exemple, votre administrateur Google Workspace devra peut-être 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 d'organisations Google Workspace.

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

1. Configurez l'environnement de votre application Chat en créant un projet Google Cloud dans l'organisation fusionnée, en activant les 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

Créer un projet Cloud et activer les API pour l'application Chat dans l'organisation Google Workspace fusionnée permet de s'assurer que les utilisateurs et les groupes auxquels vous autorisez l'accès à l'application Chat peuvent 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 à "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. Vous ne pourrez plus modifier cet ID une fois le projet créé. Choisissez-en donc un qui répond à vos besoins pour toute la durée de vie du projet.

3. Dans le champ Emplacement, cliquez sur Parcourir pour afficher les emplacements potentiels de votre projet. Cliquez ensuite sur Sélectionner.
   Attention : Vous ne trouvez pas votre organisation Google Workspace ?
   Cela signifie que vous n'êtes pas connecté à un compte Google Workspace. Certaines des fonctionnalités décrites dans la documentation pour les développeurs Google Workspace ne sont disponibles que pour les projets associés à une organisation.
4. Cliquez sur Créer. La console Google Cloud accède à la page "Tableau de bord" et votre projet est créé en quelques minutes.

CLI gcloud

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 gcloud CLI déjà configuré, activez Cloud Shell.
  Activer Cloud Shell
• Shell local : pour utiliser un environnement de développement local, installez et initialisez 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

Toutes les applications Chat doivent avoir l'API Google Chat activée. Selon la façon dont votre application Chat est conçue, 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, nous vous recommandons d'activer les mêmes API dans le nouveau projet Cloud 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 au menu  > Autres 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

Configurer l'API Chat

Dans votre nouveau projet Cloud, vous devez utiliser l'API Chat pour spécifier le nom, la description et l'icône de votre application Chat. Pour configurer ces informations, consultez Configurer l'API Chat.

Configurer l'écran d'autorisation OAuth

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 niveaux d'accès.

1. Dans la console Google Cloud, accédez à Menu  > > Branding.

   Accéder à "Branding"

2. Si vous avez déjà configuré , vous pouvez configurer les paramètres de l'écran d'autorisation OAuth suivants dans Branding, Audience et Accès aux données. Si le message pas encore configuré s'affiche, cliquez sur Commencer :
1. Sous Informations sur l'application, dans Nom de l'application, saisissez un nom d'application.
2. Dans Adresse e-mail d'assistance utilisateur, sélectionnez une adresse e-mail d'assistance que les utilisateurs pourront contacter s'ils ont des questions sur leur consentement.
3. Cliquez sur Suivant.
4. Sous Audience, sélectionnez le type d'utilisateur pour votre application.
5. Cliquez sur Suivant.
6. Sous Coordonnées, saisissez une adresse e-mail à laquelle vous pourrez être informé de toute modification apportée à votre projet.
7. Cliquez sur Suivant.
8. Sous Terminer, consultez le Règlement sur les données utilisateur dans les services d'API Google et, si vous l'acceptez, sélectionnez J'accepte le Règlement sur les données utilisateur dans les services d'API Google.
9. Cliquez sur Continuer.
10. Cliquez sur Créer.
11. Si vous avez sélectionné Externe comme type d'utilisateur, ajoutez des utilisateurs de test :
    1. Cliquez sur Audience.
    2. Sous Utilisateurs de test, cliquez sur Ajouter des utilisateurs.
    3. Saisissez votre adresse e-mail et celles des autres utilisateurs de test autorisés, puis cliquez sur Enregistrer.

3. Si vous créez une application à utiliser en dehors de votre organisation Google Workspace, cliquez sur Accès aux données > Ajouter ou supprimer des champs d'application. Nous vous recommandons de suivre les bonnes pratiques suivantes lorsque vous sélectionnez des niveaux d'accès :

   • Sélectionnez les niveaux d'accès qui fournissent le niveau d'accès minimal requis par votre application. Pour obtenir la liste des niveaux d'accès disponibles, consultez Champs d'application OAuth 2.0 pour les API Google.
   • Examinez les niveaux d'accès listés dans chacune des trois sections : niveaux d'accès non sensibles, sensibles et 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 pour éviter des examens supplémentaires inutiles.
   • Certains niveaux d'accès nécessitent des examens supplémentaires par Google. Pour les applications utilisées uniquement en interne par votre organisation Google Workspace, les niveaux d'accès ne sont pas listés sur l'écran de consentement. L'utilisation de niveaux d'accès restreints ou sensibles ne nécessite pas d'examen supplémentaire par Google. Pour en savoir plus, consultez Catégories de couverture.
4. Après avoir sélectionné les niveaux d'accès requis par votre application, cliquez sur Enregistrer.

Pour en savoir plus sur la configuration du consentement OAuth, consultez Premiers pas avec .

Redéployer votre application Chat sur le nouveau projet Cloud

La façon de redéployer votre application Chat dépend de la façon dont elle a été créée (avec Apps Script, AppSheet ou un autre type de connexion, comme Python ou Java). 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

Selon 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 qui a été créé à l'aide de Cloud Functions, Cloud Run ou App Engine.
• Pour les applications de chat conversationnelles qui utilisent le langage naturel, vous devez également migrer les agents Dialogflow.
• Pour les applications Chat créées derrière un pare-feu, vous devez également migrer les sujets Pub/Sub.

Configurer les fonctionnalités interactives 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.

Pour configurer des fonctionnalités interactives, consultez Recevoir des interactions utilisateur et y répondre.

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. Copiez ensuite 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 le numéro de votre 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 du projet, copiez la valeur.

Définir le numéro de votre 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", puis 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 carrée (par exemple, PNG ou JPEG) d'au moins 128 x 128 pixels, qui apparaît comme avatar de votre application Chat.
   • Description : description de l'objectif de l'application Chat, qui s'affiche sous le nom de l'application.

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 copié précédemment.

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 effectuer des appels aux API Google, mettez à jour les informations 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, il est possible que votre administrateur doive autoriser manuellement l'accès à l'application Chat. Pour en savoir plus, consultez Configurer l'accès pour les organisations Google Workspace dans la documentation Google Workspace Marketplace.

Passer à la nouvelle application Chat

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

Bonne pratique : Pour faciliter l'adoption de l'application Chat migrée, annoncez la migration à vos utilisateurs et encouragez-les à installer l'application Chat migrée dans les espaces et conversations Chat.

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 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'utiliser l'ancienne application Chat et les encourager à utiliser la nouvelle, désactivez l'ancienne application Chat et supprimez-la de Google Workspace Marketplace.