Intégration de l'API Exchange Reporting DV360 et configuration OAuth

L'API Reporting DV360 Exchange permet aux partenaires Third-Party Exchange (3PE) d'accéder de manière programmatique aux rapports sur les performances de Display & Video 360.

L'API Reporting DV360 Exchange est exposée en tant qu'API Google Cloud basée sur une liste d'autorisation et utilisant OAuth. L'équipe de l'API Reporting de DV360 Exchange gère le processus de liste d'autorisation.

Procédure

Voici les étapes à suivre pour intégrer l'API Reporting DV360 Exchange :

  1. Créez un compte Google dans la console Google Cloud.

    Notez que ce compte doit être utilisé pour gérer les jetons d'accès de votre client de production. N'utilisez donc pas votre compte Gmail personnel.

  2. Contactez Google DV360 en fournissant les informations du compte à ajouter à la liste d'autorisation.

  3. Une fois que vous avez reçu la confirmation que vous êtes sur la liste d'autorisation, demandez un examen de validation OAuth pour que votre application ait accès au champ d'application doubleclickbidmanager.

  4. Connectez-vous à la console Google Cloud.

    Accédez à API et services > Bibliothèque > Privé. L'API Reporting DV360 Exchange devrait figurer parmi les API disponibles. Activez l'API Reporting DV360 Exchange.

  5. Accédez à Identifiants > Créer un identifiant > Clé de compte de service. Suivez les instructions pour créer un compte de service.

Compte de service

Un compte de service permet à votre code d'envoyer directement les identifiants de l'application à l'API. Un compte de service, tel qu'un compte utilisateur, est représenté par une adresse e-mail. Contrairement à un compte utilisateur, un compte de service n'appartient qu'à une application et ne peut être utilisé que pour accéder à l'API pour laquelle il a été créé.

Voici comment créer des identifiants de compte de service à l'aide de la console Google Cloud :

  1. Sur la page Gestionnaire d'API > Identifiants, sélectionnez Créer des identifiants → Clé de compte de service.

  2. Sélectionnez Nouveau compte de service dans le menu déroulant Compte de service.

    Saisissez un nom pour ce compte de service. Ce nom est utilisé par défaut pour votre ID de compte de service, à gauche du @ dans l'adresse d'ID de compte de service générée.

    Sous Type de clé, nous vous recommandons de laisser la valeur JSON. Cliquez sur Créer pour générer une clé JSON en tant que fichier texte .json. Lorsque vous y êtes invité, téléchargez le fichier sur votre ordinateur. Une boîte de dialogue Compte de service créé s'affiche.

    Voici un exemple de clé JSON :

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. Stockez votre fichier JSON de manière sécurisée, car il contient votre clé privée (et il s'agit de la seule copie de cette clé). Les identifiants de ce fichier sont nécessaires lorsque votre code effectue des appels à l'API.

  4. Contactez DV360 en fournissant les informations du compte de service que vous avez créé, en particulier l'adresse e-mail du compte de service. Cela fait partie du processus d'ajout à la liste d'autorisation pour l'accès à l'API.

Jeton d'accès

Une fois votre compte de service autorisé à appeler l'API, vous pouvez suivre les exemples des guides de l'API. Pour obtenir un jeton d'accès manuellement, vous pouvez utiliser un outil tel que oauth2l ou l'une de nos bibliothèques clientes pour vous authentifier par programmation.