Installer et autoriser des modules complémentaires

Les utilisateurs doivent installer et autoriser un module complémentaire peuvent 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

Pour 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 le 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 pour la première fois, vous devez autoriser

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

Autoriser les modules complémentaires

Une fois le module complémentaire installé, il devient disponible dans Google Workspace application hôte qu'elle s'étend. La première fois qu'un utilisateur tente d'utiliser la sur l'application hôte leur présente un ensemble de d'autorisation ou de la boîte de dialogue. Cette fiche explique a besoin d'une autorisation pour effectuer des actions pour l'utilisateur, par exemple d'accéder au contenu de la feuille de calcul Google Sheets 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 de module complémentaire.

Les modules complémentaires des éditeurs utilisent un modèle d'autorisation différent de Modules complémentaires Google Workspace. Étant donné que les modules complémentaires des éditeurs fonctionnent sur les fichiers Google Drive, le de l'éditeur définit les différents modes d'autorisation qui apparaissent les modules complémentaires sont utilisés avec des fichiers individuels. Lors du développement des modules complémentaires de l'éditeur, il est important de comprendre et comment les modules complémentaires se déplacent de l'un à l'autre.

Autoriser la publication de modules complémentaires

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. Cette opération permet d'activer le module complémentaire.
  3. Vous pouvez maintenant l'exécuter application hôte qu'elle s'étend. Si l'application était déjà ouverte dans un onglet de navigateur, vous pouvez vous devrez 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

Carte d'autorisation pour les modules complémentaires

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 installer 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 utilisateur est nécessaire. Si est nécessaire, le module complémentaire présente une carte d'autorisation. L'autorisation est toujours requise lors de la première exécution d'un module complémentaire, et peut également Obligatoire si une nouvelle version du module complémentaire utilise un service qui n'a pas encore été utilisé autorisé. Le bouton Autoriser l'accès affiche une boîte de dialogue pour l'option d'autoriser ou de refuser l'autorisation pour le module complémentaire.

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 vous avez besoin d'un module complémentaire Google Workspace pour accéder à un service autre que Google via OAuth, vous devez configurer la connexion pour ce service lors de la création du module complémentaire.

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

Systèmes de conférence tiers

Modules complémentaires Google Workspace pour enrichir Google Agenda vous pouvez aussi ajouter solutions de conférence permettant aux utilisateurs de sélectionner un système de conférence tiers des événements Google Agenda. Si votre module complémentaire propose des options de conférence qui exiger que l'utilisateur se connecte, votre module complémentaire doit lui permettre pour ce 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'UI de modification d'événement qui renvoie vers l'URL d'authentification fournie par le module complémentaire. Les utilisateurs peuvent alors utiliser ce bouton pour se connecter au système tiers avant à l'aide du 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 pour les modules complémentaires de l'éditeur publiés, à la différence près que le flux démarre lorsque vous essayez de tester le module complémentaire pour la première fois. Si, par la suite, vous testez à nouveau le même vous n'êtes plus invité à confirmer l'autorisation.

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 annulé, le flux d'autorisation est présenté à nouveau.