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.
Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :
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.
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.
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.
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.
La page Connexion à Google PubSub s’affiche. Sur cette page, vous pouvez utiliser de nouvelles informations d’identification ou des informations d’identification existantes.
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.
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 .
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.
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.
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).
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.
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.
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.