Workflow d'authentification pour un seul utilisateur

Comme le workflow de compte de service, le flux d'authentification à utilisateur unique utilise les fonctionnalités d'autorisation et de gestion des utilisateurs proposées par l'interface utilisateur Google Ads pour accorder à l'application l'accès à tous les comptes nécessaires. Ce workflow d'authentification comporte deux étapes :

  • Vous accordez à un seul utilisateur l'accès à tous les comptes Google Ads qui doivent être gérés par l'application.
  • L'utilisateur autorise votre application à gérer ses comptes Google Ads en son nom, ce qui lui permet d'accéder à tous les comptes Google Ads.

Comme un seul utilisateur est impliqué, vous pouvez vous appuyer sur des outils tels que le gcloud CLI ou l'exemple de code GenerateUserCredentialau lieu de créer votre propre flux d'authentification utilisateur OAuth 2.0.

Un cas d'utilisation associé à ce workflow se produit lorsque vos comptes peuvent être accessibles via un petit nombre d'identifiants utilisateur (par exemple, trois à quatre utilisateurs). L'effort de développement nécessaire pour créer un workflow d'authentification multi-utilisateur OAuth complet n'est donc pas justifié par rapport à l'effort nécessaire pour obtenir l'autorisation de trois à quatre utilisateurs à l'aide d'un outil de ligne de commande tel que gcloud CLI.

Inconvénients

Ce flux présente quelques inconvénients par rapport au workflow de compte de service :

  1. Le workflow d'authentification utilisateur vous oblige à créer un ID client et un code secret OAuth 2.0 dans la console Google Cloud, ce qui nécessite plus d'étapes de configuration que la création d'un compte de service et d'une clé.
  2. Si l'utilisateur autorisé quitte l'équipe ou l'entreprise, votre application peut cesser de fonctionner si vous le supprimez de vos comptes ou si vous désactivez son compte utilisateur. Les comptes de service ne sont pas liés à des utilisateurs individuels. Ce risque est donc évité.
  3. L'utilisateur qui autorise le compte Google Ads doit activer les clés d'accès dans son compte Google pour éviter que celui-ci ne soit compromis en raison d'une sécurité insuffisante, de logiciels malveillants ou de tentatives d'hameçonnage. Les comptes de service ne sont pas tenus d'activer les clés d'accès et sont moins vulnérables à ce problème, car certains de ces modes d'attaque ne s'appliquent pas directement à eux.

Générer des identifiants

  1. Configurez un écran de consentement OAuth pour votre application et ajoutez https://www.googleapis.com/auth/adwords comme niveau d'accès OAuth 2.0. Pour en savoir plus, consultez la section Configurer votre écran de consentement OAuth.

  2. Créez un ID client et un code secret du client en suivant les instructions. Une fois le client OAuth 2.0 créé, téléchargez le fichier JSON du client en cliquant sur le bouton Télécharger le fichier JSON dans la boîte de dialogue de confirmation. Enregistrez le fichier sous le nom credentials.json.

  3. Identifiez un compte utilisateur qui a accès à tous les comptes Google Ads que vous souhaitez gérer à l'aide de votre application. Si des comptes ne sont pas accessibles, accordez-lui l'accès.

  4. Téléchargez et installez la gcloud CLI. Une fois l'installation terminée, vérifiez que l'outil fonctionne correctement en exécutant la commande gcloud version à partir d'une invite de ligne de commande. La sortie ressemble à ceci :

    gcloud version
    Google Cloud SDK 492.0.0
alpha 2024.09.06
beta 2024.09.06
bq 2.1.8
bundled-python3-unix 3.11.9
core 2024.09.06
enterprise-certificate-proxy 0.3.2
gcloud-crc32c 1.0.0

  5. Générez un jeton d'actualisation OAuth 2.0 en exécutant l'outil gcloud CLI avec le fichier credentials.json de l'étape précédente. Vous devez transmettre --client-id-file pour que le jeton d'actualisation soit émis sous votre projet de la console Google APIs plutôt que sous le projet par défaut de gcloud CLI :

    gcloud auth application-default login \
  --scopes=https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=PATH_TO_CREDENTIALS_JSON

  6. La commande gcloud ouvre une fenêtre de connexion à un compte Google dans une nouvelle fenêtre de navigateur et vous guide tout au long des étapes d'authentification OAuth 2.0. Assurez-vous de vous connecter en tant qu'utilisateur que vous avez sélectionné lors des étapes précédentes. Si votre application n'est pas validée, un écran d'avertissement peut s'afficher. Dans ce cas, vous pouvez cliquer sur le lien Paramètres avancés , puis sur l'option Accéder à PROJECT_NAME (non sécurisé).

  7. Après avoir vérifié les niveaux d'accès, cliquez sur le bouton Continuer pour accorder l'autorisation. Le navigateur accède à https://cloud.google.com/sdk/auth_success, ce qui indique que l'authentification a réussi. La page affiche le message suivant :

    Authorization code granted. Close this tab.

    La commande gcloud affiche le message suivant :

    Credentials saved to file: [/****/.config/gcloud/application_default_credentials.json]

    Ouvrez le fichier application_default_credentials.json. Son contenu ressemble à ceci :

    {
  "account": "",
  "client_id": "******.apps.googleusercontent.com",
  "client_secret": "******",
  "refresh_token": "******",
  "type": "authorized_user",
  "universe_domain": "googleapis.com"
}

