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.
Accorder des droits d'accès
Apps Script détermine automatiquement les champs d'application des autorisations (par exemple, pour accéder à vos fichiers Google Sheets ou à Gmail) en fonction d'une analyse du code. Le code mis en commentaire 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 affichées ici s'affiche lors de son exécution.
Les scripts que vous avez précédemment autorisés demandent également une autorisation supplémentaire si de nouveaux services sont ajoutés à une modification du code. Les scripts ne peuvent pas demander d'autorisation si vous y accédez en tant qu'application Web qui s'exécute sous l'identité de l'utilisateur du propriétaire du script.
Révocation des droits d'accès...
Pour révoquer l'accès d'un script à vos données, procédez comme suit:
- Accédez à la page des autorisations de votre compte Google. Pour accéder à cette page à l'avenir, rendez-vous sur 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 et sécurité", et enfin sur Gérer les applications.)
- Cliquez sur le nom du script dont vous souhaitez révoquer l'autorisation, cliquez 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) varie 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... |
|---|---|
| Autonome, module complémentaire ou lié à Docs, Sheets, Slides ou Forms | Utilisateur au clavier |
| Fonction personnalisée dans une feuille de calcul | Utilisateur anonyme ; cependant, les limites de quota sont prises en compte pour l'utilisateur au niveau du clavier |
| Application Web ou gadget Google Sites | Utilisateur du propriétaire du clavier ou du script, qui dépend des 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 qui utilise le service Spreadsheet, Document, Slides ou Forms, vous pouvez forcer la boîte de dialogue d'autorisation à ne demander l'accès qu'aux fichiers dans lesquels le module complémentaire ou le script est utilisé, plutôt que l'ensemble des feuilles de calcul, documents ou formulaires de l'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 pour les modules complémentaires
Les modules complémentaires pour 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 certains cas, leurs fonctions onOpen(e) et onEdit(e) s'exécutent en mode sans autorisation, ce qui pose problème. Pour en savoir plus, consultez le guide du cycle de vie des autorisations des modules complémentaires.
Limites utilisateur pour les applications OAuth
Les applications qui utilisent 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 la section Limites utilisateur des applications OAuth.