Configurer l'authentification

Intégration de l'API vendeur DV360

L'intégration d'une API pour l'API DV360 Seller comporte plusieurs étapes principales. L'API DV360 Seller est exposée en tant qu'API Google Cloud basée sur une liste d'autorisation et utilise OAuth pour l'authentification.

Pour ajouter une liste d'autorisation, contactez l'équipe DV360 Seller API.

Remarque:Si votre application accède à l'API DV360 Seller, elle doit réussir l'examen de validation OAuth. Si l'écran indique Application non validée lorsque vous testez votre application, vous devez envoyer une demande de validation pour la supprimer. En savoir plus sur les applications non validées ou obtenir des réponses aux questions fréquentes sur la validation des applications

Procédure d'inscription:

1. Créez un compte Google à l'adresse https://console.cloud.google.com/.
   • Ce compte servira à gérer les jetons d'accès de votre client de production. N'utilisez pas votre compte Gmail personnel.
   • Le compte ne peut pas être un groupe Google.
   • Si vous utilisez un projet Google Cloud existant:le compte doit être administrateur du projet.
2. Contactez Google DV360 avec les informations de compte que vous avez fournies pour qu'il soit ajouté à la liste d'autorisation.
3. Attendez que votre compte soit ajouté à la liste d'autorisation.
4. Facultatif et non bloquant:envoyez une demande d'examen de validation OAuth pour votre application afin d'accéder au champ d'application(doubleclickbidmanager).
5. Accédez à https://console.cloud.google.com/. Accédez à API et services -> Bibliothèque -> Privé. L'API DV360 Seller devrait figurer parmi les API disponibles.
6. Activer l'API DV360 Seller
7. Accédez à "Identifiants" -> "Créer un identifiant" -> "Clé de compte de service". Suivez les instructions sur la page https://developers.google.com/identity/protocols/OAuth2ServiceAccount.

   Configurez un compte de service:

   Remarque:Indiquez-nous si vous souhaitez réutiliser un compte de service existant, par exemple pour l'API DV360 Reporting.

   L'authentification et l'autorisation des API Google Cloud (couramment regroupées sous le nom "auth") s'effectuent généralement à l'aide d'un compte de service. Un compte de service permet à votre code d'envoyer directement les identifiants de l'application à l'API Cloud. Comme un compte utilisateur, un compte de service 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éé. À titre d'exemple, nous allons vous montrer comment créer des identifiants de compte de service à l'aide de la console Google Cloud Platform.

   Utiliser Google Cloud Console

   Sur la page Gestionnaire d'API → Identifiants de la console Google Cloud, sélectionnez "Créer des identifiants → Clé de compte de service".

   

   Sélectionnez ensuite "Nouveau compte de service" dans la liste déroulante "Compte de service".

   

   Donnez un nom au compte. Ce nom sera utilisé par défaut pour votre "ID de compte de service" (à gauche du signe "@" dans l'adresse de l'ID de compte de service générée), mais vous pouvez modifier ce nom d'ID de compte de service si vous le souhaitez. Ces noms peuvent être arbitraires, l'important est que vous vous en souveniez. Dans la catégorie "Type de clé", nous vous recommandons de laisser la valeur "JSON". Cliquez sur "Créer". La console GCP génère alors une clé JSON (en tant que fichier texte .json). Elle vous invite à télécharger le fichier sur votre ordinateur, puis affiche une boîte de dialogue Compte de service créé.

   

   La clé JSON générée ressemble à l'exemple suivant :

   {
     "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>[e-mail]",
     "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"
   }

   Stockez ce 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é). Vous devrez faire référence à ce fichier de clé de compte de service dans votre code lorsque vous souhaitez envoyer des identifiants à l'API Google Cloud Platform.

8. Contactez DV360 en indiquant les informations du compte de service que vous avez créé. Plus précisément, nous aurons besoin de l'adresse e-mail de ce compte de service. Il s'agit d'un autre processus de liste d'autorisation pour l'autorisation.
9. Une fois votre compte de service autorisé à appeler l'API, vous pouvez consulter la documentation de l'API sur la page https://developers.google.com/display-video/seller. Pour obtenir manuellement le jeton d'authentification, consultez les instructions sur https://github.com/google/oauth2l. (Vous devez déjà avoir téléchargé la version JSON de votre clé de compte de service). Vous trouverez également des instructions détaillées sur l'obtention du jeton OAuth de manière programmatique sur la page https://cloud.google.com/docs/authentication/production.

Important: Le champ d'application OAuth doit être "doubleclickbidmanager".