Bibliothèque de vidéos: atelier 2021
Voici une checklist pour vous aider à démarrer votre migration:
Examinez les mappages entre l'API AdWords et l'API Google Ads:
Découvrez les outils suivants:
Acceptez les Conditions d'utilisation mises à jour et mettez à jour vos coordonnées dans le centre d'API.
- Connectez-vous au Centre API du compte administrateur sur lequel vous disposez de votre jeton de développeur:
ads.google.com/aw/apicenter
. - Faites défiler la page jusqu'à la section Adresse e-mail du contact pour l'API, puis mettez-la à jour.
- Faites défiler la page jusqu'à Principal établissement, acceptez les nouvelles conditions, puis cliquez sur Enregistrer.
- Connectez-vous au Centre API du compte administrateur sur lequel vous disposez de votre jeton de développeur:
activer l'API Google Ads dans votre projet Google Cloud ;
- Ouvrez la bibliothèque d'API dans la console Google APIs. Si vous y êtes invité, sélectionnez votre projet ou créez-en un. La bibliothèque d'API répertorie toutes les API disponibles, regroupées par famille de produits et par popularité.
- Recherchez l'API Google Ads si elle ne figure pas dans la liste.
- Sélectionnez l'API Google Ads, puis cliquez sur le bouton Activer.
Si vous avez déjà utilisé l'API AdWords, les identifiants que vous utilisiez restent valides pour l'API Google Ads. Ne demandez pas de nouveau jeton de développeur et ne créez pas de paires OAuth2
clientId
etclientSecret
.Sélectionnez une bibliothèque cliente.
Consultez le guide de démarrage rapide pour effectuer votre premier appel.
Utiliser une bibliothèque cliente
Si vous utilisez l'une des bibliothèques clientes de l'API AdWords, vous pouvez télécharger l'une de nos bibliothèques clientes pour l'API Google Ads et commencer à travailler immédiatement. Reportez-vous au fichier README de la bibliothèque cliente pour savoir comment configurer le fichier de configuration.
Dans la plupart des cas, votre configuration existante peut être réutilisée lorsque vous migrez des bibliothèques clientes de l'API AdWords vers les bibliothèques clientes de l'API Google Ads. La principale différence est le nouveau login-customer-id
. Consultez notre guide pour savoir quand l'ajouter à votre configuration.
Exemple de configuration Java
Pour la bibliothèque cliente Java, vous pouvez simplement copier les lignes de votre fichier ads.properties
qui spécifient les identifiants, puis remplacer le préfixe api.adwords
de chaque clé par api.googleads
:
api.adwords.clientId --> api.googleads.clientId
api.adwords.clientSecret --> api.googleads.clientSecret
api.adwords.refreshToken --> api.googleads.refreshToken
api.adwords.developerToken --> api.googleads.developerToken
Une fois le fichier de configuration mis à jour, vous pouvez effectuer votre premier appel:
Java
- Dans votre IDE, ouvrez le fichier GetCampaigns.java et exécutez-le.
- La console devrait imprimer la liste des campagnes de votre compte.
C#
- Dans votre IDE, ouvrez le fichier GetCampaigns.cs et exécutez-le.
- La console devrait imprimer la liste des campagnes de votre compte.
PHP
- Exécutez GetCampaigns.php.
- La console devrait imprimer la liste des campagnes de votre compte.
Python
- Dans votre IDE, ouvrez le fichier get_campaigns.py et exécutez-le.
- La console devrait imprimer la liste des campagnes de votre compte.
Ruby
- Dans la ligne de commande, exécutez get_campaigns.rb en saisissant :
ruby get_campaigns.rb
- La console devrait imprimer la liste des campagnes de votre compte.
Perl
- Exécutez get_campaigns.pl.
- La console devrait imprimer la liste des campagnes de votre compte.
Exemples de code
Les bibliothèques clientes fournissent également des exemples de code pas à pas illustrant comment passer de l'API AdWords à l'API Google Ads.
Java
C#
PHP
Python
Ruby
Perl
Alternatives à l'utilisation d'une bibliothèque cliente
Si vous utilisiez l'API AdWords sans bibliothèque cliente et que vous souhaitez continuer à le faire avec l'API Google Ads, vous pouvez quand même utiliser vos identifiants.
Consultez le guide REST pour apprendre à utiliser les identifiants afin d'effectuer des requêtes sur l'API Google Ads avec REST sur HTTP.