[Ultimate]{class="badge positive"}
Crear una conexión de origen Google PubSub en la interfaz de usuario
Este tutorial proporciona los pasos para crear un(a) Google PubSub (denominado(a) "PubSub") mediante la interfaz de usuario de Platform.
Introducción
Este tutorial requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:
- Fuentes: El Experience Platform permite la ingesta de datos de varias fuentes, al tiempo que le ofrece la capacidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Platform.
- Zonas protegidas: El Experience Platform proporciona zonas protegidas virtuales que dividen una sola instancia de Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.
Si ya tiene una conexión PubSub válida, puede omitir el resto de este documento y continuar con el tutorial sobre configuración de un flujo de datos.
Recopilar credenciales necesarias
Debe proporcionar valores para las propiedades de conexión que se indican a continuación a fin de conectar su cuenta de PubSub al Experience Platform. Para obtener más información sobre la autenticación y la configuración de requisitos previos, lea la PubSub source descripción general.
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Credencial | Descripción |
| Identificador de proyecto | Identificador de proyecto necesario para autenticar PubSub. |
| Credenciales | Credencial necesaria para autenticar PubSub. Debe asegurarse de colocar el archivo JSON completo después de eliminar los espacios en blanco de las credenciales. |
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Credencial | Descripción |
| Credenciales | Credencial necesaria para autenticar PubSub. Debe asegurarse de colocar el archivo JSON completo después de eliminar los espacios en blanco de las credenciales. |
| Nombre del tema | Nombre de su suscripción a PubSub. En PubSub, las suscripciones le permiten recibir mensajes, mediante suscripción al tema en el que se han publicado los mensajes. Nota: una sola suscripción de PubSub solo se puede usar para un flujo de datos. Para poder crear varios flujos de datos, debe tener varias suscripciones. |
| Nombre de suscripción | Nombre de su suscripción a PubSub. En PubSub, las suscripciones le permiten recibir mensajes, mediante suscripción al tema en el que se han publicado los mensajes. |
Para obtener más información sobre estos valores, consulte el siguiente documento Autenticación PubSub. Si está usando autenticación basada en cuentas de servicio, consulte la siguiente guía de PubSub para ver los pasos sobre cómo generar sus credenciales.
Una vez que haya recopilado las credenciales necesarias, puede seguir los pasos a continuación para vincular su cuenta de PubSub a Platform.
Conectar su cuenta de PubSub
En la interfaz de usuario de Platform, seleccione Sources en el panel de navegación izquierdo para acceder al área de trabajo Sources. La pantalla Catálogo muestra una variedad de orígenes con los que puede crear una cuenta.
Puede seleccionar la categoría adecuada del catálogo en la parte izquierda de la pantalla. También puede encontrar la fuente específica con la que desea trabajar utilizando la opción de búsqueda.
En la categoría Almacenamiento en la nube, seleccione Google PubSub y, a continuación, seleccione Agregar datos.
Aparecerá la página Conectarse a Google PubSub. En esta página, puede usar credenciales nuevas o existentes.
Cuenta existente
Para usar una cuenta existente, seleccione la cuenta de PubSub con la que desee crear un nuevo flujo de datos y, a continuación, seleccione Siguiente para continuar.
Nueva cuenta
- Al crear una cuenta con acceso restringido, debe proporcionar al menos uno de los nombres de tema o de suscripción. La autenticación fallará si faltan ambos valores.
- Una vez creada, no se puede cambiar el tipo de autenticación de una conexión base de Google PubSub. Para cambiar el tipo de autenticación, debe crear una nueva conexión base.
Si va a crear una cuenta nueva, seleccione Nueva cuenta y, a continuación, proporcione un nombre y una descripción opcional para la nueva cuenta de PubSub.
El origen PubSub le permite especificar el tipo de acceso que desea permitir durante la autenticación. Puede configurar su cuenta para que tenga autenticación basada en el proyecto o en temas y suscripciones. La autenticación basada en proyectos le permite conceder acceso al proyecto de nivel raíz en su cuenta, mientras que la autenticación basada en temas y suscripciones le permite restringir el acceso a un tema y suscripción de PubSub en particular.
Para crear una cuenta con acceso a la carpeta raíz del proyecto PubSub. Seleccione Credenciales de autenticación de Google PubSub como tipo de autenticación y proporcione su ID de proyecto y credenciales. Cuando termine, seleccione Conectarse al origen y deje pasar un tiempo para que se establezca la nueva conexión.
Para crear una cuenta con acceso restringido solo a un tema y suscripción de PubSub en particular, seleccione Credenciales de autenticación de ámbito PubSub de Google y, a continuación, proporcione sus credenciales, nombre del tema y/o nombre de suscripción. Cuando termine, seleccione Conectarse al origen y deje pasar un tiempo para que se establezca la nueva conexión.
Seleccionar datos
Una autenticación correcta le lleva al paso Seleccionar datos, donde puede navegar por la jerarquía de datos de PubSub y seleccionar los datos que desea llevar al Experience Platform.
Si se ha autenticado con acceso basado en proyectos, la interfaz Select data mostrará todas las suscripciones dentro del proyecto que tengan un tema adjunto a ellas.
Si se ha autenticado con un tema y acceso basado en suscripción, la visualización de la interfaz Seleccionar datos puede variar según la información que haya proporcionado.
- Si proporciona solo el nombre del tema, la interfaz muestra todos los pares de tema-suscripción que corresponden al tema proporcionado.
- Si solo proporciona el nombre de suscripción, la interfaz muestra todos los pares de tema-suscripción que corresponden al nombre de suscripción proporcionado.
- Si se proporcionan tanto el tema como los nombres de suscripción, la interfaz muestra el par tema-suscripción que corresponde con ambos valores proporcionados.
Pasos siguientes
Al seguir este tutorial, ha creado una conexión entre su cuenta de PubSub y Platform. Ahora puede continuar con el siguiente tutorial y configurar un flujo de datos para llevar los datos de streaming de su almacenamiento en la nube a Platform.