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 être le propriétaire.

    • 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 qui peut activer des API dans le projet, tel que Propriétaire, Éditeur, ou Administrateur de l'utilisation du service. Pour vérifier votre rôle, ouvrez la page IAM dans la console Google Cloud, sélectionnez votre projet, puis recherchez votre compte Google dans la liste.

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

  2. Une installation de Google Cloud CLI installée.

Activer l'API

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

Activer l'API Data Manager

Si vous ne trouvez pas l'API Data Manager ou si Activer l'API Data Manager échoue, vérifiez que votre compte Google répond aux prérequis.

Configurer l'authentification

Vous pouvez utiliser n'importe quelle méthode d'authentification chez 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.

Deux méthodes d'authentification 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 vous authentifier.

Sélectionnez Compte utilisateur ou Compte de service pour configurer ADC :

Compte utilisateur

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

  1. Configurez les paramètres de la plate-forme d'authentification Google 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 d'accès aux données de votre projet.

    2. Cliquez sur Ajouter ou supprimer des niveaux d'accès.

    3. Dans la liste des champs d'application, recherchez API Data Manager et cochez la case de 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é tout au long de 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 annonceur.

    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 État de la publication sur Test.
      • Définissez Type d'utilisateur sur Interne (si votre projet se trouve dans une organisation Google Workspace) ou 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 de bureau. Vous pouvez ignorer cette étape si vous disposez déjà d'un client OAuth2 de bureau 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 choisissez.

  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 aboutit, 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é du compte de service afin de 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 ces dernières 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' autorisationserviceusage.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 votre 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 des identifiants pour un compte Google qui est un utilisateur des comptes annonceur que vous souhaitez gérer.
  • Select partenaire pour les données if you're using credentials for a compte Google that is a user in a partenaire pour les données account, and you want to manage compte publicitaires that have a partner link to the partenaire pour les données account. Les comptes 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 à la 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 partenaire pour les données. En règle générale, 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 accorder à votre compte utilisateur l'accès au compte partenaire pour les données.

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

Compte de service

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

  • Sélectionnez Annonceur si vous utilisez des identifiants pour un compte Google qui est un utilisateur des comptes annonceur que vous souhaitez gérer.
  • Select partenaire pour les données if you're using credentials for a compte Google that is a user in a partenaire pour les données account, and you want to manage compte publicitaires that have a partner link to the partenaire pour les données account. Les comptes 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 à la 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 partenaire pour les données.

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

Étapes suivantes

Suivant
Installer une bibliothèque cliente