Autorisation des services Google

Apps Script nécessite l'autorisation de l'utilisateur pour accéder aux données privées des services Google intégrés ou des services Google avancés.

Octroi de droits d'accès

Apps Script détermine automatiquement les champs d'application des autorisations (tels que l'accès à vos fichiers Google Sheets ou à Gmail) en fonction d'une lecture de code. Le code commenté peut toujours générer une requête d'autorisation. Si un script nécessite une autorisation, l'une des boîtes de dialogue d'autorisation qui s'affiche ici lorsqu'il est exécuté s'affiche.

Les scripts que vous avez précédemment autorisés demandent également une autorisation supplémentaire si une modification du code ajoute des services. Les scripts ne peuvent pas demander d'autorisation si vous accédez au script en tant qu'application Web qui s'exécute sous l'identité utilisateur du propriétaire du script.

Révoquer des droits d'accès

Pour révoquer l'accès d'un script à vos données, procédez comme suit:

  1. Accédez à la page Autorisations de votre compte Google. (Pour accéder ultérieurement à cette page, accédez à Google.com, puis cliquez sur la photo de votre compte en haut à droite de l'écran. Ensuite, cliquez sur Mon compte, puis sur Applications et sites connectés dans la section " &Connexion - Sécurité", puis sur Gérer les applications.
  2. Cliquez sur le nom du script dont vous souhaitez révoquer l'autorisation. Cliquez ensuite sur Supprimer à droite, puis sur OK dans la boîte de dialogue qui s'affiche.

Autorisations et types de scripts

L'identité de l'utilisateur avec laquelle un script s'exécute, et donc les données auxquelles il peut accéder, varient en fonction du scénario d'exécution du script, comme indiqué dans le tableau ci-dessous.

Type de script Le script s'exécute en tant que...
Application autonome, module complémentaire ou liée à Docs, Sheets, Slides ou Forms Utilisateur au clavier
Fonction personnalisée dans une feuille de calcul Utilisateur anonyme ; cependant, les limites de quota sont comptabilisées au niveau du clavier
Application Web ou widget Google Sites Utilisateur du clavier ou du script du propriétaire, selon les options sélectionnées lors du déploiement de l'application
Déclencheur installable Utilisateur ayant créé le déclencheur

Champs d'application des autorisations manuelles pour Sheets, Docs, Slides et Forms

Si vous créez un module complémentaire ou un autre script utilisant le service Feuille de calcul, le service Document, le service Slides ou le service Forms, vous pouvez forcer la boîte de dialogue d'autorisation à demander uniquement l'accès aux fichiers dans lesquels le module complémentaire ou le script est utilisé, plutôt qu'à l'ensemble des feuilles de calcul, documents ou formulaires d'un utilisateur. Pour ce faire, incluez l'annotation JsDoc suivante dans un commentaire au niveau du fichier:

/**
 * @OnlyCurrentDoc
 */

Une annotation opposée, @NotOnlyCurrentDoc, est disponible si votre script inclut une bibliothèque qui déclare @OnlyCurrentDoc, mais que le script maître nécessite en réalité un accès à d'autres éléments que le fichier actuel.

Cycle de vie des autorisations des modules complémentaires

Les modules complémentaires de Google Sheets, Docs, Slides et Forms suivent généralement le même modèle d'autorisation que les scripts liés à un document. Toutefois, dans certaines circonstances, leurs fonctions onOpen(e) et onEdit(e) s'exécutent en mode sans autorisation, ce qui entraîne des complications supplémentaires. Pour en savoir plus, consultez le guide sur le cycle de vie des autorisations des modules complémentaires.

Limites d'utilisateurs d'applications OAuth

Les applications utilisant OAuth pour accéder aux données utilisateur Google, y compris les projets Apps Script, sont soumises à des limites d'autorisation. Pour en savoir plus, consultez Limites d'utilisateurs d'applications OAuth.