Installer et autoriser des modules complémentaires

Les utilisateurs doivent installer et autoriser un module complémentaire avant de pouvoir l'ouvrir et l'utiliser. Ces étapes étant la première partie du une expérience utilisateur complémentaire, vous devez les comprendre avant de commencer à créer vos propres modules complémentaires.

Cette section de la documentation explique comment les utilisateurs peuvent installer, autoriser et commencer à utiliser des modules complémentaires.

Installer des modules complémentaires

Avant de pouvoir utiliser un module complémentaire, vous devez l'installer. Une fois installé, le module complémentaire est disponible dans Google Workspace application hôte qu'elle s'étend.

Vous pouvez installer les modules complémentaires publiés depuis l'application hôte Google Workspace ou depuis Google Workspace Marketplace. Les administrateurs de domaine peuvent aussi installer des modules complémentaires depuis Google Workspace Marketplace. Vous pouvez également installer des modules complémentaires non publiés que vous développez afin de pouvoir les tester. Avant de pouvoir utiliser un module complémentaire installé pour la première fois, vous devez l'autoriser.

Pour en savoir plus, consultez la section Publier des modules complémentaires.

Autoriser les modules complémentaires

Une fois un module complémentaire installé, il devient disponible dans l'application hôte Google Workspace qu'il étend. La première fois qu'un utilisateur tente d'utiliser le module complémentaire, l'application hôte lui présente une carte ou une boîte de dialogue d'autorisation. Cette fiche explique ce que le module complémentaire doit être autorisé à faire pour l'utilisateur, par exemple accéder au contenu de la feuille de calcul Google actuelle. L'utilisateur peut ensuite les autoriser et autoriser le module complémentaire à continuer. Si le l'utilisateur refuse le module complémentaire il ne peut pas utiliser le module complémentaire.

Les modules complémentaires des éditeurs utilisent un modèle d'autorisation différent de celui des modules complémentaires Google Workspace. Étant donné que les modules complémentaires Editor fonctionnent sur des fichiers Google Drive, le modèle d'autorisation de l'éditeur définit différents modes d'autorisation qui résultent de l'utilisation des modules complémentaires avec des fichiers individuels. Lorsque vous développez des modules complémentaires pour l'éditeur, il est important de comprendre les différents modes et la façon dont un module complémentaire passe de l'un à l'autre.

Autoriser les modules complémentaires publiés

Une fois que vous avez installé un module complémentaire publié, le flux d'autorisation commence immédiatement :

  1. Vous êtes invité à Sélectionner un compte pour installer le module complémentaire.
  2. La liste des autorisations que le module complémentaire a besoin pour fonctionner, afin que vous sachiez ce qu’il tente de faire. Vérifier lister attentivement, et si vous voulez toujours accorder l'autorisation, cliquez sur Autoriser. Le module complémentaire est alors activé.
  3. Vous pouvez maintenant l'exécuter à partir de l'application hôte qu'il étend. Si l'application était déjà ouverte dans un onglet du navigateur, vous devrez peut-être actualiser l'onglet avant que le module complémentaire ne soit disponible.

Si le module complémentaire que vous avez installé est mis à jour ultérieurement et nécessite que vous n'avez pas encore accordées, vous êtes invité à les fournir la prochaine fois que vous utiliserez le module complémentaire.

Autoriser les modules complémentaires Google Workspace non publiés

Fiche d'autorisation de module complémentaire

Les modules complémentaires non publiés ne sont pas soumis au même flux d'autorisation que les modules complémentaires publiés car ils ne figurent pas encore sur Google Workspace Marketplace. Après l'installation d'un module complément non publié, vous n'êtes pas immédiatement invité à donner votre autorisation. À la place, le flux d'autorisation démarre lorsque vous essayez d'utiliser le module complémentaire pour la première fois.

Lorsqu'un module complémentaire est exécuté, il détermine si une autorisation de l'utilisateur est nécessaire. Si une autorisation est nécessaire, le module complémentaire présente une fiche d'autorisation. L'autorisation est toujours requise la première fois qu'un module complémentaire s'exécute. Elle peut également être requise si une nouvelle version du module complémentaire utilise un service qui n'était pas autorisé auparavant. Le bouton Autoriser l'accès permet à l'utilisateur d'autoriser ou de refuser l'autorisation du module complémentaire dans une boîte de dialogue.

Autoriser des services autres que Google pour un module complémentaire Google Workspace

Un module complémentaire Google Workspace peut se connecter à un service tiers qui nécessite lui-même une autorisation. Modules complémentaires Google Workspace qui se connectent à ces services nécessitent deux actions distinctes de la part de l'utilisateur:

  • Autorisation du module complémentaire lui-même, lorsqu'il est installé ou qu'il est pour commencer.
  • Autorisation du service autre que Google lors du premier accès.

Si un module complémentaire Google Workspace que vous développez doit accéder à un service autre que Google à l'aide d'OAuth, vous devez configurer la connexion pour ce service lors de la création du module complémentaire.

Pour en savoir plus, consultez Associer votre module complémentaire Google Workspace à un service tiers.

Systèmes de conférence tiers

Les modules complémentaires Google Workspace qui étendent Google Agenda peuvent également ajouter des solutions de visioconférence supplémentaires qui permettent aux utilisateurs de sélectionner un système de visioconférence tiers lorsqu'ils modifient des événements Google Agenda. Si votre module complémentaire propose des options de conférence qui nécessitent que l'utilisateur s'y connecte, il doit lui permettre de le faire.

Si un utilisateur tente de créer une conférence avec votre module complémentaire sans avoir besoin se connecter, la méthode onCreateFunction des solutions de conférence doit renvoyer ConferenceData contenant une ConferenceError avec un URL d'authentification.

À la réception de cet objet, Google Agenda crée un bouton SE CONNECTER dans l'interface utilisateur de modification de l'événement qui redirige vers l'URL d'authentification fournie par le module complémentaire. Les utilisateurs peuvent ensuite utiliser ce bouton pour se connecter au système tiers avant d'utiliser le module complémentaire.

Consultez l'article Créer des conférences tierces. pour en savoir plus sur la gestion des autorisations à l'aide de ConferenceError.

Autoriser les modules complémentaires de l'éditeur dont la publication a été annulée

Nous vous recommandons de tester les modules complémentaires de l'éditeur. à mesure que vous les développez. Le flux d'autorisation est identique à celui des modules complémentaires Editor publiés, sauf qu'il commence lorsque vous essayez de tester le module complémentaire pour la première fois. Si vous testez à nouveau le même module complémentaire, vous n'êtes plus invité à l'autoriser.

Annuler l'autorisation des modules complémentaires

Lorsque vous développez des modules complémentaires, il peut être utile de les annuler afin de pouvoir les tester à nouveau. le flux d'autorisation.

Pour annuler l'autorisation d'un module complémentaire, procédez comme suit :

  1. Ouvrez la console de sécurité de votre compte.
  2. Recherchez le module complémentaire que vous souhaitez annuler et cliquez dessus.
  3. Cliquez sur Supprimer l'accès.

Lorsque vous exécutez à nouveau le module complémentaire après l'avoir désautorisé, le flux d'autorisation s'affiche à nouveau.

Désinstaller des modules complémentaires

Pour désinstaller un module complémentaire que vous avez installé à partir de Google Workspace Marketplace, consultez Désinstaller une application ou un module complémentaire Marketplace

Pour désinstaller un module complémentaire non publié créé dans Apps Script, consultez Désinstaller un module complémentaire non publié.