Présentation des services
Qu’est-ce qu’un service dans Google Apps Script ?
Avec Google Apps Script, un service est un ensemble de fonctionnalités prêtes à l’emploi, accessibles via un objet global. Ces services permettent d’interagir facilement avec des outils Google ou avec des fonctionnalités plus générales du script.
Google Apps Script offre plus de trente services intégrés pour interagir avec les données des utilisateurs, d’autres systèmes Google et des systèmes externes. Ces services sont fournis sous forme d’objets globaux, similaires à l’objet standard JavaScript Math. Par exemple, tout comme Math propose des méthodes telles que random() et des constantes telles que PI, le service Spreadsheet d’Apps Script propose des méthodes comme openById(id), des classes (objets enfants) telles que Range et des énumérations du type DataValidationCriteria.
La documentation de référence pour les services qui contrôlent les produits Google Workspace est rassemblée dans la section Google Workspace services sous l’en-tête Reference dans la barre latérale de ce site. Les services utilitaires (pour des tâches telles que la création d’interfaces utilisateur, l’analyse de fichiers XML ou l’écriture de données de journaux) sont regroupés dans...
La puissance des services Google Apps Script
Google Apps Script tire toute sa puissance de ces services intégrés.
Ils permettent d’interagir de façon fluide avec les produits Google et d’accéder à une large gamme de fonctionnalités. Grâce à eux, l’automatisation des tâches devient simple et intuitive.
Ces services offrent la possibilité de manipuler des données utilisateur, d’accéder à d’autres services Google ou encore de communiquer avec des systèmes externes. Ils sont accessibles sous forme d’objets globaux, comparables aux objets natifs de JavaScript comme Date.
Par exemple, tout comme l’objet Date propose des méthodes telles que getFullYear(), le service SpreadsheetApp offre des méthodes comme openById(), ainsi que des classes enfants telles que Range, ou des énumérations du type DataValidationCriteria.
1. Appeler des méthodes de service
Les objets globaux des services intégrés (et avancés) offrent une multitude de méthodes permettant d’effectuer des actions ou de récupérer des données. La syntaxe pour appeler une méthode est simple et suit le schéma suivant :

Par exemple, pour ouvrir une feuille de calcul spécifique dans Google Sheets, vous pouvez utiliser la méthode openById() du service SpreadsheetApp :

Ici...
Les services avancés
En plus des services intégrés et utilitaires, Google Apps Script propose une catégorie supplémentaire appelée services avancés. Ces services permettent d’accéder aux API REST officielles de Google, mais via une interface JavaScript familière, directement dans votre script.
Ils fonctionnent comme les services intégrés, mais nécessitent une activation manuelle depuis l’éditeur Apps Script.

1. Caractéristiques des services avancés
Les services avancés d’Apps Script permettent d’interagir avec les mêmes API que celles utilisées en externe via REST ou OAuth, mais directement depuis l’environnement de développement.
Ils offrent souvent des fonctionnalités plus complètes ou plus spécifiques que les services intégrés. Chaque service avancé suit une convention de nommage reconnaissable, comme Drive, Analytics ou Gmail. Par exemple, avec Drive, vous pouvez accéder à des méthodes avancées telles que Drive.Files.list() pour obtenir la liste détaillée des fichiers de votre Drive, avec de nombreux paramètres de filtrage.
Quelques exemples de services avancés :
-
Drive : accès étendu aux fonctionnalités de l’API Google Drive (différent de DriveApp).
-
Gmail : permet d’accéder à des fonctionnalités Gmail plus précises que GmailApp.
-
AdminDirectory : utilisé pour interagir avec les utilisateurs, groupes et unités organisationnelles d’un domaine Google Workspace.
-
Analytics : pour récupérer des rapports et données de Google Analytics....