A tarefa Retorno permite personalizar as mensagens de erro correspondentes aos códigos de resposta HTTP retornados durante uma falha de execução de integração.
É possível modificar ou personalizar mensagens de erro para os seguintes códigos de resposta HTTP:
Código HTTP
Código canônico
400
INVALID_ARGUMENT
400
OUT_OF_RANGE
401
UNAUTHENTICATED
403
PERMISSION_DENIED
404
NOT_FOUND
409
ALREADY_EXISTS
429
RESOURCE_EXHAUSTED
499
CANCELLED
Configuração da tarefa Return
Para configurar a tarefa Return:
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 Return no editor de integração.
Clique no elemento de tarefa Return do designer para abrir o painel de configuração de tarefa Return.
Configure os campos exibidos usando as Propriedades de configuração para a tarefa, conforme detalhado nas tabelas abaixo.
As alterações nas propriedades são salvas automaticamente.
Propriedades de configuração
Confira na tabela a seguir as propriedades de configuração da tarefa Return.
Propriedade
Tipo de dado
Descrição
HTTP code
Inteiro
O código HTTP 4XX para o qual você quer personalizar a mensagem de erro.
Customized return message
String
A mensagem de erro personalizada para o código HTTP especificado.
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 \u003cstrong\u003eReturn\u003c/strong\u003e task allows users to customize error messages for specific HTTP response codes that occur during integration execution failures.\u003c/p\u003e\n"],["\u003cp\u003eUsers can modify error messages for a range of HTTP codes, including 400, 401, 403, 404, 409, 429, and 499, each associated with a specific canonical error code.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring the \u003cstrong\u003eReturn\u003c/strong\u003e task involves navigating to the Application Integration page, selecting an integration, placing the \u003cstrong\u003eReturn\u003c/strong\u003e task in the editor, and setting the desired HTTP code and custom error message.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003cstrong\u003eReturn\u003c/strong\u003e task configuration properties include specifying the HTTP code and the customized return message to be displayed upon error.\u003c/p\u003e\n"],["\u003cp\u003eUsers can find information on error handling strategies and quotas and limits for the return task in the documentation.\u003c/p\u003e\n"]]],[],null,["# Return task\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nReturn task\n===========\n\nThe **Return** task lets you customize the error messages corresponding to the HTTP response codes that are returned during an integration execution failure.\nYou can modify or customize error messages for the following HTTP response codes:\n\nConfigure the Return task\n-------------------------\n\nTo configure the **Return** 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 **Return** task element in the integration editor.\n6. Click the **Return** task element on the designer to open the **Return** task configuration pane.\n7. Configure the displayed fields using the [Configuration properties](#params) for the task as detailed in the tables 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 **Return** 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)."]]
