A tarefa Approval permite configurar integrações baseadas em aprovação. Também permite controlar o fluxo de uma integração.
Use a tarefa de aprovação para enviar e-mails de solicitação de aprovação a um ou mais usuários de integração. O e-mail inclui um link para a integração em que os usuários podem aprovar ou recusar manualmente a solicitação.
Durante uma execução de integração, quando o controle acessa a tarefa de aprovação, a execução é interrompida e todas as tarefas posteriores à tarefa de aprovação são suspensas.
A integração retoma a execução apenas quando um usuário aprova ou rejeita a solicitação de aprovação.
Uma tarefa de aprovação pode ser usada para as seguintes finalidades:
Para suspender e ramificar uma integração com base na aprovação ou rejeição do usuário.
Para suspender uma integração até uma duração especificada.
Usar como ponto de interrupção para depurar a integração.
Comparação entre tarefas de aprovação, de suspensão e de timer
As três tarefas (Aprovação,
Suspensão
e Cronômetro) executam uma função
semelhante de pausar e retomar uma integração. No entanto, há diferenças sutis entre elas. A tabela a seguir descreve as diferenças entre as três tarefas.
Tarefa "Aprovação"
Suspender tarefa
Tarefa cronômetro
Não é compatível com a retomada automática de uma integração e exige
intervenção manual para retomar a integração.
Aceita a retomada manual e automática de uma integração. Se não houver
uma intervenção manual para revogar a suspensão, a integração retomará
a execução automaticamente após o término do limite de tempo de suspensão.
Aceita apenas a retomada automática de uma integração. A execução da integração será retomada automaticamente após o término do limite de tempo de suspensão.
Não é possível retomar uma integração por meio de uma chamada de API. Resolva manualmente a
suspensão usando a IU de integrações.
Pode retomar uma integração usando a API Suspensions para integrações.
Aceita apenas a retomada automática de uma integração.
Os usuários recebem uma notificação quando uma integração é pausada (suspensa).
Os usuários não recebem nenhuma notificação quando uma integração é pausada (suspensa).
Os usuários não recebem nenhuma notificação quando uma integração é pausada (suspensa).
Aceita uma variável de saída (booleana), que permite realizar verificações condicionais
antes de retomar uma integração. No entanto, a variável de saída só pode ter o valor de true ou false.
Aceita uma variável de saída (string), que permite realizar verificações condicionais
antes de retomar uma integração. É possível definir qualquer valor para a variável de saída.
Não é compatível com nenhuma variável de saída.
Configurar a tarefa "Aprovação"
Para configurar a tarefa Aprovação:
No console Google Cloud , acesse a página Integração de aplicativos.
A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.
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:
Insira um nome e uma descrição no painel Criar integração.
Selecione uma região para a integração.
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 infoResumo da integração na barra de ferramentas de integração.
Clique em Criar. A integração recém-criada é aberta no editor de integração.
Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas e conectores disponíveis.
Clique e coloque o elemento de tarefa Approval no editor de integração.
Clique no elemento da tarefa Aprovação no designer para ver o painel de configuração
da tarefa Aprovação.
Configure os campos exibidos usando as propriedades de configuração da tarefa,
conforme detalhado na tabela abaixo.
As alterações nas propriedades são salvas automaticamente.
Propriedades de configuração
A tabela a seguir descreve as propriedades de configuração da tarefa de aprovação.
Propriedade
Tipo de dado
Descrição
Recipients
Matriz de strings
Endereços de e-mail para os quais a notificação é enviada quando a tarefa é suspensa. Insira vários endereços de e-mail separados por vírgula.
Custom notification message
String
Mensagem personalizada a ser incluída na notificação por e-mail quando a tarefa é suspensa. O valor pode ser um literal ou uma variável. Se a mensagem personalizada estiver disponível em uma variável, clique em VAR e selecione a variável.
Reminder frequency (in hours)
Número inteiro
Com que frequência as notificações de lembretes são exibidas.
Se a suspensão estiver em um estado não resolvido, você poderá enviar notificações por e-mail de lembrete solicitando que os usuários autorizados resolvam a suspensão.
Time until expiration (in hours)
Número inteiro
Período da suspensão.
Se a suspensão não for resolvida no prazo, ela será rejeitada por padrão.
On expiration
Booleano
Medidas a serem tomadas após a suspensão expirar.
Você pode rejeitar a suspensão ou cancelar a suspensão. Por padrão, a suspensão é recusada.
isApproved (Approval)
Booleano
Variável de saída que tem o status da suspensão após a resolução.
A variável isApproved será definida como True se a suspensão for aprovada e definida como False se a
suspensão for rejeitada.
Estratégia de solução de erros
A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar
devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[[["\u003cp\u003eThe Approval task allows you to configure integrations that require manual approval, giving you control over the integration flow by sending approval request emails to specified users.\u003c/p\u003e\n"],["\u003cp\u003eWhen an integration reaches the Approval task, execution pauses, suspending subsequent tasks until a user approves or rejects the request via a link provided in the email.\u003c/p\u003e\n"],["\u003cp\u003eUnlike Suspend and Timer tasks, the Approval task requires manual intervention to resume an integration and does not support automatic resumption or resumption via an API call.\u003c/p\u003e\n"],["\u003cp\u003eThe Approval task can be used to branch an integration based on approval/rejection, pause it for a set duration, or serve as a breakpoint for debugging.\u003c/p\u003e\n"],["\u003cp\u003eConfigurable properties for the Approval task include specifying recipients, a custom message, reminder frequency, expiration time, and action upon expiration, and it outputs a boolean variable (\u003ccode\u003eisApproved\u003c/code\u003e) that indicates the approval status.\u003c/p\u003e\n"]]],[],null,["# Approval Task\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nApproval Task\n=============\n\nThe **Approval** task lets you configure approval-based integrations. It also lets you control the flow of an integration.\n\n\nYou can use the **Approval** task to send approval request emails to one or more integration users. The email includes a link to the integration where the users can manually approve or reject the request.\n\nDuring an integration execution, when the control reaches the **Approval** task, execution is halted, and all tasks after the **Approval** task are suspended.\nThe integration resumes the execution only when a user manually approves or rejects the approval request.\n\n\nAn **Approval** task can be used for the following purposes:\n\n- To suspend and branch an integration based on user approval or rejection.\n- To suspend an integration until a specified duration.\n- To use as a breakpoint to debug the integration.\n\nCompare Approval task, Suspend task, and Timer task\n---------------------------------------------------\n\nAll the three ([Approval](/application-integration/docs/approval-task),\n[Suspend](/application-integration/docs/run-suspend-task),\nand [Timer](/application-integration/docs/run-timer-task)) tasks perform a similar\nfunction of pausing and resuming an integration. However, there are subtle differences\namong them. The following table describes the differences amongst the three tasks.\n\nConfigure the Approval task\n---------------------------\n\nTo configure the **Approval** task:\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. In the navigation menu, click **Integrations** .\n\n\n The **Integrations** page appears listing all the integrations available in the Google Cloud project.\n3. Select an existing integration or click **Create integration** to create a new one.\n\n\n If you are creating a new integration:\n 1. Enter a name and description in the **Create Integration** pane.\n 2. Select a region for the integration. **Note:** The **Regions** dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, click **Enable Region** . See [Enable new region](/application-integration/docs/enable-new-region) for more information.\n 3. Select a service account for the integration. You can change or update the service account details of an integration any time from the info **Integration summary** pane in the integration toolbar. **Note:** The option to select a service account is displayed only if you have enabled integration governance for the selected region.\n 4. Click **Create** . The newly created integration opens in the *integration editor*.\n\n\n4. In the *integration editor* navigation bar, click **Tasks** to view the list of available tasks and connectors.\n5. Click and place the **Approval** task element in the integration editor.\n6. Click the **Approval** task element on the designer to view the Approval task configuration pane.\n7. Configure the displayed fields using the [Configuration properties](#params) for the task as detailed in the table below.\n\n\n All changes to the properties are saved automatically.\n\nConfiguration properties\n------------------------\n\n\nThe following table describes the configuration properties of the **Approval** task.\n\nError handling strategy\n-----------------------\n\n\nAn error handling strategy for a task specifies the action to take if the task fails due to a [temporary error](/application-integration/docs/error-handling). For information about how to use an error handling strategy, and to know about the different types of error handling strategies, see [Error handling strategies](/application-integration/docs/error-handling-strategy).\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
