Créer une connexion source Google PubSub dans l’interface utilisateur

Ce tutoriel décrit les étapes à suivre pour créer une connexion de source Google PubSub (ci-après dénommée « PubSub ») à l’aide de l’interface utilisateur de Platform.

Prise en main

Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :

  • Sources : Experience Platform permet d’ingérer des données provenant de diverses sources tout en vous offrant la possibilité de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services de Platform.
  • Sandbox : Experience Platform fournit des sandbox virtuels qui divisent une instance de plateforme unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience numérique.

Si vous disposez déjà d’une connexion PubSub valide, vous pouvez ignorer le reste de ce document et passer au tutoriel sur la configuration d’un flux de données.

Collecter les informations d’identification requises

Pour connecter PubSub à Platform, vous devez fournir une valeur valide pour les informations d’identification suivantes :

Informations d’identification Description
Identifiant du projet Identifiant de projet requis pour authentifier PubSub.
Informations d’identification Informations d’identification ou identifiant de clé privée requis pour l’authentification PubSub.
Nom de la rubrique Le nom de votre PubSub abonnement. Dans PubSub, les abonnements permettent de recevoir des messages, en s’abonnant à la rubrique sur laquelle les messages ont été publiés. Remarque: Une seule PubSub abonnement ne peut être utilisé que pour un seul flux de données. Pour créer plusieurs flux de données, vous devez disposer de plusieurs abonnements.
Nom de l’abonnement Le nom de votre PubSub abonnement. Dans PubSub, les abonnements permettent de recevoir des messages, en s’abonnant à la rubrique sur laquelle les messages ont été publiés.

Pour plus d’informations sur ces valeurs, consultez le document suivant : Authentification PubSub. Si vous utilisez l’authentification par compte de service, consultez le guide de PubSub et suivez les instructions pour générer vos informations d’identification.

CONSEIL

Si vous utilisez l’authentification par compte de service, assurez-vous que vous avez accordé un accès utilisateur suffisant à votre compte de service et qu’il n’y a pas d’espaces blancs supplémentaires dans le fichier JSON lors de la copie et du collage de vos informations d’identification.

Une fois que vous avez rassemblé les informations d’identification requises, vous pouvez suivre la procédure ci-dessous et lier votre compte PubSub à Platform.

Connecter votre compte PubSub

Dans l’interface utilisateur de Platform, sélectionnez Sources dans le volet de navigation de gauche pour accéder à l’espace de travail Sources. Le Catalogue affiche diverses sources avec lesquelles vous pouvez créer un compte.

Vous pouvez sélectionner la catégorie appropriée dans le catalogue sur le côté gauche de votre écran. Vous pouvez également trouver la source spécifique à utiliser à l’aide de l’option de recherche.

Dans la catégorie Espace de stockage, sélectionnez Google PubSub, puis cliquez sur Ajouter des données.

Catalogue des sources sur l’interface utilisateur Experience Platform.

La page Connexion à Google PubSub s’affiche. Sur cette page, vous pouvez utiliser de nouvelles informations d’identification ou des informations d’identification existantes.

Compte existant

Pour utiliser un compte existant, sélectionnez le compte PubSub avec lequel vous souhaitez créer un flux de données, puis sélectionnez Suivant pour continuer.

La sélection de compte existante dans le workflow des sources.

Nouveau compte

CONSEIL

Lors de la création d’un compte avec accès restreint, vous devez indiquer au moins un nom de rubrique ou d’abonnement. L’authentification échoue si les deux valeurs sont manquantes.

Si vous créez un compte, sélectionnez Nouveau compte, puis fournissez un nom et une description facultative de votre nouvelle PubSub compte .

Nouvelle interface de compte pour Google PubSub dans le processus des sources

Le PubSub source vous permet de spécifier le type d’accès que vous souhaitez autoriser lors de l’authentification. Vous pouvez configurer votre compte pour qu’il dispose d’une authentification basée sur le projet ou d’une authentification par rubrique et par abonnement. L’authentification basée sur un projet vous permet d’accorder l’accès au projet racine dans votre compte, tandis que l’authentification par rubrique et par abonnement vous permet de restreindre l’accès à un PubSub rubrique et abonnement.

Pour créer un compte ayant accès à la racine PubSub dossier du projet. Sélectionner Identifiants d’authentification Google PubSub comme type d’authentification et fournissez votre ID de projet et vos informations d’identification. Lorsque vous avez terminé, sélectionnez Se connecter à la source puis attendez que la nouvelle connexion s’établisse.

Nouvelle interface de compte pour le PubSub Google avec accès racine sélectionné.

Pour créer un compte avec accès limité uniquement à un PubSub rubrique et abonnement, sélectionnez Informations d’identification d’authentification de Google PubSub et indiquez ensuite vos informations d’identification, le nom de la rubrique et/ou le nom de l’abonnement. Lorsque vous avez terminé, sélectionnez Se connecter à la source puis attendez que la nouvelle connexion s’établisse.

Nouvelle interface de compte pour la sous-source de publication Google avec accès limité sélectionné.
REMARQUE

Principal (rôles) affecté à un PubSub les projets sont hérités dans toutes les rubriques et tous les abonnements créés dans une PubSub projet. Si vous souhaitez qu’une entité (rôle) ait accès à une rubrique spécifique, cette entité (rôle) doit également être ajoutée à l’abonnement correspondant à la rubrique. Pour plus d’informations, reportez-vous à la section [PubSub documentation sur le contrôle d’accès] (https://cloud.google.com/pubsub/docs/access-control).

Sélectionner les données

Une authentification réussie vous permet d’accéder à la variable Sélectionner des données , où vous pouvez parcourir votre PubSub hiérarchie des données et sélectionnez les données à importer dans Experience Platform.

Si vous vous êtes authentifié avec un accès basé sur un projet, la variable Sélectionner des données affiche tous les abonnements au sein de votre projet auxquels est associée une rubrique.

L’étape de sélection des données du workflow des sources avec authentification basée sur le projet.

Si vous vous êtes authentifié avec une rubrique et un accès par abonnement, la variable Sélectionner des données l’affichage de l’interface peut varier en fonction des informations que vous avez fournies.

  • Si vous indiquez uniquement le nom de la rubrique, l’interface affiche toutes les paires rubrique-abonnement qui correspondent à la rubrique fournie.
  • Si vous fournissez uniquement le nom de l’abonnement, l’interface affiche toutes les paires rubrique-abonnement qui correspondent au nom d’abonnement fourni.
  • Si des noms de rubrique et d’abonnement sont fournis, l’interface affiche la paire rubrique-abonnement qui correspond aux deux valeurs fournies.

L’étape de sélection des données du workflow des sources avec l’authentification par rubrique et par abonnement.

Étapes suivantes

En suivant ce tutoriel, vous avez créé une connexion entre votre PubSub compte et plateforme. Vous pouvez maintenant passer au tutoriel suivant et configurer un flux de données pour importer des données de diffusion en continu depuis votre espace de stockage dans Platform.

Sur cette page