[Ultimate]{class="badge positive"}
Criar uma conexão de origem Google PubSub na interface
Este tutorial fornece etapas para a criação de um Google PubSub (a seguir denominado "PubSub") usando a interface do usuário da Platform.
Introdução
Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
- Fontes: o Experience Platform permite que os dados sejam assimilados de várias fontes e, ao mesmo tempo, fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços da plataforma.
- Sandboxes: o Experience Platform fornece sandboxes virtuais que particionam uma única instância da Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
Se você já tiver uma conexão PubSub válida, ignore o restante deste documento e prossiga para o tutorial em configurando um fluxo de dados.
Coletar credenciais necessárias
Você deve fornecer valores para as propriedades de conexão descritas abaixo para conectar sua conta do PubSub ao Experience Platform. Para obter mais informações sobre autenticação e configuração de pré-requisito, leia a PubSub source visão geral.
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Credencial | Descrição |
| ID do projeto | A ID do projeto necessária para autenticar PubSub. |
| Credenciais | A credencial necessária para autenticar PubSub. Certifique-se de colocar o arquivo JSON completo após remover os espaços em branco de suas credenciais. |
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Credencial | Descrição |
| Credenciais | A credencial necessária para autenticar PubSub. Certifique-se de colocar o arquivo JSON completo após remover os espaços em branco de suas credenciais. |
| Nome do tópico | O nome da sua assinatura do PubSub. No PubSub, as assinaturas permitem que você receba mensagens inscrevendo-se no tópico no qual as mensagens foram publicadas. Observação: uma única assinatura PubSub só pode ser usada para um fluxo de dados. Para fazer vários fluxos de dados, você deve ter várias assinaturas. |
| Nome da assinatura | O nome da sua assinatura do PubSub. No PubSub, as assinaturas permitem que você receba mensagens inscrevendo-se no tópico no qual as mensagens foram publicadas. |
Para obter mais informações sobre esses valores, consulte o seguinte documento PubSub authentication. Se você estiver usando autenticação baseada em conta de serviço, consulte o seguinte GuiaPubSub para obter etapas sobre como gerar suas credenciais.
Depois de obter as credenciais necessárias, você poderá seguir as etapas abaixo para vincular sua conta do PubSub à Platform.
Conectar sua conta do PubSub
Na interface da Platform, selecione Fontes na navegação à esquerda para acessar o espaço de trabalho Fontes. A tela Catálogo exibe uma variedade de fontes com as quais você pode criar uma conta.
Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a opção de pesquisa.
Na categoria Armazenamento na nuvem, selecione Google PubSub e Adicionar dados.
A página Conectar ao Google PubSub é exibida. Nesta página, você pode usar credenciais novas ou existentes.
Conta existente
Para usar uma conta existente, selecione a conta PubSub com a qual deseja criar um novo fluxo de dados e clique em Avançar para continuar.
Nova conta
- Ao criar uma conta com acesso restrito, você deve fornecer pelo menos um dos nomes do tópico ou da assinatura. A autenticação falhará se ambos os valores estiverem ausentes.
- Depois de criada, você não pode alterar o tipo de autenticação de uma conexão de base Google PubSub. Para alterar o tipo de autenticação, você deve criar uma nova conexão base.
Se você estiver criando uma nova conta, selecione Nova conta e forneça um nome e uma descrição opcional para sua nova conta PubSub.
A origem PubSub permite especificar o tipo de acesso que você deseja permitir durante a autenticação. Você pode configurar sua conta para ter autenticação baseada em projeto ou autenticação baseada em tópico e assinatura. A autenticação baseada em projeto permite conceder acesso ao projeto de nível raiz na sua conta, enquanto a autenticação baseada em tópico e assinatura permite restringir o acesso a um tópico e a uma assinatura específicos do PubSub.
Para criar uma conta com acesso à pasta raiz do projeto PubSub. Selecione Credenciais de autenticação do Google PubSub como seu tipo de autenticação e forneça suas credenciais e ID do projeto. Quando terminar, selecione Conectar à origem e aguarde algum tempo para que a nova conexão seja estabelecida.
Para criar uma conta com acesso restrito apenas a um tópico e assinatura específicos do PubSub, selecione Credenciais de autenticação do Google PubSub Scoped e forneça suas credenciais, nome do tópico e/ou nome da assinatura. Quando terminar, selecione Conectar à origem e aguarde algum tempo para que a nova conexão seja estabelecida.
Selecionar dados
Uma autenticação bem-sucedida leva você à etapa Selecionar dados, na qual é possível navegar pela hierarquia de dados PubSub e selecionar os dados que deseja trazer para o Experience Platform.
Se você autenticou com acesso baseado em projeto, a interface Selecionar dados exibirá todas as assinaturas do projeto com um tópico anexado a elas.
Se você autenticou com um tópico e acesso baseado em assinatura, a exibição da interface Selecionar dados poderá variar dependendo das informações fornecidas.
- Se você fornecer apenas o nome do tópico, a interface exibirá todos os pares de assinatura de tópico que correspondem ao tópico fornecido.
- Se você fornecer apenas o nome da subscrição, a interface exibirá todos os pares de topic-subscription que correspondem ao nome da subscrição fornecido.
- Se os nomes do tópico e da assinatura forem fornecidos, a interface exibirá o par topic-subscription que corresponde a ambos os valores fornecidos.
Próximas etapas
Seguindo este tutorial, você criou uma conexão entre sua conta do PubSub e a Plataforma. Agora você pode seguir para o próximo tutorial e configurar um fluxo de dados para trazer dados de transmissão do seu armazenamento na nuvem para a Platform.