Autorisation pour les services Google

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

Accorder des droits d'accès

Apps Script détermine les champs d'application des autorisations (par exemple, pour accéder à vos ou Gmail) automatiquement, après avoir scanné le code. Code qui est peut toujours générer une demande d'autorisation. Si un script a besoin l'autorisation, vous verrez l'une des boîtes de dialogue d'autorisation affichées ici exécuter.

Les scripts que vous avez précédemment autorisés demandent également si un changement de code ajoute de nouveaux services. Les scripts ne peuvent pas demander l'autorisation si vous accédez au script 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:

  1. Consultez le page autorisations pour votre compte Google. (Pour accéder à cette page, accédez à Google.com, puis cliquez sur la photo de votre compte dans le coin supérieur droit de l'écran. Cliquez ensuite sur Mon compte, puis Applications associées et des sites dans la section "Connexion et sécurité" puis sur Gérer les applications.)
  2. Cliquez sur le nom du script dont vous souhaitez révoquer l'autorisation, puis 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 selon le 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és à Docs, Sheets, Slides ou Forms Utilisateur au clavier
Fonction personnalisée dans une feuille de calcul Utilisateur anonyme ; Toutefois, les limites de quota compte pour l'utilisateur sur le clavier
Application Web ou Gadget Google Sites Utilisateur au propriétaire du clavier ou du script, en fonction de 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 Service Document Service Slides, ou dans le service Forms, vous pouvez forcer l'autorisation pour demander uniquement l'accès 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 d'un utilisateur. Pour ce faire, incluez L'annotation JsDoc suivante dans un commentaire au niveau du fichier:

/**
 * @OnlyCurrentDoc
 */

L'annotation opposée @NotOnlyCurrentDoc est disponible si votre script inclut une bibliothèque qui déclare @OnlyCurrentDoc, mais le script maître nécessite en fait d'accéder à plus de le fichier actuel.

Cycle de vie des autorisations pour les modules complémentaires

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é à un document. Dans certaines mais leurs fonctions onOpen(e) et onEdit(e) s'exécutent sans autorisation, qui présente des difficultés supplémentaires. Pour plus consultez les ce guide du cycle de vie des autorisations des modules complémentaires.

Limites utilisateur pour les applications OAuth

Applications qui utilisent OAuth pour accéder aux données utilisateur Google, y compris les applications Les projets de script sont soumis à des limites d'autorisation. Voir Limites utilisateur pour les applications OAuth pour en savoir plus.