Configurer l'accès à l'API

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

Choisissez le type de procédure de configuration que vous souhaitez suivre :

<0xx0A>

Prérequis

Avant de pouvoir utiliser l'API Data, assurez-vous de disposer des éléments suivants :

un projet Google Cloud ;
Un compte Google disposant de l'autorisation serviceusage.services.enable sur votre projet Google Cloud ou d'un rôle incluant cette autorisation. Par exemple, roles/owner et roles/serviceusage.serviceUsageAdmin incluent tous les deux l'autorisation serviceusage.services.enable. Pour vérifier vos autorisations, consultez Afficher l'accès actuel.
L'interface de ligne de commande Google Cloud installée.

Activer l'API

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

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 répond aux conditions préalables.

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 Choisir la méthode d'authentification adaptée à votre cas d'utilisation pour déterminer l'approche appropriée à votre cas d'utilisation.

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. Elles 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 Emprunt d'identité d'un compte de service pour configurer les identifiants par défaut de l'application :

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

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

Important : Toute application Google Cloud utilisée pour obtenir les identifiants utilisateur du champ d'application de l'API Data Manager doit faire l'objet d'une validation Google OAuth pour éviter d'afficher un écran d'interface utilisateur non validé à ses utilisateurs. La validation Google OAuth n'est pas requise pour les comptes de service.
1. Ouvrez la page Branding dans la console Google Cloud.
2. Sélectionnez votre projet.
3. Remplissez le formulaire, puis cliquez sur Créer.
Étant donné que le champ d'application de l'API Data Manager est un champ d'application sensible, 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 niveaux d'accès.
3. Cochez la case à côté de API Data Manager dans la liste des niveaux d'accès, puis cliquez sur Mettre à jour.
4. Cliquez sur Enregistrer.
5. Accédez à Audience dans la console Google Cloud, puis mettez à jour l'état de publication et le type d'utilisateur. Pour en savoir plus sur ces paramètres, consultez Gérer l'audience de l'application.
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 (Bureau). 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 dans les étapes restantes.

Créer un client OAuth2
Lors de 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.

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"

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
```

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

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

Si vous utilisez un compte Google Ads, suivez les instructions pour ajouter l'adresse e-mail de l'utilisateur au compte Google Ads ou à un compte administrateur Google Ads parent.
Si vous utilisez un compte Display & Video 360, suivez les instructions pour ajouter l'adresse e-mail de l'utilisateur au compte.
Si vous utilisez une propriété Google Analytics, suivez les instructions pour ajouter l'adresse e-mail de l'utilisateur au compte.

Étapes suivantes

Installez une bibliothèque cliente et exécutez des exemples de code pour tester votre première requête Data Manager API.

Installer une bibliothèque cliente