API avancées

Les API avancées des scripts Google Ads permettent aux développeurs de se connecter à certaines API Google publiques avec moins de configuration que leurs interfaces HTTP. Vous pouvez utiliser ces API de la même manière que les services intégrés des scripts. Elles offrent les mêmes avantages, comme la saisie semi-automatique et l'autorisation automatique.

Consultez notre page d'extraits de code pour obtenir des exemples d'utilisation de ces API.

API avancées disponibles

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. Cela peut vous aider à comprendre quel volume de trafic vers votre site Web ou de ventes provient de Google Ads, et à améliorer vos annonces et votre site Web. Pour en savoir plus sur l'association de comptes Analytics et Google Ads, consultez le guide du Centre d'aide Configurer Analytics pour un site Web et/ou une application.
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 l'utiliser pour analyser les données sur les performances de votre compte sur plusieurs années.
Google Agenda
Votre script peut créer des événements pour des tâches futures (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).
Google Slides
Votre script peut exporter des détails ou des statistiques sur les campagnes vers Google Slides pour publier ces informations dans un format présentable.
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).
API Merchant
Votre script peut utiliser l'API Merchant pour importer et gérer vos fiches produit, ainsi que vos comptes Google 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. L'API Merchant comporte des sous-API qui peuvent être activées individuellement dans la boîte de dialogue API avancées. Pour en savoir plus sur l'association de votre compte Google Merchant Center, consultez le guide S'inscrire en tant que développeur.
Contenu Shopping
Votre script peut utiliser Google Content API for Shopping pour importer et gérer vos fiches produit, ainsi que vos comptes Google 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. Remarque : Content API for Shopping sera abandonnée le 18 août 2026. Utilisez plutôt l'API Merchant, décrite dans la section précédente.
YouTube et YouTube Analytics
Vous pouvez récupérer et mettre à jour vos vidéos, vos playlists, etc., ainsi que les données sur les performances de vos vidéos pour prendre des décisions concernant les enchères.

Activer les API avancées

Pour afficher les API Google disponibles en tant qu'API avancées, cliquez sur API avancées dans la barre de l'éditeur en haut de la page pour afficher la boîte de dialogue API avancées. Sélectionnez les API que vous souhaitez activer.

Cliquez sur Enregistrer pour enregistrer vos sélections et revenir à l'éditeur de scripts. Les nouvelles API seront activées pour votre script et disponibles dans la liste de saisie semi-automatique.

Informations complémentaires

Lorsque vous utilisez les API avancées, vous devez tenir compte de certains points.

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 données dont le script a besoin. Si vous utilisez l'API Google Analytics, vérifiez que l'utilisateur qui a autorisé le script dispose des autorisations nécessaires pour accéder au compte Analytics.

Points à prendre en compte pour les scripts antérieurs à mai 2019

Pour les scripts créés avant mai 2019, vous devrez peut-être activer manuellement les API concernées dans le projet Google Cloud associé au script. Vous saurez si votre script est concerné si vous voyez un lien vers la console Google Cloud dans la boîte de dialogue des API avancées.

Activer les API avancées

Pour les scripts antérieurs à 2019, vous devez activer manuellement chaque API avancée que vous souhaitez utiliser dans votre script :

  1. Cliquez sur le bouton Advanced APIs (API avancées). Dans la boîte de dialogue suivante, cliquez sur le lien vers la console Google Cloud.
  2. Si votre projet n'est pas déjà sélectionné, sélectionnez-le dans la liste déroulante "Projet".
  3. Recherchez les API que vous souhaitez utiliser dans votre script en saisissant leur nom dans la barre de recherche.
  4. Sélectionnez l'API dans les résultats de recherche, puis cliquez sur le bouton "Activer" sur la page suivante.

Si l'utilisateur qui a créé le script est supprimé du compte par la suite, tout nouvel utilisateur qui tente d'accéder au script sera invité à réactiver les dépendances d'API avancées et à réautoriser le script.