Vous souhaitez nous faire part de vos commentaires sur l'API Google Ads ? Inscrivez-vous pour être invité à participer à des recherches sur l'expérience utilisateur.

Cette page a été traduite par l'API Cloud Translation.

Checklist de démarrage Google Ads pour les développeurs

Cette checklist vous explique comment commencer à utiliser l'API Google Ads. Les étapes sont divisées en plusieurs catégories, certaines d'entre elles pouvant être ignorées si elles ne sont pas adaptées à vos besoins. Pour tirer le meilleur parti de ce document, lisez et exécutez les étapes dans l'ordre.

La liste contient trois types d'éléments:

	À faire:étapes requises pour effectuer une tâche spécifique ou configurer une partie de votre outil.
	Info:informations qui ne sont pas essentielles au processus, mais qui vous aideront à comprendre le contexte ou à clarifier certaines étapes.
	Avertissement:Éléments à prendre en compte tout au long du processus, car ils peuvent impliquer des efforts d'implémentation supplémentaires ou entraîner certains risques.

Si vous imprimez la checklist, vous pouvez utiliser les cases à cocher sur la gauche pour indiquer les étapes terminées. Cette checklist fournit un ordre de lecture recommandé pour les informations figurant dans la documentation de l'API Google Ads.

Accès et configuration

	Obtenez votre jeton de développeur dans le Centre API de votre compte administrateur de niveau supérieur. Tous les champs du formulaire d'accès à l'API doivent être remplis et les conditions d'utilisation doivent être acceptées. Assurez-vous que l'adresse e-mail de contact de l'API que vous fournissez mène à une boîte de réception régulièrement surveillée. Vous recevrez un jeton de développeur avec le niveau d'accès du compte de test.
	C'est tout ce dont vous avez besoin pour tester l'API Google Ads avec des comptes de test. Vous pouvez utiliser des comptes de test pour créer des campagnes et des annonces, mais aucune de vos annonces ne sera diffusée (frais générés) et toutes les statistiques des rapports seront nulles. Pour que votre jeton de développeur puisse accéder aux comptes de production, il doit être approuvé par notre équipe d'examen des jetons.
	Pour obtenir l'approbation de votre jeton pour un accès en production, vous devez remplir notre formulaire de demande de suivi et expliquer comment vous comptez utiliser l'API. Vous devrez également fournir un document de conception. Vous pouvez utiliser notre modèle pour vous lancer. Soyez le plus précis possible. Notre équipe chargée de l'examen des jetons vous contactera si elle a besoin d'informations supplémentaires. Vous pouvez également nous contacter via notre formulaire de contact si vous ne recevez pas de réponse dans un délai de deux jours ouvrés.
	Une fois votre jeton de développeur approuvé, vous pouvez l'utiliser pour effectuer des appels d'API vers des comptes de production. Vous bénéficiez d'abord d'un accès de base, qui vous permet d'effectuer 15 000 opérations par jour et une limite de 1 000 opérations de récupération par jour.
	Si votre demande est refusée, vous recevrez un e-mail vous en indiquant les raisons. Vous pouvez modifier votre demande, fournir plus d'informations sur votre solution et renvoyer votre demande.

Configurer une bibliothèque cliente

	Nous utilisons OAuth 2.0 pour authentifier vos requêtes auprès de l'API. Suivez les instructions de notre guide OAuth 2.0 pour configurer les identifiants OAuth 2.0. Pour résoudre les problèmes, vous pouvez utiliser OAuth 2.0 Playground.
	Nous fournissons des bibliothèques clientes pour certains langages de programmation courants. Téléchargez la bibliothèque pour la langue que vous souhaitez utiliser et configurez son fichier de configuration avec les identifiants que vous avez obtenus précédemment.

Jeton de développeur – Niveaux d'accès

