Aperçu

Vous pouvez créer et gérer des segments de données à l'aide de l' API Curation Partners, qui expose une curators.dataSegments ressource. 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 Curation Partners.

  1. Si vous ne l'avez pas déjà fait, créez un projet Google Cloud qui héberge les identifiants utilisés pour accéder à l'API.

  2. Accédez à la page Google Cloud Console Enabled APIs. Sélectionnez le projet que vous avez créé précédemment.

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

    1. Recherchez Curation Partners API dans la zone de recherche.
    2. Sélectionnez Curation Partners API dans la page de résultats.
    3. Cliquez sur Activer.

    Il s'agit d'un problème connu : il est possible que vous ne puissiez pas trouver l'API Curation Partners dans la zone de recherche de Google Cloud Console. Vous pouvez également utiliser Google Cloud CLI pour activer l'API. Après avoir installé gcloud CLI, vous pouvez activer l'API Curation Partners à l'aide de la commande suivante :

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. Dans le menu de navigation, sélectionnez 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 éventuellement configurer les autorisations du compte de service, puis cliquez sur Continuer.

  8. Vous pouvez éventuellement configurer les utilisateurs ou les groupes autorisés à effectuer des actions en tant que compte de service, puis cliquez sur OK.

  9. Votre nouveau compte de service s'affiche 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 JSON comme type de clé, puis cliquez sur Créer.

  13. Téléchargez la clé dans votre répertoire de travail. Pour en savoir plus sur le stockage sécurisé de votre clé, consultez la page Gérer des 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 associer le compte de service à votre compte.

Champs d'application de l'API

Lorsque vous suivez 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 vous pouvez accéder à l'aide de ce jeton. Pour l'API Curation Partners, le champ d'application est https://www.googleapis.com/auth/curation-partners.

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

Dans l'API Curation Partners, les segments de données sont identifiés par un nom de ressourcespécifique à l'API , tel que :

"curators/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 le nom de ressource complet fourni par l'API dans le champ name.

Étapes suivantes