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 leurs interfaces HTTP. Vous utilisez 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.
Utilisations possibles des API avancées
- Google Analytics 4
- Vous pouvez utiliser Google Analytics 4 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 4 à 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 du trafic de votre site Web ou de vos ventes imputable à Google Ads, et vous permettre d'améliorer vos annonces et votre site Web. Pour en savoir plus sur l'association des comptes Analytics et Google Ads, consultez Google Analytics 4.
- 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 de performances de votre compte sur plusieurs années.
- 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.
- 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).
- 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 des détails ou des statistiques sur les campagnes vers Google Slides pour 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'outils 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.
Ensuite, cliquez sur le lien Console Google APIs 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 "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 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
Lorsque vous utilisez les API avancées, vous devez garder certains points à l'esprit.
ID du projet
Chaque script Google Ads est associé à un numéro de projet Google Cloud (également appelé "ID 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. Il est associé à l'utilisateur qui a créé le script Google Ads. Si l'utilisateur qui a créé le script est supprimé du compte par la suite, 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 Developer sera également créé. 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'un script accède aux API, il 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 accéder au compte Analytics.
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 APIs vous permet également de demander un quota supplémentaire pour l'API.
Facturation
Certaines API avancées nécessitent le paiement de frais d'utilisation. Ces paiements sont gérés par le biais du projet Google Cloud associé à votre script, et non par le biais de Google Ads. Pour en savoir plus sur l'activation de la facturation pour le projet Google Cloud de votre script, consultez notre documentation.