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, dont certaines peuvent être ou de les ignorer si elles ne répondent pas à 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.
	Information:informations non essentielles pour le processus, mais qui ne sont pas essentielles vous aidera à comprendre le contexte ou à clarifier certaines étapes.
	Avertissement:Points à noter tout au long du car elles peuvent nécessiter des efforts de mise en œuvre supplémentaires ou engendrer certaines les risques.

Si vous imprimez la liste de contrôle, vous pouvez utiliser les cases à cocher à gauche pour indiquer les étapes terminées. Cette liste de contrôle fournit une lecture recommandée les informations figurant dans la documentation de l'API Google Ads.

Accès et configuration

	Obtenir votre développeur jeton à partir du 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 Tester l'accès au compte niveau supérieur.
	Vous n'avez besoin de rien d'autre pour essayer l'API Google Ads avec comptes de test. Vous pouvez utiliser des comptes de test pour créer des campagnes, des annonces, etc., les annonces seront effectivement diffusées (coûts générés) et toutes les statistiques des rapports seront égales à zéro. Pour autoriser votre jeton de développeur à 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 commencer. Fournissez autant de détails que 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 sous deux jours ouvrés.
	Une fois que votre développeur le jeton est 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 en expliquant les raisons. Vous pouvez apporter des modifications à votre application, fournir plus de détails sur votre solution, puis envoyez une nouvelle 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 les 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, il s'agit toujours soumis à 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 : Requêtes GoogleAdsService.Search avec le page_token défini n'est pas pris en compte dans la limite du nombre d'opérations.

Fonctionnalités minimales requises

	Découvrez les fonctionnalités minimales requises (RMF), qui désigne un ensemble de fonctions que votre outil doit implémenter, en fonction de la la nature de l'outil.
	Les outils pouvant fonctionner avec l'accès de base (moins de 15 000 requêtes par jour) sont exemptés de RMF. Outils auxquels les annonceurs n'ont pas accès et qui sont destinés à à usage interne uniquement, sont exemptés des fonctionnalités minimales requises. Si votre outil permet uniquement de créer des rapports, seules les fonctionnalités minimales requises seront prises en compte. 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.
	En savoir plus sur les Frais de non-conformité pour comprendre ce qui se passe lorsque les fonctionnalités minimales requises 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 uniquement), il doit implémenter les RMF applicables avant de demander un accès standard. N'oubliez pas que les fonctionnalités minimales requises sont susceptibles d'être modifiées en fonction des modifications apportées à l'API. Si vous décidez Pour demander un accès standard, vous devez vous assurer que votre outil est à jour les dernières fonctionnalités minimales requises.
	Assurez-vous que votre outil implémente les RMF applicables.
	Postuler 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.
	Comprenez les principes de base Structure des ressources de l'API Services.
	Consultez Modifier et inspection des objets Récupérer des objets
	Découvrez-en plus sur les métadonnées de ressources. pour comprendre 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 les informations du compte
	Gestion des comptes > Créer un client
	Gestion des comptes > Télécharger les modifications apportées au compte

Rapports

	Pour les rapports, vous devez utiliser un compte ont diffusé des annonces depuis suffisamment longtemps pour générer des métriques de performances (nous vous recommandons une durée d'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.
	Lire Langage de requête Google Ads (GAQL) la grammaire et la structure des requêtes, ainsi que les concepts de ressource, un segment et des métriques.
	En savoir plus Métriques des critères à comprendre Comment récupérer les données de performances pour différents critères avec `*_view` des ressources, par exemple, KeywordView, TopicView et GenderView.

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

	<ph type="x-smartling-placeholder"> </ph> Découvrez les fonctionnalités disponibles dans l'outil pour les développeurs Google interactif Générateur de requêtes Ads. Cet outil Web recherche tous les champs et filtres disponible pour la ressource sélectionnée et génère les requêtes dans un de la même manière.
	Utilisez l'éditeur de cet outil pour créer une instruction dans le langage de requête Google Ads pour une ressource donnée, 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 nos l'Outil de planification des mots clés, pour découvrir comment fonctionne la planification des mots clés dans l'interface utilisateur Google Ads.

Exemples de code

	<ph type="x-smartling-placeholder"> </ph> Découvrez les fonctionnalités de planification des mots clés en exécutant les exemples de code ci-dessous.
	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 vous pouvez passer ce chapitre.
	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.
	En savoir plus sur les Budget du compte à comprendre comment les budgets peuvent être automatiquement attribués 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 le Partner Manager (SPM) chez Google afin d'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 pour en savoir plus.
	Créer une AccountBudgetProposal et l'attribuer à un compte. Essayez d'utiliser le budget conjointement budget de votre campagne.

Annonces Shopping

	Si vous comptez utiliser Annonces Shopping, vous devrez probablement utiliser Google Merchant Center et Content API for Shopping pour gérer données produit. Cette section décrit les étapes de base à suivre 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.
	Consulter 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 le Recommandations Historique des modifications essayez-les dans l'UI 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

	Lisez notre guide sur comment utiliser RecommendationService pour récupérer les recommandations de Google et les appliquer à votre compte afin d'augmenter les performances globales des 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

	Lisez notre guide sur comment utiliser ChangeStatusService pour récupérer l'historique des modifications afin de suivre les changements apportés à votre compte, par exemple vos campagnes et annonces.
	Découvrez les fonctionnalités de l'historique des modifications en exécutant l'exemple de code suivant: Exemples ChangeStatus -> Télécharger les modifications du compte.

Se tenir informé

Gestion des versions

	Lorsque l'ancienne version majeure est abandonnée, elle n'est plus prise en charge et les appels d'API effectués à l'aide d'une ancienne version de l'API échouent. N'oubliez pas de vous tenir informé des 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 à l'ancienne version 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 du contact pour l'API est enregistrée dans le le Centre API de votre votre compte administrateur est à jour, car c'est ainsi que nous vous contactons si nous en détectons de 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 la façon dont les internautes utilisent votre site Web. 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 qui vous permet mettre à jour rapidement et facilement les codes de suivi et les fragments de code associés ; (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 données informatives, faciles à lire et à partager, des tableaux de bord et des rapports entièrement personnalisables.

Obtenir de l'aide

	Ajoutez un favori à la section Guides de l'API Google Ads La plupart des concepts de base sont soigneusement n'y est pas expliquée.
	Ajoutez un favori à la section Documentation de référence de l'API Google Ads Tout les fonctionnalités de l'API y sont expliquées en détail.
	Ajoutez un favori à la section la page d'assistance de l'API Google Ads, 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.