Migrer votre application Google Chat

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

Avant de migrer votre application Chat, consultez votre l'administrateur de l'organisation pour vérifier si les paramètres d'administration qui l'affectent. La modification d'un paramètre d'administration peut restaurer à votre application Chat et procédez à la migration inutile. Par exemple, votre administrateur Google Workspace peut avoir d'ajouter votre application Chat à une liste d'autorisation, ou de devoir permettent aux utilisateurs d'installer des applications Chat. Pour en savoir plus, consultez Déterminez si les applications Google Chat doivent migrer après la fusion d'organisations Google Workspace.

Une fois que vous avez déterminé que vous devez migrer L'application Chat effectue les trois étapes suivantes:

  1. Configurez l'environnement de votre application Chat en procédant comme suit : créer un projet Google Cloud dans l'organisation fusionnée, activer les API ; éventuellement la configuration de l'écran de consentement OAuth 2.0.
  2. Redéployez votre application Chat depuis la nouvelle Google Cloud.
  3. Ajouter l'application Chat recréée à Chat des espaces ou des conversations, et désactiver Application Chat

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

Créer un projet Cloud et activer les API pour le Application Chat dans l'organisation Google Workspace fusionnée s'assure que les utilisateurs et les groupes auxquels vous autorisez l'accès L'application Chat peut le faire sans erreur.

Créer un projet Cloud

console Google Cloud

  1. Dans la console Google Cloud, accédez au menu . > IAM et Administrateur > 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. Impossible de modifier l'ID du projet Une fois le projet créé, choisissez donc un ID qui répond à vos besoins pendant toute la durée de vie projet.

  3. Dans le champ Lieu, cliquez sur Parcourir pour afficher les emplacements potentiels de votre projet. Cliquez ensuite sur Sélectionner. <ph type="x-smartling-placeholder">
  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 console CLI ("gcloud"):

  • Cloud Shell: pour utiliser un terminal en ligne avec la gcloud CLI déjà configuré, activez Cloud Shell.
    Activer Cloud Shell
  • Shell local: pour utiliser un environnement de développement local, installer et initialiser 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

Toutes les applications Chat doivent disposer de l'API Google Chat est activé. Selon la structure de votre application Chat, vous vous devrez peut-être activer d'autres API. Par exemple, si vous créé votre application Chat à l'aide de Google Cloud Functions ; activer l'API Cloud Build, l'API Cloud Functions, l'API Pub/Sub, l'API Cloud Logging, l'API Artifact Registry et l'API Cloud Run. Une bonne pratique consiste à s'assurer l'application migrée, activez les mêmes API dans le nouveau projet Cloud sont activés 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 . &gt; Autres produits &gt; Google Workspace &gt; 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écifiez le nom, la description et l'icône de votre application Chat. À configurer ces détails, consultez Configurer l'API Chat

Il peut être nécessaire de configurer l'écran de consentement OAuth pour votre Google Cloud. Si vous avez déjà utilisé OAuth 2.0 pour l'autorisation, utilisez avec les mêmes niveaux d'accès.

  1. Dans la console Google Cloud, accédez au menu . &gt; API et Services &gt; Écran de consentement OAuth.

    Accéder à l'écran de consentement OAuth

  2. Sélectionnez le type d'utilisateur pour votre application, puis cliquez sur Créer.
  3. Remplissez le formulaire d'inscription de l'application, puis cliquez sur Enregistrer et continuer.

  4. Si vous créez une application pour une utilisation en dehors de Google Workspace cliquez sur Ajouter ou supprimer des niveaux d'accès. Nous vous recommandons d'appliquer les bonnes pratiques suivantes en sélectionnant 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 une liste les 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: non sensibles les niveaux d'accès sensibles et restreints. Pour tout champ d'application listé dans le "Vos niveaux d'accès sensibles" ou "Vos niveaux d'accès restreints" des sections, essayez d'identifier d'autres champs d'application non sensibles pour éviter des examens supplémentaires inutiles.
    • Certaines habilitations nécessitent un examen supplémentaire de la part de Google. Pour les applis utilisées uniquement en interne par votre organisation Google Workspace, les champs d'application ne sont pas indiqués l'écran de consentement et l'utilisation de niveaux d'accès restreints ou sensibles ne nécessitent pas un examen plus approfondi par Google. Pour en savoir plus, consultez Catégories de champ d'application.
  5. Après avoir sélectionné les niveaux d'accès requis de votre application, cliquez sur Enregistrer et continuer.
  6. Si vous avez sélectionné le type d'utilisateur Externe, ajoutez des utilisateurs tests: <ph type="x-smartling-placeholder">
      </ph>
    1. Sous Utilisateurs de test, cliquez sur Ajouter des utilisateurs.
    2. Saisissez votre adresse e-mail et le nom de tout autre utilisateur test autorisé, puis cliquez sur Enregistrer et continuer.
  7. Consultez le récapitulatif d'enregistrement de votre application. Pour y apporter des modifications, cliquez sur Modifier. Si l'application l'inscription vous semble correcte, cliquez sur Retour au tableau de bord.

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

