Aperçu

Vous pouvez créer et gérer des segments de données à l'aide de l'API Authorized Buyers Marketplace, qui expose une ressource curators.dataSegments. Il s'agit d'une API REST avec des bibliothèques clientes générées que vous pouvez utiliser pour votre intégration.

Configurer l'authentification

Les API Google utilisent le protocole OAuth 2.0 pour l'authentification et l'autorisation. Voici comment configurer un compte de service pour accéder à l'API Marketplace.

  1. Si vous ne l'avez pas déjà fait, créez un projet Google Cloud qui héberge vos identifiants utilisés pour accéder à l'API.
  2. Accédez à la page API activées de la console Google Cloud. Sélectionnez le projet que vous avez créé précédemment.

  3. Une liste des API et des services activés s'affiche. Pour accéder à l'API Marketplace, vous devez l'activer. Si l'API Marketplace n'est pas activée, cliquez sur + Activer les API et les services, puis suivez les instructions ci-dessous :

    1. Vous êtes redirigé vers une page contenant un champ de recherche. Recherchez l'API Marketplace Authorized Buyers.
    2. Sélectionnez API Marketplace Authorized Buyers sur la page de résultats.
    3. Cliquez sur Activer.
  4. Dans le menu de navigation, sélectionnez Credentials (Identifiants).
  5. Cliquez sur + Créer des identifiants, puis sélectionnez Compte de service dans le menu déroulant qui s'affiche.
  6. Saisissez un nom pour le compte de service. L'ID du compte de service est créé automatiquement lors de la création. Notez cette valeur, car vous en aurez besoin à l'étape 14. Si vous le souhaitez, saisissez une description. Cliquez sur Créer et continuer.
  7. Vous pouvez configurer les autorisations du compte de service, puis cliquer sur Continuer.
  8. Vous pouvez éventuellement configurer les utilisateurs ou les groupes autorisés à effectuer des actions en tant que compte de service, puis cliquer sur OK.
  9. Votre nouveau compte de service est listé sous Comptes de service. Recherchez et cliquez sur l'ID du compte de service que vous venez de créer.
  10. Cliquez sur l'onglet Clés.
  11. Dans le menu déroulant Ajouter une clé, sélectionnez Créer une clé.
  12. Sélectionnez le type de clé JSON, puis cliquez sur Créer.
  13. Téléchargez la clé dans votre répertoire de travail. Pour savoir comment stocker votre clé de façon sécurisée, consultez Gérer les clés de compte de service. La clé est utilisée par votre application pour effectuer des appels d'API.
  14. Partagez l'ID du compte de service avec votre responsable de compte technique pour l'associer à votre compte.

Champs d'application de l'API

Lorsque vous parcourez le flux OAuth 2.0 pour recevoir un jeton d'accès utilisé pour effectuer un appel d'API, vous devez spécifier les API auxquelles il est possible d'accéder à l'aide de ce jeton. Pour l'API Marketplace Authorized Buyers, ce champ d'application est https://www.googleapis.com/auth/authorized-buyers-marketplace.

Identifier les segments de données dans l'API par rapport à la curation en temps réel

Dans l'API Marketplace, les segments de données sont identifiés par un nom de ressource spécifique à l'API, par exemple :

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

Lorsque vous identifiez les segments de données pertinents pour une opportunité publicitaire dans la curation en temps réel, spécifiez la valeur de l'ID de ressource DATA_SEGMENT_ID plutôt que la ressource name complète utilisée par l'API.

Étapes suivantes