Les services avancés d'Apps Script permettent aux développeurs expérimentés de se connecter à certaines API Google publiques avec une configuration moindre que l'utilisation de leurs interfaces HTTP. Les services avancés sont essentiellement des wrappers légers pour ces API Google. Ils fonctionnent de la même manière services intégrés, qui offrent par exemple de saisie semi-automatique et Apps Script gère flux d'autorisation. Vous devez toutefois activer un service avancé avant vous pouvez l’utiliser dans un script.
Pour savoir quelles API Google sont disponibles en tant que services avancés, recherchez la la section Services avancés Google du Référence. Si vous souhaitez utiliser une API Google n'est pas disponible en tant que service avancé, connectez-vous à celui-ci comme n'importe quel autre API externe.
Services avancés ou HTTP ?
Chacun des services avancés de Google est associé à une API Google publique.
Dans Apps Script, vous pouvez accéder à ces API via des services avancés
les requêtes API directement à l'aide
UrlFetch
Si vous utilisez la méthode de service avancée, Apps Script gère le flux d'autorisation et offres la prise en charge de la saisie semi-automatique. Toutefois, vous devez activer le service avancé avant de pouvoir utiliser En outre, certains services avancés ne fournissent qu'une partie et des fonctionnalités disponibles dans l'API.
Si vous utilisez la méthode UrlFetch pour accéder directement à l'API, vous êtes
en considérant essentiellement l'API Google
API externe. Avec cette méthode, tous
de l'API peuvent être utilisés. Toutefois, vous devez gérer l'API
vous-même l'autorisation. Vous devez également créer les en-têtes nécessaires et analyser
les réponses de l'API.
En général, il est plus facile d'utiliser
un service avancé lorsque cela est possible et
utilisez la méthode UrlFetch lorsque le service avancé ne fournit pas
les fonctionnalités dont vous avez besoin.
Conditions requises
Pour pouvoir utiliser un service avancé, vous devez remplir les conditions suivantes : configuration requise:
- Vous devez activer le service avancé. dans votre projet de script.
Vous devez vous assurer que l'API correspondant au service avancé est activée dans le projet Cloud Platform (GCP) ; votre script utilise.
Si votre projet de script utilise un projet GCP par défaut créée à partir du 8 avril 2019, l'API est activée automatiquement après avoir activé le service avancé et enregistré le projet de script. Si vous ne l'avez pas déjà fait, il se peut que vous soyez demandé à accepter les Google Cloud et les conditions d'utilisation des API Google.
Si votre projet de script utilise un Projet GCP standard ou un ancien projet GCP par défaut, vous devez activer l'API correspondante du service avancé. manuellement dans le projet GCP. Vous devez être autorisé à modifier le projet GCP pour effectuer cette modification.
Consultez la page Projets Cloud Platform. pour en savoir plus.
Activer les services avancés
Pour utiliser un service Google avancé, procédez comme suit:
- Ouvrez le projet Apps Script.
- À gauche, cliquez sur Montage .
- Sur la gauche, à côté de Services, cliquez sur Ajouter un service.
- Sélectionnez un service Google avancé, puis cliquez sur Ajouter.
Une fois le service avancé activé, il est disponible dans la saisie semi-automatique.
Comment les signatures de méthode sont-elles déterminées ?
Les services avancés utilisent généralement les mêmes objets, noms de méthodes et paramètres que les API publiques correspondantes, bien que les signatures de méthode soient traduites dans Apps Script. L'éditeur de script fonction de saisie semi-automatique fournit généralement suffisamment d'informations pour commencer, mais les règles ci-dessous expliquent comment Apps Script génère une signature de méthode à partir d'une API Google publique.
Les requêtes adressées aux API Google acceptent différents types de données, y compris des paramètres de chemin d'accès, des paramètres de requête, un corps de requête et/ou un média importer une pièce jointe. Certains services avancés peuvent aussi accepter des requêtes HTTP spécifiques (par exemple, Service avancé Agenda).
La signature de méthode correspondante dans Google Apps Script comporte les éléments suivants : arguments:
- Le corps de la requête (généralement une ressource), en tant qu'objet JavaScript
- Chemin d'accès ou paramètres requis, sous forme d'arguments individuels.
- Pièce jointe d'importation de fichiers multimédias, sous forme de fichier
Blob. - Les paramètres facultatifs, en tant qu'objet JavaScript mappant les noms de paramètres vers valeurs.
- En-têtes de requête HTTP, en tant qu'objet JavaScript mappant les noms d'en-têtes à l'en-tête valeurs.
Si la méthode ne comporte aucun élément dans une catégorie donnée, cette partie du signature est omise.
Il existe quelques exceptions spéciales à connaître:
- Pour les méthodes qui acceptent l'importation de fichiers multimédias, le paramètre
uploadTypeest défini. automatiquement. - Les méthodes
deletedans l'API Google sont nomméesremovedans Apps Script. puisquedeleteest un mot réservé en JavaScript. - Si un service avancé est configuré pour accepter les en-têtes de requêtes HTTP et que vous définissez un objet JavaScript d'en-têtes de requête, vous devez également définir le paramètre de paramètres JavaScript (vers un objet vide si vous n'utilisez pas paramètres facultatifs).
Assistance pour les services avancés
Les services avancés sont de simples wrappers qui permettent d'utiliser dans Apps Script. Par conséquent, tout problème rencontré lors de leur utilisation est le problème concerne généralement l'API sous-jacente, et non Apps Script lui-même.
Si vous rencontrez un problème lors de l'utilisation d'un service avancé, il doit être signalées à l'aide des instructions d'assistance pour l'API sous-jacente. Liens vers ces des instructions d'assistance sont fournies dans chaque guide de service avancé Documentation de référence sur Apps Script.