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 lorsqu'ils utilisent leurs interfaces HTTP. Vous pouvez utiliser ces API comme 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 votre activité, ou du trafic vers votre site Web, 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 des 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 effectuer des calculs sur les données de 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, générer 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 les détails ou les statistiques d'une campagne vers Google Slides pour publier ces informations dans un format présentable.
Google Tasks
Votre script peut créer une liste de rappels pour des tâches futures (par exemple, générer 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).
Merchant API
Votre script peut utiliser Merchant API 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. Merchant API 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 de 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 supprimée le 18 août 2026. Utilisez plutôt Merchant API, 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 voir quelles API Google sont disponibles en tant qu'API avancées, cliquez sur API avancées dans la barre supérieure de l'éditeur 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

Vous devez tenir compte de plusieurs éléments lorsque vous utilisez les API avancées.

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 le compte Analytics auquel il accède.

Considérations concernant 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 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 ensuite supprimé du compte, tout nouvel utilisateur qui tente d'accéder au script sera invité à activer à nouveau les dépendances des API avancées et à autoriser à nouveau le script.