Selon que votre application Chat intègre ou non Apps Script, AppSheet ou un autre type de connexion, comme Python ou Java, le redéploiement de votre application Chat diffère un peu. Dans les deux cas, vous n'avez pas besoin de recréer tout votre code, ont besoin d'apporter des modifications.

Migrer la logique de l'application Chat

En fonction du 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 a été créé à l'aide de Cloud Functions, Cloud Run ou App Engine.
  • Pour les applications Chat de conversation utilisant le langage naturel, vous devez effectuer les actions suivantes : ou migrer les agents Dialogflow.
  • Pour les applications Chat créées derrière un pare-feu, vous pouvez également que vous devez migrer les sujets Pub/Sub.

Configurer des fonctionnalités interactives dans le nouveau projet Cloud

Pour redéployer votre application Chat créée avec une langue comme Python ou Java, configurez l'application Chat dans votre un nouveau projet Cloud.

Pour configurer les fonctionnalités interactives, consultez recevoir les interactions des utilisateurs et y répondre.

Redéployer une application de chat Apps Script

Pour redéployer votre application Chat basée sur des Apps Script, modifiez le numéro du projet Cloud Le projet Apps Script est associé au numéro de projet appartenant à votre nouveau projet Cloud. Ensuite, copiez votre ID de déploiement Apps Script et collez-le dans le 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 au menu . &gt; IAM et Administrateur &gt; 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 de projet Google Cloud.

  5. Cliquez sur Définir un projet.

Copier 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 Deployment ID (ID de déploiement), cliquez sur Copy (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 cliquez sur Gérer.

    Accéder à l'API Chat

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

    • Nom de l'application: il s'agit du 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 (PNG ou JPEG, par exemple), au moins 128 x 128, qui apparaît comme pour votre application Chat.
    • Description: il s'agit d'une description Objectif prévu 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. pour permettre aux utilisateurs d'interagir avec Application de chat:

  4. Sous "Connection settings" (Paramètres de connexion), sélectionnez Apps Script project (Projet Apps Script).

  5. Dans le champ Deployment ID (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 documentation 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 basée sur des 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 le Détails du compte de service de l'application Chat. Pour plus pour en savoir plus, consultez S'authentifier en tant qu'application Chat

Partager votre application Chat

Avant que votre application Chat ne soit mise à la disposition des utilisateurs du nouvelle organisation, administrateur devra peut-être autoriser manuellement l'accès Application Chat Pour plus d'informations, se référer à Découvrez comment les administrateurs Google Workspace installent les applications Chat.

Passer à la nouvelle application Chat

Maintenant que l'application Chat a été migrée vers la nouvelle il est temps de le rendre public. Ajoutez-le aux espaces Chat ou les messages privés, puis supprimez l'ancienne application Chat afin que les utilisateurs n'envoient un message que Application Chat

<ph type="x-smartling-placeholder">

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égrés.

  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é que 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égrés.

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

  5. Répétez ces étapes pour chaque espace ou message privé que 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 pour les encourager à utiliser la nouvelle application Chat, désactiver l'ancienne application Chat et annuler sa publication sur Google Workspace Marketplace.