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. Modifier un paramètre d'administration peut restaurer toutes les fonctionnalités 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 la procédure en trois étapes suivante:
- 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.
- Redéployez votre application Chat à partir du nouveau projet Cloud.
- Ajoutez l'application Chat recréée à des espaces ou des 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 que vous autorisez à accéder à l'application Chat peuvent le faire sans erreur.
Créer un projet Cloud
- Dans la console Google Cloud, accédez à Menu > IAM et administration > Créer un projet.
-
Dans le champ Project Name (Nom du projet), saisissez un nom descriptif pour votre projet.
Facultatif: Pour modifier l'ID de projet, cliquez sur Modifier. Une fois le projet créé, vous ne pourrez plus modifier l'ID. Choisissez-en donc un qui répond à vos besoins pour toute la durée de vie du projet.
- Dans le champ Emplacement, cliquez sur Parcourir pour afficher les emplacements potentiels de votre projet. Cliquez ensuite sur Sélectionner.
- Cliquez sur Créer. La console Google Cloud accède à la page "Tableau de bord", et votre projet est créé en quelques minutes.
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 commandegcloud projects create:gcloud projects createPROJECT_ID
Activer les API
L'API Google Chat doit être activée dans toutes les applications Chat. Selon la façon dont votre application Chat est créée, 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 dans l'ancien projet Cloud.
Pour activer une API, procédez comme suit:
- Dans la console Google Cloud, accédez à Menu > Autres produits > Google Workspace > Bibliothèque de produits.
- Cliquez sur l'API que vous souhaitez activer.
- Cliquez sur Activer.
- Pour activer d'autres API, répétez cette procédure.
- Installez ou ouvrez l'interface de ligne de commande (CLI) Google Cloud.
-
Exécutez la commande
services enableen 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 la section Configurer l'API Chat.
Configurer l'écran d'autorisation OAuth
Vous devrez peut-être configurer l'écran de consentement OAuth pour votre projet Cloud. Si vous utilisiez auparavant OAuth 2.0 pour l'autorisation, utilisez les mêmes champs d'application d'autorisation.
- 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 d'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 le type d'utilisateur de votre application.
- 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.
- Si vous avez sélectionné Externe comme type d'utilisateur, ajoutez des utilisateurs de test :
- Cliquez sur Audience.
- Sous Utilisateurs tests, cliquez sur Ajouter des utilisateurs.
- Saisissez votre adresse e-mail et celle des autres utilisateurs de test autorisés, puis cliquez sur Enregistrer.
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 respecter les bonnes pratiques suivantes lorsque vous sélectionnez des champs d'application:
- Sélectionnez les champs d'application qui fournissent le niveau d'accès minimal requis par votre application. Pour obtenir la liste des champs d'application disponibles, consultez la section Champs d'application OAuth 2.0 pour les API Google.
- Examinez les portées listées dans chacune des trois sections: portées non sensibles, portées sensibles et portées restreintes. Pour tous les champs d'application listés dans les sections "Vos champs d'application sensibles" ou "Vos champs d'application limités", essayez d'identifier d'autres champs d'application non sensibles pour éviter des examens supplémentaires inutiles.
- Certains champs d'application nécessitent des examens supplémentaires de la part de Google. Pour les applications utilisées uniquement en interne par votre organisation Google Workspace, les portées ne sont pas listées sur l'écran de consentement, et l'utilisation de portées restreintes 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 champ d'application.
- Après avoir sélectionné les portées requises par votre application, cliquez sur Enregistrer.
Pour en savoir plus sur la configuration du consentement OAuth, consultez la section Premiers pas avec .
Redéployer votre application Chat dans le nouveau projet Cloud
Le redéploiement de votre application Chat varie légèrement selon qu'elle est 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 l'intégralité de 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 de l'application créée à l'aide de Cloud Functions, Cloud Run ou App Engine.
- Pour les applications 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 la section Recevoir et répondre aux interactions utilisateur.
Redéployer une application Chat Apps Script
Pour redéployer votre application Chat créée avec Apps Script, remplacez le numéro de projet Cloud auquel le projet Apps Script est associé par le numéro de projet appartenant à 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
-
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.
Définir le numéro de votre projet Google Cloud dans votre projet Apps Script
Accédez à Apps Script.
Dans le projet Apps Script de l'application Chat, 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.
Copiez l'ID de déploiement de votre projet Apps Script.
- En haut à droite d'Apps Script, cliquez sur Déployer > Gérer les déploiements.
- Sous ID de déploiement, cliquez sur Copier.
- Cliquez sur OK.
Reconfigurer et redéployer votre application Chat
Dans la console Google Cloud, recherchez "API Google Chat", puis cliquez sur API Google Chat, puis sur Gérer.
Cliquez sur l'onglet Configuration, puis saisissez les informations requises suivantes:
- Nom de l'application: nom utilisé par les utilisateurs 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), d'au moins 128 x 128 pixels, qui s'affiche comme avatar de votre application Chat.
- Description: description de l'objectif de l'application Chat, qui s'affiche sous le nom de votre application Chat.
Pour activer les fonctionnalités interactives, cliquez sur le bouton bascule Activer les fonctionnalités interactives qui permet aux utilisateurs d'interagir avec votre application Chat:
Sous "Paramètres de connexion", sélectionnez Projet Apps Script.
Dans le champ ID de déploiement, collez l'ID de déploiement que vous avez précédemment copié.
Pour terminer la configuration, consultez le tableau de la section Configurer l'application Chat dans le nouveau projet Cloud.
Cliquez sur Enregistrer.
Redéployer une application Chat basée sur 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 vers les API Google, mettez à jour les informations du compte de service de l'application Chat. Pour en savoir plus, consultez la section 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 des applications Chat ?
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-le aux espaces Chat ou aux messages privés, puis supprimez-en l'ancienne application Chat pour que les utilisateurs n'envoient des messages qu'à l'application Chat migrée.
Ajouter la nouvelle application Chat aux espaces Chat
Accédez à Chat.
Cliquez sur un message privé ou un espace.
Cliquez sur le menu déroulant à côté du nom de l'espace ou de la personne, puis sélectionnez Applications et intégrations.
Cliquez sur Ajouter des applications.
Saisissez le nom de l'application, sélectionnez-la dans la liste, puis cliquez sur Ajouter.
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
Accédez à Chat.
Cliquez sur un message privé ou un espace.
Cliquez sur le menu déroulant à côté du nom de l'espace ou de la personne, puis sélectionnez Applications et intégrations.
À côté de l'ancienne application Chat non migrée, cliquez sur Plus d'options , puis sur Exclure de l'espace.
Répétez ces étapes pour chaque espace ou message privé pour lequel 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 annulez sa publication sur Google Workspace Marketplace.