Configurer l'authentification

Intégration à l'API Display &Video 360 Seller

L'intégration à l'API Display &Video 360 Seller comporte quelques étapes clés. L'API DV360 Seller est une API Google Cloud basée sur une liste d'autorisation. Elle utilise OAuth 2.0 pour l'authentification et l'autorisation.

Le processus d'autorisation est géré par l'équipe de l'API Display &Video 360 Seller.

Procédure d'intégration :

  1. Inscrivez-vous à un compte Google en accédant à https://console.cloud.google.com/.
    • Ce compte sera utilisé pour gérer les jetons d'accès de votre client de production. N'utilisez pas de 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 l'équipe Google DV360 en lui fournissant les informations de votre compte pour l'ajouter à la liste d'autorisation.
  3. Attendez la confirmation que votre compte a été activé.
  4. Facultatif et non bloquant : envoyez une demande de validation OAuth pour votre application afin d'accéder au champ d'application https://www.googleapis.com/auth/doubleclickbidmanager.
  5. Dans la console Google Cloud, accédez à API et services > Bibliothèque > Privé. L'API DV360 Seller devrait être disponible pour votre projet.
  6. Activez l'API DV360 Seller.
  7. Accédez à API et services > Identifiants > Créer des identifiants > Clé de compte de service. Suivez les instructions de configuration de la documentation sur les comptes de service OAuth 2.0.

    Configurer un compte de service :

    Remarque : Indiquez-nous si vous souhaitez réutiliser un compte de service existant, par exemple celui utilisé 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. Un compte de service, tel qu'un compte utilisateur, est représenté par une adresse e-mail. Toutefois, 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éé. Par exemple, nous allons vous montrer comment créer des identifiants de compte de service à l'aide de la console Google Cloud Platform.

    Utiliser la console Google Cloud

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

    alt_text

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

    alt_text

    Saisissez un nom pour ce compte de service. Ce nom sera utilisé par défaut pour votre "ID de compte de service" (à gauche du signe "@" dans l'adresse d'ID de compte de service générée), mais vous pouvez le modifier 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éé.

    alt_text

    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>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"
}

    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 souhaiterez envoyer des identifiants à l'API Google Cloud Platform.

  8. Contactez l'équipe DV360 en lui fournissant les informations du compte de service que vous avez créé (en particulier, l'adresse e-mail du compte de service). Il s'agit d'une deuxième étape d'autorisation.
  9. Une fois que votre compte de service est autorisé à appeler l'API, vous pouvez consulter la documentation de l'API DV360 Seller. Pour obtenir manuellement un jeton d'authentification, consultez les instructions du dépôt de l'outil oauth2l (en utilisant la clé de compte de service JSON que vous avez téléchargée). Vous trouverez des instructions détaillées sur l'obtention programmatique de jetons OAuth dans la documentation sur l'authentification Google Cloud.

Important : Le champ d'application OAuth doit être https://www.googleapis.com/auth/doubleclickbidmanager

Précédent
Vue d'ensemble
Suivant
Bibliothèque cliente