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 vos enchères de campagne 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, 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 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, 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).

Merchant API

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 supprimé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 voir quelles API Google sont disponibles en tant qu'API avancées, cliquez sur le bouton API avancées dans la barre de l'éditeur en haut de la page.

La boîte de dialogue API avancées s'affiche. Cochez les API que vous souhaitez activer.

Cliquez ensuite sur le lien Console Google APIs pour afficher la page Console APIs 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 "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 vous voyez un bouton Désactiver , 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 Tableau de bord. Vérifiez que toutes les API avancées que vous souhaitez utiliser pour le script sont répertoriées.

Fermez maintenant la boîte de dialogue "API avancées" pour revenir à votre éditeur. Les nouvelles API seront activées pour votre script et disponibles dans la liste de saisie semi-automatique.

Considérations finales

Voici quelques éléments à garder à l'esprit lorsque vous utilisez les API avancées.

ID du projet

Chaque script Google Ads est associé à un ID de projet Google Cloud (également appelé numéro de projet). Vous pouvez trouver le numéro de projet de votre script en ouvrant la page de la console Google APIs à partir de 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 ensuite supprimé du compte, un utilisateur qui tente d'accéder au script sera invité à l'autoriser à nouveau et à configurer à nouveau les dépendances de l'API avancée. Un nouvel ID de projet Google pour les développeurs 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, vérifiez 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 APIs.

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 réapprovisionné. Vous pouvez surveiller le quota utilisé par votre script en ouvrant la console Google APIs pour le script à partir de la boîte de dialogue API avancées. La console Google APIs vous permet également de demander un quota supplémentaire pour l'API.

Facturation

Certaines API avancées nécessitent un paiement pour leur utilisation. Ces paiements sont gérés via le projet Google Cloud associé à votre script, et non via Google Ads. Pour en savoir plus sur l'activation de la facturation pour le projet Google Cloud de votre script, consultez notre documentation.