Configuration de la bibliothèque cliente

Sélectionnez l'onglet correspondant à votre langage de programmation pour obtenir des instructions sur la configuration de votre bibliothèque cliente. Si votre utilisateur autorisé accède aux comptes client via un compte administrateur Google Ads, définissez login-customer-id (ou loginCustomerId) sur le numéro client à 10 chiffres de ce compte administrateur sans tirets.

Java

Configurez les clés suivantes dans votre fichier ads.properties.

api.googleads.clientId=INSERT_OAUTH2_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_OAUTH2_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_OAUTH2_REFRESH_TOKEN_HERE
api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

Pour obtenir d'autres options, consultez le guide de configuration.

.NET

Définissez les identifiants OAuth 2.0 sur l'instance GoogleAdsConfig et utilisez-la pour initialiser l'objet GoogleAdsClient.

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.APPLICATION,
    OAuth2ClientId = "INSERT_OAUTH2_CLIENT_ID_HERE",
    OAuth2ClientSecret = "INSERT_OAUTH2_CLIENT_SECRET_HERE",
    OAuth2RefreshToken = "INSERT_OAUTH2_REFRESH_TOKEN_HERE",
    LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE",
};
GoogleAdsClient client = new GoogleAdsClient(config);

Pour obtenir d'autres options, consultez le guide de configuration.

Python

Configurez les clés suivantes dans votre fichier google-ads.yaml.

client_id: INSERT_OAUTH2_CLIENT_ID_HERE
client_secret: INSERT_OAUTH2_CLIENT_SECRET_HERE
refresh_token: INSERT_OAUTH2_REFRESH_TOKEN_HERE
login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE
use_proto_plus: True

Pour obtenir d'autres options, consultez le guide de configuration.

PHP

Configurez les clés suivantes dans votre fichier google_ads_php.ini.

[GOOGLE_ADS]
loginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"

[OAUTH2]
clientId = "INSERT_OAUTH2_CLIENT_ID_HERE"
clientSecret = "INSERT_OAUTH2_CLIENT_SECRET_HERE"
refreshToken = "INSERT_OAUTH2_REFRESH_TOKEN_HERE"

Pour obtenir d'autres options, consultez le guide de configuration.

Ruby

Configurez les clés suivantes dans votre google_ads_config.rb fichier.

Google::Ads::GoogleAds::Config.new do |c|
  c.client_id = 'INSERT_OAUTH2_CLIENT_ID_HERE'
  c.client_secret = 'INSERT_OAUTH2_CLIENT_SECRET_HERE'
  c.refresh_token = 'INSERT_OAUTH2_REFRESH_TOKEN_HERE'
  c.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
end

Pour obtenir d'autres options, consultez le guide de configuration.

Perl

Configurez les clés suivantes dans votre fichier googleads.properties.

clientId=INSERT_OAUTH2_CLIENT_ID_HERE
clientSecret=INSERT_OAUTH2_CLIENT_SECRET_HERE
refreshToken=INSERT_OAUTH2_REFRESH_TOKEN_HERE
loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

Pour obtenir d'autres options, consultez le guide de configuration.

curl

Commencez par utiliser un client HTTP pour récupérer un jeton d'accès OAuth 2.0. Ce guide utilise la commande curl.

curl \
  --data "grant_type=refresh_token" \
  --data "client_id=CLIENT_ID" \
  --data "client_secret=CLIENT_SECRET" \
  --data "refresh_token=REFRESH_TOKEN" \
  https://oauth2.googleapis.com/token

Vous pouvez utiliser le jeton d'accès dans vos appels d'API. L'exemple suivant montre comment exécuter un rapport sur les campagnes à l'aide de la GoogleAdsService.SearchStream méthode pour récupérer les campagnes de votre compte. Ce guide ne couvre pas les détails des rapports.

curl -i -X POST \
  https://googleads.googleapis.com/v26/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

Le contenu de query.json est le suivant :

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}
Précédent
Aperçu
Suivant
Workflow d'authentification multi-utilisateur