Autorisation

Les modules complémentaires requièrent l'autorisation de l'utilisateur avant de pouvoir fonctionner. Cela s'applique à la fois aux modules complémentaires publiés que vous avez installés à partir de Google Workspace Marketplace et à ceux que vous développez vous-même.

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 nécessaires au fonctionnement du module complémentaire s'affiche afin que vous sachiez ce qu'il tente de faire. Lisez attentivement cette liste et, si vous souhaitez toujours accorder l'autorisation, cliquez sur Autoriser. Cela permet d'activer le module complémentaire.
  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 de navigateur, vous devrez peut-être actualiser cet onglet avant que le module complémentaire ne soit disponible.

Si le module complémentaire que vous avez installé est mis à jour par la suite et nécessite des autorisations supplémentaires que vous n'avez pas encore accordées, vous serez invité à fournir ces autorisations la prochaine fois que vous utiliserez le module complémentaire.

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

Carte d'autorisation complémentaire

Les modules complémentaires non publiés ne bénéficient pas du même flux d'autorisation que ceux publiés, car ils ne sont pas encore listés sur Google Workspace Marketplace. Après avoir installé un module complémentaire non publié, vous n'êtes pas immédiatement invité à donner votre autorisation. Au lieu de cela, le flux d'autorisation démarre lorsque vous tentez pour la première fois d'utiliser le module complémentaire.

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 carte d'autorisation. L'autorisation est toujours requise lors de la première exécution d'un module complémentaire, ou peut également l'être si une nouvelle version du module complémentaire utilise un service non autorisé précédemment. Le bouton Autoriser l'accès affiche une boîte de dialogue permettant à l'utilisateur 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 lui-même nécessite une autorisation. Les 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 proprement dit lors de son installation ou de son premier démarrage.
  • 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 via OAuth, vous devez configurer la connexion pour ce service lors de la création du module complémentaire.

Lorsque l'autorisation d'un service autre que Google est requise, le module complémentaire Google Workspace présente à l'utilisateur une carte d'invite d'autorisation pour ce service. Vous pouvez personnaliser cette invite d'autorisation si vous le souhaitez ou utiliser la carte par défaut.

Pour en savoir plus, consultez le guide Se connecter à des services autres que Google.

Systèmes de visioconférence tiers

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

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

À la réception de cet objet, Google Agenda crée un bouton SE CONNECTER dans l'interface utilisateur de modification des événements. Ce bouton est associé à 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 la section Créer des conférences tierces pour en savoir plus sur la gestion des autorisations à l'aide de ConferenceError.

Autoriser des modules complémentaires des éditeurs non publiés

Il est recommandé de tester les modules complémentaires des éditeurs lorsque vous les développez. Le flux d'autorisation est identique à celui des modules complémentaires d'éditeur publiés, si ce n'est qu'ils démarrent lorsque vous essayez pour la première fois de tester le module complémentaire. Si vous testez à nouveau le même module complémentaire par la suite, l'autorisation ne vous sera plus demandée.

Annulation de l'autorisation de modules complémentaires

Lorsque vous développez des modules complémentaires, il peut être utile d'annuler leur autorisation afin de pouvoir 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 l'autorisation, puis cliquez dessus.
  3. Cliquez sur SUPPRIMER L'ACCÈS.

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