Configurer l'accès à l'API

Voici comment configurer l'accès à l'API Data Manager avec un SDK ou REST.

Prérequis

  1. Un projet Google Cloud ou un compte Google dont vous souhaitez qu'il soit propriétaire du projet.

    • Si vous n'avez pas de projet, le processus de configuration de la section suivante en crée un pour vous.

    • Si vous avez déjà un projet, assurez-vous que votre compte Google dispose d'un rôle permettant d'activer les API sur le projet, tel que Propriétaire, Éditeur ou Administrateur Service Usage. Pour vérifier votre rôle, ouvrez la page IAM dans la console Google Cloud, sélectionnez votre projet et recherchez votre compte Google dans la liste.

      Pour en savoir plus, consultez Afficher l'accès actuel.

  2. La Google Cloud CLI installée.

Activer l'API

Si vous ne l'avez pas déjà fait, activez l'API Data Manager dans votre projet Google Cloud en cliquant sur Activer l'API Data Manager ou suivez les instructions pour effectuer cette étape manuellement.

Activer l'API Data Manager

Si vous ne trouvez pas l'API Data Manager ou si l'activation de l'API Data Manager échoue, vérifiez que votre compte Google remplit les conditions préalables.

Configurer l'authentification

Vous pouvez utiliser n'importe quelle méthode d'authentification de Google, à l'exception des clés API. Nous vous recommandons de consulter la section Choisir la méthode d'authentification adaptée à votre cas d'utilisation pour déterminer l'approche appropriée à votre cas d'utilisation.

Les deux méthodes d'authentification les plus courantes sont les comptes utilisateur et les comptes de service :

  • Comptes utilisateur : représentent les personnes qui interagissent directement avec les API et les services Google.
  • Comptes de service : représentent des applications, et non des personnes, en tant qu'utilisateurs. Ils permettent à vos applications de gérer l'authentification et l'autorisation. Par exemple, si une application doit accéder à des ressources Google Cloud.

Votre intégration peut utiliser les identifiants par défaut de l'application (ADC) pour trouver automatiquement les identifiants de l'environnement. Vous n'avez donc pas besoin de modifier le code client pour l'authentification.

Choisissez Compte utilisateur ou Compte de service pour configurer les ADC :

Compte utilisateur

Voici la procédure à suivre pour vous authentifier avec les identifiants d'un compte utilisateur :

  1. Configurez les paramètres de Google Auth Platform pour votre projet.

    1. Ouvrez la page Branding dans la console Google Cloud.

    2. Sélectionnez votre projet.

    3. Remplissez le formulaire, puis cliquez sur Créer.

  2. Étant donné que l'API Data Manager utilise des champs d'application sensibles, les étapes suivantes sont requises :

    1. Accédez aux paramètres Accès aux données de votre projet.

    2. Cliquez sur Ajouter ou supprimer des champs d'application.

    3. Dans la liste des champs d'application, recherchez API Data Manager et cochez la case correspondant à chaque champ d'application requis par votre application :

      • .../auth/datamanager : sélectionnez ce champ d'application pour les opérations d'API standards, telles que la gestion des données client, des audiences et des événements. Il s'agit du champ d'application principal utilisé dans ce guide.

      • .../auth/datamanager.partnerlink : sélectionnez ce champ d'application uniquement si vous êtes un partenaire pour les données qui crée ou supprime des liens partenaires dans des comptes d'annonceurs.

    4. Cliquez sur Mettre à jour.

    5. Cliquez sur Enregistrer.

    6. Accédez à Audience dans la console Google Cloud et configurez les paramètres pour le développement initial :

      • Définissez l'état de publication sur Test.
      • Définissez le Type d'utilisateur sur Interne (si votre projet se trouve dans une organisation Google Workspace) ou sur Externe (si ce n'est pas le cas).
      • Si vous utilisez Externe, ajoutez les comptes Google que vous utilisez pour générer des identifiants en tant qu'utilisateurs de test.

      Pour en savoir plus sur ces paramètres, consultez Gérer l'audience de l'application.

  3. Cliquez sur Créer un client OAuth2 pour créer un client OAuth2 dans le projet, ou suivez les instructions pour créer un client OAuth2 Desktop. Vous pouvez ignorer cette étape si vous disposez déjà d'un client OAuth2 Desktop que vous souhaitez utiliser pour l'API Data Manager.

    Si vous cliquez sur Créer un client OAuth2, sélectionnez Application de bureau lorsque vous êtes invité à configurer votre client OAuth afin de pouvoir l'utiliser lors des étapes suivantes.

    Créer un client OAuth2

    À la dernière étape, cliquez sur TÉLÉCHARGER LA CONFIGURATION DU CLIENT et notez l'emplacement de téléchargement que vous avez choisi.

  4. Générez un fichier ADC local en exécutant la commande suivante. Cette commande lance un flux Web dans lequel vous êtes invité à vous connecter au compte Google que vous utilisez avec l'API.

    Remplacez PATH_TO_CLIENT_JSON par le nom du fichier JSON que vous avez téléchargé.

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

    Si vous souhaitez utiliser les mêmes identifiants pour l'API Data Manager et l'API Google Ads, incluez le champ d'application de l'API Google Ads dans la liste --scopes :

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

    Si vous souhaitez utiliser les mêmes identifiants pour l'API Data Manager et l'API Display & Video 360, incluez le champ d'application de l'API Display & Video 360 dans la liste --scopes :

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. Vérifiez que les identifiants sont correctement configurés à l'aide de la commande suivante. Si la commande s'exécute correctement, elle affiche un jeton d'accès dans la console.

    gcloud auth application-default print-access-token