Découvrez les niveaux d'accès et décidez si votre outil nécessitera plus de 15 000 opérations par jour à l'avenir. Si c'est le cas, vous devrez demander un accès standard pour un nombre illimité d'opérations mutate et de requêtes GoogleAdsService.Search et GoogleAdsService.SearchStream par jour. Toutefois, cette limite est toujours soumise à la limite quotidienne de 1 000 opérations get.

Consultez le tarif pour comprendre comment les opérations sont calculées pour votre niveau d'accès. Remarque : Les requêtes GoogleAdsService.Search avec le champ page_token défini ne sont pas comptabilisées dans la limite d'opérations.

Fonctionnalités minimales requises

	Découvrez les fonctionnalités minimales requises (FMR), qui sont un ensemble de fonctions que votre outil doit implémenter en fonction de sa nature.
	Les outils compatibles avec l'accès de base (moins de 15 000 requêtes par jour) sont exemptés de RMF. Les outils auxquels les annonceurs n'ont pas accès et qui sont destinés à un usage interne uniquement sont exemptés de la RMF. Si votre outil ne crée que des rapports, seul le RMF de création de rapports s'applique. Si votre outil est très limité et spécialisé, par exemple Shopping ou Promotion d'applications uniquement, seule la partie du RMF utilisée par votre outil s'applique. Si vous ne savez pas si les FMR sont applicables à votre outil, contactez l'équipe chargée du respect des règles concernant l'API Google Ads.
	Consultez les frais de non-conformité pour savoir ce qu'il se passe lorsque les RMF ne sont pas correctement implémentées.
	Si votre outil est destiné à être utilisé en dehors de votre organisation (c'est-à-dire qu'il ne s'agit pas d'un outil interne), il doit implémenter les RMF applicables avant de demander un accès standard. N'oubliez pas que la RMF est susceptible d'évoluer au fur et à mesure que l'API évolue. Si vous décidez de demander un accès standard, vous devrez mettre à jour votre outil avec les dernières FMR.
	Assurez-vous que votre outil implémente les RMF applicables.
	Demandez un accès standard.

Commencer à utiliser l'API

	Consultez Effectuer votre premier appel d'API, qui explique comment obtenir des campagnes à l'aide de l'API. Tous les objets sont accessibles de la même manière. Il est donc utile de mémoriser la structure.
	Découvrez la structure de base de l'API des ressources et des services.
	Consultez Modifier et inspecter des objets et Récupérer des objets.
	Consultez la section Métadonnées de ressources pour savoir comment les demander de manière dynamique.
	Consultez la présentation des campagnes pour créer et gérer différents types de campagnes et d'annonces.

Exemples de code

	Consultez et exécutez notre exemple de code pour comprendre comment utiliser l'API. Nous vous recommandons d'exécuter au moins les exemples suivants pour comprendre comment gérer les objets Google Ads de base.
	Opérations de base > Obtenir des campagnes
	Opérations de base > Obtenir des annonces textuelles étendues
	Opérations de base > Ajouter des campagnes
	Opérations de base > Ajouter des mots clés
	Opérations de base > Modifier un mot clé
	Gestion des campagnes > Obtenir toutes les annonces refusées
	Gestion des campagnes > Ajouter un modificateur d'enchères de campagne
	Gestion des comptes > Obtenir des informations sur le compte
	Gestion de compte > Créer un client
	Gestion des comptes > Télécharger les modifications apportées au compte

Rapports

	Pour créer des rapports, vous devez utiliser un compte qui diffuse des annonces depuis suffisamment de temps pour générer des métriques de performances (nous vous recommandons au moins sept jours).
	Découvrez un aperçu rapide des rapports et un exemple pour résumer les performances d'un compte au cours des 30 derniers jours en utilisant GoogleAdsService comme source unique de vérité pour les rapports Google Ads.
	Consultez le langage de requêtes Google Ads (GAQL) pour comprendre la grammaire et la structure des requêtes, ainsi que les concepts de ressource, de segment et de métrique.
	Découvrez les métriques de critères pour savoir comment récupérer les données de performances pour différents critères à l'aide de ressources `*_view`, par exemple KeywordView, TopicView et GenderView.

