Consulte os conectores compatíveis com a integração de aplicativos.

Gatilho do Cloud Pub/Sub

O gatilho do Cloud Pub/Sub permite executar a integração com base nos eventos do seu middleware do Pub/Sub.

Com esse gatilho, é possível executar uma integração sempre que um editor escreve uma mensagem no tópico escolhido por você. O tópico pode existir no mesmo projeto do Google Cloud que a integração ou em um projeto diferente. Quando esse acionador é executado, ele também grava a mensagem publicada na variável de saída CloudPubSubMessage. Com base nos seus requisitos, é possível usar essa variável nos gatilhos ou tarefas downstream.

Para saber como criar uma integração de amostra usando a Application Integration e o gatilho de gatilho do Cloud Pub/Sub, consulte Ouvir o tópico do Cloud Pub/Sub e enviar um e-mail.

Antes de começar

Execute as tarefas a seguir no projeto do Google Cloud antes de configurar o gatilho do Cloud Pub/Sub.

• Atribua o Administrador do IAM do projeto (roles/resourcemanager.projectIamAdmin) ao usuário que está criando o acionador.
• Ative a API Pub/Sub. para o projeto do Google Cloud que tem sua integração.
• Confirme se você tem um tópico do Pub/Sub. Para criar um novo tópico do Pub/Sub:
  1. Acesse a página de tópicos do Pub/Sub no Console do Cloud

     Acesse a página de tópicos do Cloud Pub/Sub.

  2. Clique em Criar um tópico
  3. No campo ID do tópico, forneça um nome de tópico exclusivo.
  4. Clique em Salvar.
  Observação: não é preciso criar uma assinatura para o acionador funcionar. A integração de aplicativos cria automaticamente uma assinatura para um tópico quando você publica a integração. É possível conferir todas as assinaturas na página de assinaturas do Pub/Sub.

  Noções básicas do Application Integration versão de 1o de dezembro de 2023, você vai: serão cobrados por suas assinaturas de acordo com as taxas de faturamento do Pub/Sub. Assinaturas do seu gatilho do Cloud Pub/Sub atual continuará funcionando como antes e eles não serão faturados. No entanto, se você atualizar o tópico de um acionador do Cloud Pub/Sub, o faturamento do Pub/Sub será aplicado ao acionador atualizado.

Para mais informações sobre como gerenciar o acesso usando papéis do IAM, consulte Controle de acesso.

Para informações sobre como conceder papéis a principais, consulte Como conceder, alterar e revogar acesso.

Adicionar um gatilho do Cloud Pub/Sub

Para adicionar um gatilho do Cloud Pub/Sub a uma integração nova ou existente, siga as etapas abaixo:

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Lista de integrações aparece com todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração ou clique em Criar integração para criar uma nova.

   Caso você esteja criando uma nova integração, siga estas etapas:

   1. Insira um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas de integração.
      Observação: a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração para a região selecionada.
   4. Clique em Criar.

   Isso abre a integração na página do editor de integração.

4. Na barra de navegação do editor de integração, clique em Gatilhos para conferir a lista de acionadores disponíveis.
5. Clique e posicione o elemento Gatilho do Cloud Pub/Sub no designer.

Configurar um gatilho do Cloud Pub/Sub

Clique no elemento de gatilho do Cloud Pub/Sub no editor de integração para exibir o painel de configuração do gatilho e faça o seguinte:

1. Especifique o tópico que o gatilho ouvirá no campo Tópico do Pub/Sub no seguinte formato:

   projects/PROJECT_ID/topics/TOPIC_ID

   Para exibir todos os tópicos disponíveis no seu projeto do Google Cloud, confira a coluna Nome do tópico em Tópicos. Também é possível selecionar um tópico de outro projeto do Google Cloud.

   Substitua:
   • PROJECT_ID é o projeto do Google Cloud em que o tópico foi criado.
   • TOPIC_ID é o ID do tópico do Pub/Sub. O tópico pode estar no mesmo projeto do Google Cloud que da sua integração ou podem estar presentes em outro projeto do Google Cloud.