Compte de service

Voici la procédure à suivre pour créer un compte de service et utiliser l'emprunt d'identité d'un compte de service pour vous authentifier dans un environnement de développement local. Ces étapes utilisent l'emprunt d'identité au lieu des clés de compte de service, car les clés de compte de service peuvent présenter un risque pour la sécurité si elles ne sont pas gérées avec soin.

  1. Cliquez sur le bouton Créer un compte de service ci-dessous ou suivez les instructions pour sélectionner ou créer un compte de service.

    Créer un compte de service

  2. Attribuez au compte de service le rôle IAM Consommateur Service Usage (roles/serviceusage.serviceUsageConsumer), qui inclut l'autorisation serviceusage.services.use permettant au compte de service d'envoyer des requêtes API pour le projet.

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/serviceusage.serviceUsageConsumer"

  3. Attribuez à votre compte Google le rôle IAM Créateur de jetons du compte de service (roles/iam.serviceAccountTokenCreator) sur le compte de service.

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
  --member="user:USER_EMAIL" \
  --role="roles/iam.serviceAccountTokenCreator"

  4. Configurez vos ADC en exécutant la commande suivante :

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"

    Si vous souhaitez utiliser les mêmes identifiants pour l'API Data Manager et l'API Google Ads, incluez le champ d'application de l'API Google Ads dans la liste --scopes :

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"

    Si vous souhaitez utiliser les mêmes identifiants pour l'API Data Manager et l'API Display & Video 360, incluez le champ d'application de l'API Display & Video 360 dans la liste --scopes :

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"

    Lorsque vous êtes invité à vous connecter, connectez-vous avec votre compte Google disposant du rôle "Créateur de jetons du compte de service".

  5. Vérifiez que les identifiants sont correctement configurés à l'aide de la commande suivante. Si la commande aboutit, elle affiche un jeton d'accès dans la console.

    gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"

Pour en savoir plus sur l'authentification et les identifiants de votre application, consultez Méthodes d'authentification chez Google et Fonctionnement des identifiants par défaut de l'application.

Configurer l'accès au compte

Compte utilisateur

Sélectionnez l'onglet correspondant à votre cas d'utilisation.

  • Sélectionnez Annonceur si vous utilisez les identifiants d'un compte Google qui est un utilisateur des comptes d'annonceur que vous souhaitez gérer.
  • Sélectionnez Partenaire pour les données si vous utilisez les identifiants d'un compte Google qui est un utilisateur d'un compte de partenaire pour les données et que vous souhaitez gérer les comptes d'annonceurs qui ont un lien de partenaire vers le compte de partenaire pour les données. Les comptes de partenaires pour les données ne sont émis qu'après avoir suivi le processus d'approbation. Pour commencer, remplissez le formulaire de participation.

Annonceur

Accordez à l'adresse e-mail associée à l'utilisateur l'accès à Destination.

Suivez les instructions pour ajouter l'adresse e-mail de l'utilisateur au compte Google Ads ou à un compte administrateur Google Ads parent.

Display & Video 360

Suivez les instructions pour ajouter l'adresse e-mail de l'utilisateur au compte.

Google Analytics

Suivez les instructions pour ajouter l'adresse e-mail de l'utilisateur au compte.

Partenaire pour les données

Accordez à l'adresse e-mail associée à l'utilisateur l'accès à votre compte de partenaire pour les données. En général, les partenaires pour les données utilisent un compte de service pour accéder à l'API. Toutefois, si vous utilisez un compte utilisateur à des fins de test ou autres, vous devez lui accorder l'accès au compte du partenaire pour les données.

Ajoutez l'adresse e-mail de l'utilisateur au compte du partenaire pour les données via l'interface utilisateur de Google Ads en suivant ces instructions.

Compte de service

Sélectionnez l'onglet correspondant à votre cas d'utilisation.

  • Sélectionnez Annonceur si vous utilisez les identifiants d'un compte Google qui est un utilisateur des comptes d'annonceur que vous souhaitez gérer.
  • Sélectionnez Partenaire pour les données si vous utilisez les identifiants d'un compte Google qui est un utilisateur d'un compte de partenaire pour les données et que vous souhaitez gérer les comptes d'annonceurs qui ont un lien de partenaire vers le compte de partenaire pour les données. Les comptes de partenaires pour les données ne sont émis qu'après avoir suivi le processus d'approbation. Pour commencer, remplissez le formulaire de participation.

Annonceur

Accordez à l'adresse e-mail associée à votre compte de service l'accès à Destination.

Configurez l'accès au compte pour ajouter le compte de service au compte Google Ads ou à un compte administrateur Google Ads parent.

Display & Video 360

Suivez les instructions pour créer un utilisateur Display & Video 360 associé au compte de service.

Google Analytics

Suivez les instructions pour ajouter l'adresse e-mail du compte de service au compte.

Partenaire pour les données

Accordez à l'adresse e-mail associée à votre compte de service l'accès à votre compte de partenaire pour les données.

L'accès au compte du partenaire pour les données est géré via l'UI Google Ads. Pour ajouter le compte de service et définir son niveau d'accès, suivez les étapes de la section Configurer l'accès au compte.

Étapes suivantes

Suivant
Installer une bibliothèque cliente