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

L'API Exchange Reporting DV360 est exposée en tant que service Google Cloud basé sur une liste d'autorisation qui utilise OAuth. Le processus d'ajout à la liste d'autorisation est géré par la place de marché DV360 de l'API Reporting.

Procédure

Voici la procédure d'intégration de l'API Exchange Reporting pour DV360:

  1. Créez un compte Google sur Google Cloud console.

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

  2. Contactez Google DV360 avec les informations de compte pour qu'il soit ajouté liste d'autorisation.

  3. Une fois que vous avez été informé que vous figurez sur la liste d'autorisation, demandez un OAuth examen de validation pour que votre application puisse accéder au champ d'application doubleclickbidmanager.

  4. Connectez-vous à la console Google Cloud.

    Accédez à API et Services > Bibliothèque > Privé : Un DV360 devrait s'afficher L'API Exchange Reporting est répertoriée comme l'une des API à votre disposition. Activez le l'API Exchange Reporting DV360.

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

Compte de service

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

Voici les étapes à suivre pour créer des identifiants de compte de service à l'aide de l'API console:

  1. Dans le Gestionnaire d'API > Identifiants, sélectionnez Créez des identifiants → Clé de compte de service.

  2. Sélectionnez Nouveau compte de service dans la liste déroulante 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 de @ dans le de l'ID du compte de service généré.

    Sous Type de clé, nous vous recommandons de laisser cette valeur définie sur JSON. Cliquez sur Create pour générer une clé JSON sous la forme d'un fichier texte .json. Lorsque vous y êtes invité, téléchargez le fichier sur votre ordinateur et une boîte de dialogue Compte de service créé s'affiche. 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. Conservez votre fichier JSON en lieu sûr, car il contient votre clé privée. est la seule copie de cette clé. Les identifiants de ce fichier sont nécessaires lorsque votre code appelle l'API.

  4. Contactez DV360 en utilisant les informations du compte de service que vous avez créé. et plus précisément, l'adresse e-mail du compte de service. Cela fait partie du liste d'autorisation pour l'accès aux API.

Jeton d'accès

Une fois que votre compte de service est autorisé à appeler l'API, vous pouvez suivez les exemples fournis dans les guides des API. Pour obtenir un jeton d'accès manuellement, vous pouvez utiliser un outil tel que oauth2l. ou utilisez-en un de notre client bibliothèques pour s'authentifier de manière automatisée.