Générateur de requêtes Google Ads interactif

	Découvrez les fonctionnalités disponibles dans l'outil de développement Générateur de requêtes Google Ads interactif. Cet outil Web recherche tous les champs et filtres disponibles pour la ressource sélectionnée, puis génère les requêtes de manière interactive.
	Utilisez l'éditeur de cet outil pour créer une instruction Google Ads Query Language pour une ressource spécifique, par exemple un groupe d'annonces. Copiez et collez l'instruction GAQL générée dans votre application.

Recherche de mots clés

Si vous ne connaissez pas notre Outil de planification des mots clés, essayez-le pour découvrir comment fonctionne la planification des mots clés dans l'interface utilisateur de Google Ads.

Exemples de code

	Découvrez les fonctionnalités de planification des mots clés en exécutant les exemples de code ci-dessous.
	Planning Samples -> Generate Forecast Metrics (Exemples de planification -> Générer des métriques de prévision)
	Exemples de planification -> Générer des idées de mots clés

Automatiser les budgets

	Consultez les modes et paramètres de paiement pour découvrir les options de facturation disponibles dans Google Ads, comme les paiements automatiques, les paiements manuels et la facturation mensuelle (limite de crédit).
	Si vous n'utilisez pas la facturation mensuelle et que vous ne prévoyez pas de l'activer, vous pouvez ignorer cette section.
	Consultez la section Configuration de la facturation pour découvrir comment gérer les profils de paiement et les comptes de paiement de manière programmatique.
	Découvrez le budget du compte pour comprendre comment les budgets peuvent être attribués automatiquement aux comptes.
	Pour utiliser AccountBudgetProposalService, vous devez ajouter votre compte administrateur Google Ads à la liste d'autorisation à cet effet. Vous ne pourrez pas utiliser ce service tant que ce processus n'aura pas été effectué. Vous devez également avoir configuré la facturation mensuelle avec Google. Contactez votre responsable des partenariats stratégiques (RPS) chez Google pour organiser ce processus. L'accès est réservé aux partenaires Google.
	Contactez votre représentant Google pour demander à être inscrit au système de facturation mensuelle.
	Contactez votre représentant Google pour demander l'accès à AccountBudgetProposalService.
	Créez un AccountBudgetProposal et attribuez-le à un compte. Essayez d'utiliser le budget en conjonction avec un budget de campagne.

Annonces Shopping

	Si vous souhaitez utiliser les annonces Shopping, vous devrez probablement utiliser Google Merchant Center et sa Content API for Shopping pour gérer les données produit. Cette section décrit les étapes de base à suivre pour commencer à utiliser cette API.
	Configurez un compte Merchant Center et obtenez un MerchantID.
	Obtenez une clé de compte de service si votre application n'a besoin que d'accéder à votre propre compte Merchant Center. Toutefois, si vous écrivez une application tierce qui doit accéder aux comptes Merchant Center de vos clients, consultez le guide Autoriser les requêtes avec OAuth 2.0.
	Téléchargez une bibliothèque cliente dans la langue de votre choix.
	Consultez les exemples de code de l'API Content pour Java, .NET, PHP, Python, etc.
	Découvrez comment associer manuellement des comptes Merchant Center et Google Ads.
	Découvrez comment configurer votre liste de produits à l'aide de Content API.
	Consultez le guide Créer une campagne Shopping à l'aide de l'API Google Ads.

Recommandations et modification de l'état

	Si vous ne connaissez pas les fonctionnalités Recommandations et Historique des modifications, essayez-les dans l'interface utilisateur de Google Ads.
	L'API Google Ads fournit deux services qui reflètent ces fonctionnalités. RecommendationService propose des recommandations d'optimisation avec un impact estimé, tandis que ChangeStatusService extrait l'historique des modifications de votre compte, qui peut être utilisé à plusieurs fins, telles que la synchronisation des copies locales, l'audit simple, etc.

