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 niveaux d'autorisation (comme l'accès à vos fichiers Google Sheets ou à Gmail) en fonction d'une analyse du code. Le code mis en commentaire peut toujours générer une demande d'autorisation. Si un script nécessite une autorisation, l'une des boîtes de dialogue d'autorisation affichées ici s'affichera lorsqu'il sera exécuté.
Les scripts que vous avez déjà autorisés demandent également une autorisation supplémentaire si une modification du code ajoute de nouveaux services. Les scripts ne peuvent pas demander d'autorisation si vous y accédez en tant qu'application Web s'exécutant sous l'identité utilisateur du propriétaire du script.
Révoquer les droits d'accès
Pour révoquer l'accès d'un script à vos données, procédez comme suit :
- Accédez à la page Autorisations de votre compte Google. (Pour accéder à cette page à l'avenir, accédez à Google.com, puis cliquez sur la photo de votre compte en haut à droite de l'écran. Cliquez ensuite sur Mon compte, puis sur Applications et sites associés dans la section "Connexion et sécurité", puis sur Gérer les applications.)
- Cliquez sur le nom du script dont vous souhaitez révoquer l'autorisation, puis 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 dans lequel le script est exécuté, comme indiqué dans le tableau ci-dessous.
| Type de script | Le script s'exécute en tant que… |
|---|---|
| Autonome, module complémentaire ou associé à Docs, Sheets, Slides ou Forms | Utilisateur au clavier |
| Fonction personnalisée dans une feuille de calcul | Utilisateur anonyme ; toutefois, les limites de quota sont comptabilisées pour l'utilisateur au clavier. |
| Application Web ou gadget Google Sites | Utilisateur au clavier ou propriétaire du script, selon les options sélectionnées lors du déploiement de l'application |
| Déclencheur installable | Utilisateur ayant créé le déclencheur |
Niveaux d'autorisation manuelle pour Sheets, Docs, Slides et Forms
Si vous créez un module complémentaire ou un autre script qui utilise les services 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 qu'à toutes les feuilles de calcul, tous les documents ou tous les 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 principal nécessite en fait d'accéder à plus que le fichier actuel.
Cycle de vie de l'autorisation 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 associés à un document. Toutefois, dans certaines circonstances, leurs fonctions onOpen(e) et onEdit(e) s'exécutent en mode sans autorisation, ce qui présente quelques complications supplémentaires. Pour en savoir plus, consultez le guide sur le cycle de vie de l'autorisation des modules complémentaires.
Limites d'utilisateurs 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 Limites d'utilisateurs pour les applications OAuth.
Comportement de réauthentification avec Apps Script
Apps Script n'applique pas la fréquence de réauthentification que vous configurez dans vos paramètres Google Cloud Services. En effet, Apps Script peut s'exécuter automatiquement à l'aide de déclencheurs, qui fonctionnent sans interaction directe de l'utilisateur. Ces exécutions automatisées ne déclenchent pas les invites de réauthentification. Votre application Apps Script ne vous demandera pas automatiquement de vous réauthentifier après la période que vous avez spécifiée (par exemple, 12 heures).