Vous avez besoin à la fois d'identifiants d'application OAuth 2.0 et d'un jeton de développeur lorsque vous appelez l'API Google Ads. Si vous effectuez des appels d'API avec un compte administrateur Google Ads, vous devez également spécifier un en-tête login-customer-id avec chaque requête. Cette page explique comment définir ces valeurs et décrit plusieurs en-têtes HTTP spécifiques à l'API supplémentaires qui sont envoyés et reçus lorsque vous utilisez l'interface REST.
Identifiants OAuth 2.0
L'API Google Ads utilise des identifiants d'application pour identifier et autoriser les requêtes d'API. Vous pouvez configurer à la fois des clients OAuth 2.0 et des comptes de service. Pour en savoir plus sur la configuration de l'autorisation côté client, consultez OAuth2 dans l'API Google Ads.
Si vous débutez avec les API Google, vous pouvez utiliser oauth2l ou OAuth 2.0 Playground pour tester les identifiants d'application et l'API Google Ads avant d'écrire le code de votre application.
En utilisant des flux d'application Web ou pour ordinateur
Suivez la procédure pour configurer un projet dans la console Google APIs pour l'API Google Ads. Notez l'ID client et le code secret du client, puis revenez sur cette page.
Une fois que vous avez créé un client OAuth, suivez les instructions du flux pour les applications de bureau ou les instructions du flux pour les applications Web pour générer un jeton d'actualisation et un jeton d'accès.
Utiliser les comptes de service
Suivez les instructions générales du guide Comptes de service pour configurer l'accès au compte de service pour l'API Google Ads.
Une fois que vous avez configuré un compte de service pour accéder à votre compte Google Ads, suivez le guide Utiliser OAuth 2.0 pour les applications de serveur à serveur, en veillant à sélectionner l'onglet HTTP/REST. L'scope à utiliser pour l'accès à l'API Google Ads est https://www.googleapis.com/auth/adwords.
Générer de nouveaux jetons d'accès
Une fois que vous disposez d'un ID client, d'un secret client et d'un jeton d'actualisation, vous pouvez générer un nouveau jeton d'accès à utiliser dans les appels d'API à l'aide de l'outil de ligne de commande curl:
curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID" \
--data "client_secret=CLIENT_SECRET" \
--data "refresh_token=REFRESH_TOKEN" \
https://www.googleapis.com/oauth2/v3/tokenVous utilisez ensuite le jeton d'accès renvoyé par la requête curl dans l'en-tête HTTP Authorization de chaque appel d'API à l'API Google Ads:
GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
En-têtes de requête
Jeton de développeur
L'API Google Ads nécessite également un jeton de développeur pour effectuer des appels vers l'API. Vous pouvez demander un jeton pour votre compte administrateur directement depuis l'interface utilisateur de Google Ads. Pour en savoir plus sur la configuration d'un jeton de développeur, consultez la page Obtenir votre jeton de développeur.
Vous devez inclure la valeur de votre jeton de développeur dans l'en-tête HTTP developer-token de chaque appel d'API à l'API Google Ads:
GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Numéro client utilisé pour la connexion
Pour les appels d'API Google Ads effectués par un administrateur auprès d'un compte client (c'est-à-dire lorsque vous vous connectez en tant qu'administrateur pour effectuer des appels d'API auprès de l'un de ses comptes client), vous devez également fournir l'en-tête HTTP login-customer-id. Cette valeur représente le numéro client Google Ads de l'administrateur qui effectue l'appel d'API.
L'inclusion de cet en-tête équivaut à choisir un compte dans l'interface utilisateur de Google Ads après vous être connecté ou avoir cliqué sur votre photo de profil en haut à droite de la page. Lorsque vous spécifiez le numéro client, veillez à supprimer les traits d'union (-), par exemple: 1234567890, et non 123-456-7890.
GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
Numéro client associé
Cet en-tête n'est utilisé que par les fournisseurs tiers de solutions d'analyse d'applications lorsqu'ils importent des conversions dans un compte Google Ads associé. Pour en savoir plus, consultez le guide de la structure des appels d'API.
...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID
En-têtes de réponse
Les en-têtes suivants sont renvoyés dans les réponses HTTP de l'API.
Identifiant de la demande
request-id est une chaîne qui identifie de manière unique la requête API. Lorsque vous déboguez ou résolvez des problèmes liés à des appels d'API spécifiques, l'request-id est un identifiant important à avoir à portée de main lorsque vous contactez l'assistance Google pour les développeurs.
request-id: 2a5Cj89VV7CNhya1DZjjrC