RecommendationService

	Consultez notre guide sur l'utilisation de RecommendationService pour récupérer et appliquer les recommandations de Google à votre compte afin d'améliorer les performances globales de vos annonces.
	Découvrez les fonctionnalités de recommandation en exécutant cet exemple de code : Exemples de recommandations -> Obtenir des recommandations pour les annonces textuelles.

ChangeStatusService

	Consultez notre guide sur l'utilisation de ChangeStatusService pour récupérer l'historique des modifications et suivre les modifications apportées à votre compte, telles que les campagnes et les annonces.
	Découvrez les fonctionnalités de l'historique des modifications en exécutant cet exemple de code : Exemples ChangeStatus -> Get Account Changes.

Rester à jour

Mettez à jour votre code en fonction des modifications apportées à l'API Google Ads.

Gestion des versions

	Lorsque l'abandon d'une version majeure précédente est annoncé, elle n'est plus prise en charge et les appels d'API effectués à l'aide d'une version antérieure de l'API échouent. N'oubliez pas de vous tenir informé de l'API en suivant les étapes ci-dessous.
	Lorsqu'une nouvelle API est publiée, obtenez la dernière version de notre bibliothèque cliente.
	Ajoutez un favori aux dernières notes de version et examinez les principales modifications apportées à chaque version.
	Remplacez les appels à la version antérieure de la bibliothèque cliente par des appels à la nouvelle version.
	Suivez ce blog pour vous abonner à notre flux RSS et recevoir les articles par e-mail, et consultez le forum pour obtenir les dernières informations sur l'API Google Ads.
	Assurez-vous que l'adresse e-mail de contact de l'API enregistrée dans le Centre API de votre compte administrateur principal est à jour. C'est ainsi que nous vous contacterons si nous détectons des problèmes techniques liés à votre utilisation de l'API.

Produits Google liés aux annonces

	Google Merchant Center	Google Merchant Center vous permet d'importer les données concernant vos produits et votre magasin sur Google, afin de les rendre disponibles pour les annonces Shopping et les autres services Google.
	Fiche d'établissement	Votre fiche d'établissement vous permet de toucher et d'engager vos clients locaux dans la recherche Google et sur Maps.
	Google Analytics	Google Analytics fournit des rapports détaillés sur l'utilisation de votre site Web par les internautes. Vous pouvez utiliser Google Analytics pour savoir ce que font les utilisateurs après avoir cliqué sur vos annonces.
	Google Tag Manager	Google Tag Manager est un système de gestion de balises (TMS, Tag Management System) qui vous permet de mettre à jour rapidement les codes de suivi et les fragments de code qui s'y rapportent (collectivement appelés "balises") sur votre site Web ou dans votre application mobile.
	Google Optimize	Google Optimize propose des outils de test A/B, de test de site Web et de personnalisation pour les petites entreprises afin de les aider à proposer des expériences client attrayantes.
	Google Data Studio	Data Studio transforme vos données en tableaux de bord et rapports informatifs, faciles à lire et à partager, et entièrement personnalisables.

Obtenir de l'aide

	Ajoutez un favori aux guides de l'API Google Ads. La plupart des concepts de base y sont expliqués en détail.
	Ajoutez un favori à la documentation de référence de l'API Google Ads. Toutes les fonctionnalités de l'API y sont expliquées en détail.
	Ajoutez un favori à la page d'assistance de l'API Google Ads, qui explique les principaux canaux d'assistance.
	Découvrez la chaîne YouTube dédiée aux développeurs Google Ads.
	Contactez votre représentant commercial / responsable partenaire Google pour organiser une réunion afin de résoudre les problèmes stratégiques plus complexes liés à l'API.