2. Selecione a conta de serviço que você quer usar para invocar a integração. Também é possível escolher uma variável de configuração criada na integração. O valor da variável de configuração precisa ser um endereço de e-mail da conta de serviço com o seguinte formato: [e-mail]. Por exemplo, [e-mail].

   Para saber como criar uma variável de configuração, consulte Criar uma variável. Para saber como criar uma conta de serviço, consulte Criar uma conta de serviço.

   Se você escolher uma variável de configuração, precisará conceder os papéis necessários à conta de serviço a que ela se refere. Para mais informações sobre como conceder papéis, consulte Papéis obrigatórios do IAM.

   Se não houver contas de serviço, clique em Criar nova na lista Conta de serviço.

   Observação: a partir da versão de 1º de dezembro de 2023 da integração de aplicativos, ao configurar o gatilho do Cloud Pub/Sub, é necessário especificar uma conta de serviço para o gatilho. Seus gatilhos do Pub/Sub atuais, que não têm nenhum serviço associada a eles continuarão funcionando como antes. No entanto, se você modificar qualquer um dos gatilhos do Pub/Sub, configure um a conta de serviço para continuar usando esses gatilhos.

Por padrão, a opção de período de validade das assinaturas é definida como never expire. Se você quiser definir a expiração como outro valor, acesse a página de assinatura do Pub/Sub no console do Google Cloud e edite a assinatura.

Papéis do IAM necessários para contas de serviço

Ao clicar em Conceder ao selecionar uma conta de serviço, os papéis a seguir são atribuídos automaticamente às várias contas de serviço.

Conta de serviço	Papel do IAM concedido
Conta de serviço padrão do Application Integration: [e-mail]	Editor do Pub/Sub (roles/pubsub.editor) Usuário da conta de serviço (roles/iam.serviceAccountUser) Se o projeto do Google Cloud do tópico do Pub/Sub for diferente do projeto do Google Cloud da integração, a conta de serviço padrão precisará do papel de editor do Pub/Sub no projeto do Google Cloud do tópico.
Conta de serviço selecionada para este gatilho	Invocador do Application Integration (roles/integrations.integrationInvoker)

Saída do gatilho

Para cada evento, o acionador do Cloud Pub/Sub gera uma variável de saída CloudPubSubMessage que pode ser usada nas tarefas downstream. A variável está no formato JSON e tem a estrutura PubsubMessage.

Considerações

• O tamanho máximo de uma mensagem do Pub/Sub é de 10 MB. Para entender todas as limitações do Pub/Sub, consulte Cotas e limites do Pub/Sub.
• É possível que o Pub/Sub escreva a mesma mensagem mais de uma vez em um tópico. Para entender esse comportamento do Pub/Sub, consulte Entrega pelo menos uma vez. Por isso, você precisa projetar a integração como idempotente para que ela não permita que uma mensagem seja gravada mais de uma vez em um tópico.

  O campo message_id no cabeçalho da mensagem identifica exclusivamente uma mensagem do Pub/Sub.

• Se você cancelar a publicação de uma integração, a assinatura do Pub/Sub não será excluída para evitar a perda de mensagens. No entanto, se você excluir a versão publicada ou todas as versões de uma integração, a assinatura do Pub/Sub também será excluída.

Criar assinatura com filtro para sua integração

Se você quiser definir um filtro para que a assinatura do Pub/Sub processe eventos específicos na sua integração, siga estas etapas:

1. Publique a integração com o gatilho do Cloud Pub/Sub configurado. Esta etapa cria a assinatura no projeto de integração.
2. No console do Google Cloud, acesse a página Assinaturas.

   Acessar "Assinaturas"

3. Abra a assinatura e copie todos os detalhes, incluindo o nome dela.
4. Exclua a assinatura atual.
5. Crie uma nova assinatura com todos os detalhes da assinatura excluída, incluindo o nome dela, que você copiou na etapa 3 e adicione um filtro à nova assinatura.

   A assinatura recém-criada aciona a integração com as mensagens filtradas.

Exclusões do SLA

O gatilho do Cloud Pub/Sub depende do Pub/Sub produto. Como essa dependência é externa à integração de aplicativos, os termos e condições do contrato de nível de serviço (SLA) da integração de aplicativos são aplicáveis apenas quando o gatilho do Cloud Pub/Sub inicia a execução de uma integração active.

Preços

Os gatilhos do Cloud Pub/Sub e do Salesforce não exigem a criação de um conector. No entanto, se você usar a tarefa Conectores para se conectar ao Pub/Sub ou ao Salesforce, receberá uma cobrança pelo uso do conector. Para informações sobre preços, consulte Preços do Application Integration.

Cotas e limites

Para informações sobre o assunto, consulte Cotas e limites.

A seguir

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais sobre o tratamento de erros.
• Saiba mais sobre os registros de execução de integração.