Les API avancées des scripts Google Ads permettent aux développeurs de se connecter à certaines API Google publiques avec moins de configuration que s'ils utilisaient 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
- Remarque : L'API avancée
Analyticsde la boîte de dialogue API avancées cible l'API Universal Analytics v3, qui a été arrêtée. Les requêtes qui lui sont adressées échouent. Les scripts Google Ads ne sont pas compatibles avec les services avancésAnalyticsDataouAnalyticsAdminde Google Analytics 4. Pour interroger les données Google Analytics 4 à partir d'un script, envoyez des requêtes HTTPS à l'API Google Analytics Data à l'aide du serviceUrlFetchAppet d'OAuth 2.0. Vous pouvez également associer une propriété Google Analytics 4 à votre compte Google Ads pour partager directement les données de conversion sur votre site Web et dans votre application. Pour obtenir des instructions de configuration, consultez le guide de configuration d'Analytics. - 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 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 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 les 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).
- API Merchant
- Votre script peut utiliser l'API Merchant pour importer et gérer vos fiches produit, ainsi que pour gérer 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 l'API Google Content API for Shopping pour importer et gérer vos fiches produit, ainsi que pour gérer 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, 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 d'édition supérieure 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
Voici quelques points à garder à l'esprit 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
Lors de l'accès aux API avancées, un script utilise les autorisations de l'utilisateur qui l'a autorisé. L'utilisateur qui accorde l'autorisation doit disposer de l'accès requis à toutes les données dont le script a besoin. Par exemple, pour utiliser l'API avancée BigQuery, l'utilisateur qui accorde l'autorisation doit disposer des autorisations requises pour le projet Google Cloud et l'ensemble de données BigQuery cibles.
Remarques 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 :
- Cliquez sur le bouton API avancées. Dans la boîte de dialogue suivante, cliquez sur le lien vers la console Google Cloud.
- 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.
- 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é à réactiver les dépendances de l'API avancée et à autoriser à nouveau le script.