Les API avancées des scripts Google Ads permettent aux développeurs expérimentés de se connecter à certaines API Google publiques avec moins de configuration que via leurs interfaces HTTP. Vous utilisez ces API comme les services intégrés des scripts. Elles offrent les mêmes commodités, comme la saisie semi-automatique et l'autorisation automatique.
Utilisations possibles des API avancées
- Google Analytics
- Vous pouvez utiliser Google Analytics pour suivre le trafic vers votre site Web et ajuster les enchères de vos campagnes en conséquence. Si vous associez une propriété Google Analytics à votre compte Google Ads, vous pouvez également analyser l'activité des clients sur votre site Web. Ces informations peuvent vous aider à déterminer la part de votre activité ou du trafic de votre site Web imputable à Google Ads, et vous permettre d'améliorer vos annonces et votre site Web. Pour en savoir plus sur l'association de comptes Analytics et Google Ads, consultez notre Centre d'aide.
- Google BigQuery
- Vous pouvez charger de grandes quantités de données dans Google Cloud Storage, puis les interroger à l'aide de Google BigQuery. Par exemple, vous pouvez charger des données météorologiques publiques pour les 10 dernières années, puis interroger la température moyenne d'une région dans un script qui utilise ces informations pour ajuster les enchères. Vous pouvez également utiliser les données de performances de votre compte sur plusieurs années pour effectuer des calculs.
- YouTube et YouTube Analytics
- Vous pouvez récupérer et mettre à jour vos vidéos, playlists, etc., ainsi que les données sur les performances de vos vidéos pour prendre des décisions concernant les enchères.
- Google Agenda
- Votre script peut créer des événements pour de futures tâches (par exemple, exécuter un rapport sur les performances de vos campagnes dans deux semaines) ou effectuer des actions en fonction d'une entrée que vous avez créée dans votre agenda (par exemple, activer une campagne à une date spécifique).
- Shopping Content
- Votre script peut utiliser Google Content API for Shopping dans Apps Script. Cette API permet aux utilisateurs de Google Merchant Center d'importer et de gérer leurs fiches produit, ainsi que leurs comptes Merchant Center. Dans les scripts, cela peut être utile pour vérifier les fiches produit et associer des produits spécifiques à des annonces spécifiques.
- Google Tasks
- Votre script peut créer une liste de rappels pour les tâches à venir (par exemple, exécuter un rapport sur les performances de vos campagnes dans deux semaines) ou effectuer des actions en fonction d'une entrée que vous avez créée dans votre liste de rappels (par exemple, activer une campagne à une date spécifique).
- Google Slides
- Votre script peut exporter les détails ou les statistiques de la campagne vers Google Slides afin de publier ces informations dans un format présentable.
Activer les API avancées
Pour voir quelles API Google sont disponibles en tant qu'API avancées, cliquez sur le bouton API avancées dans la barre d'éditeur supérieure.
La boîte de dialogue API avancées s'affiche. Cochez les API que vous souhaitez activer.
Cliquez ensuite sur le lien Google API Console pour afficher la page Console API dans la console, avec le projet associé à votre script. Si votre projet n'est pas déjà sélectionné, sélectionnez-le dans la liste déroulante "Project" (Projet). Recherchez les API que vous souhaitez utiliser dans votre script en saisissant leur nom dans la barre de recherche.
Dans les résultats de recherche, sélectionnez l'API, puis sur la page suivante, choisissez Activer. Si un bouton Désactiver s'affiche, cela signifie que cette API est déjà activée. Répétez cette action pour chaque API que vous souhaitez activer.
Pour afficher la liste des API activées pour le projet, sélectionnez la page Dashboard (Tableau de bord). Vérifiez que toutes les API avancées que vous souhaitez utiliser pour le script sont listées.
Fermez maintenant la boîte de dialogue "API avancées" pour revenir à l'éditeur. Les nouvelles API seront activées pour votre script et disponibles dans la liste de saisie semi-automatique.
API disponibles
Les API suivantes sont disponibles:
| Nom d'API | Documentation |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Google Agenda | https://developers.google.com/apps-script/advanced/calendar |
| Google Slides | https://developers.google.com/apps-script/advanced/slides |
| Google Tasks | https://developers.google.com/apps-script/advanced/tasks |
| Shopping Content | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| YouTube Analytics | https://developers.google.com/apps-script/advanced/youtube-analytics |
Vous pouvez également consulter notre page d'extraits de code pour obtenir des exemples d'utilisation de ces API.
Considérations finales
Vous devez garder certains points à l'esprit lorsque vous utilisez les API avancées.
ID du projet
Chaque script Google Ads est associé à un ID de projet Google Cloud Platform (également appelé numéro de projet). Pour trouver le numéro de projet de votre script, ouvrez la page de la console Google APIs depuis la boîte de dialogue API avancées. Cet ID de projet est créé lorsque vous créez le script et est associé à l'utilisateur qui a créé le script Google Ads. Si l'utilisateur qui a créé le script est supprimé ultérieurement du compte, un utilisateur qui tente d'y accéder sera invité à le réautoriser et à configurer à nouveau les dépendances d'API avancées. Un nouvel ID de projet de développeur Google sera également créé, et vous devrez configurer à nouveau les API avancées, comme expliqué précédemment dans ce document.
Dépendances
Seul l'utilisateur qui a créé le script dans le compte peut modifier les dépendances des API avancées pour ce script.
Autorisations
Lorsqu'il accède aux API, un script utilise les autorisations de l'utilisateur qui l'a autorisé. Assurez-vous que l'utilisateur qui a autorisé le script dispose de l'accès requis à toutes les API avancées utilisées, ainsi qu'aux données dont le script a besoin. Si vous utilisez l'API Google Analytics, assurez-vous que l'utilisateur qui a autorisé le script dispose des autorisations nécessaires pour le compte Analytics auquel il accède.
Conditions d'utilisation
Chacune des API avancées peut avoir ses propres conditions d'utilisation que vous devez accepter lorsque vous activez l'API dans la console Google API.
Quota
La plupart des API avancées sont associées à un quota quotidien sans frais. Une fois que votre script dépasse ce quota, l'API cesse de fonctionner jusqu'à ce que vous demandiez des données supplémentaires ou que le quota sans frais soit renouvelé. Vous pouvez surveiller le quota utilisé par votre script en ouvrant la console Google API pour le script à partir de la boîte de dialogue API avancées. La console Google API vous permet également de demander un quota supplémentaire pour l'API.
Facturation
L'utilisation de certaines API avancées nécessite le paiement de frais. Ces paiements sont gérés via le projet Google Cloud Platform associé à votre script, et non via Google Ads. Pour savoir comment activer la facturation pour le projet Google Cloud Platform de votre script, consultez notre documentation.