La tarea Llamar a extremo de REST te permite llamar a cualquier API de REST de terceros desde tu integración. La respuesta de la llamada a la API de REST estará disponible en una variable de integración y se puede usar en otras tareas posteriores.
Si tu integración tiene configurados un perfil de OAuth 2.0 y una cuenta de servicio administrada por el usuario, de forma predeterminada, el perfil de OAuth 2.0 se usa para la autenticación. Si no se configuraron el perfil de OAuth 2.0 ni la cuenta de servicio administrada por el usuario, la ejecución falla.
Si tu integración tiene una cuenta de servicio adjunta, entonces, según la URL del extremo de REST, otorga el rol de IAM necesario a esa cuenta de servicio. Por ejemplo, si la URL del extremo de REST llama a un servicio de Cloud Storage, otorga el rol de IAM necesario para el servicio de Cloud Storage.
En el menú de navegación, haz clic en Integraciones.
Aparecerá la página Integraciones con todas las integraciones disponibles en el proyecto de Google Cloud.
Selecciona una integración existente o haz clic en Crear integración para crear una nueva.
Si creas una integración nueva, haz lo siguiente:
Ingresa un nombre y una descripción en el panel Crear integración.
Selecciona una región para la integración.
Selecciona una cuenta de servicio para la integración. Puedes cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integracióninfo en la barra de herramientas de integración.
Haz clic en Crear. La integración recién creada se abre en el editor de integración.
En la barra de navegación del editor de integración, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
Haz clic y coloca el elemento Llamar a extremo de REST en el editor de integración.
Haz clic en el elemento Llamar a extremo de REST en el diseñador para ver el panel de configuración de tareas Llamar a extremo de REST.
Configura los campos que se muestran con las propiedades de configuración de la tarea, como se detalla en la siguiente tabla.
Los cambios en las propiedades se guardan de forma automática.
Propiedades de configuración
En la siguiente tabla, se describen las propiedades de configuración de la tarea Llamar a extremo de REST.
URL del extremo de REST sin los parámetros de consulta.
Método HTTP
NA
Método HTTP para usar.
Puedes seleccionar cualquiera de los siguientes métodos HTTP:
BORRAR
GET
HEAD
PATCH
POST
PUT
Parámetros de la cadena de consulta de URL
Clave de cadena de consulta: String
Valor: String
Consulta los parámetros necesarios para la llamada a la API de REST.
Los parámetros de consulta tienen la forma de pares clave-valor en los que la clave es el nombre de la clave y el valor es el valor de clave correspondiente. Para ingresar más de un par clave-valor, haz clic en el ícono de signo más.
Encabezados HTTP
Clave de encabezado HTTP: String
Valor: String
Encabezados HTTP obligatorios para la llamada a la API de REST.
Los encabezados HTTP tienen la forma de pares clave-valor en el que la clave es el nombre de la clave y el valor es el valor de la clave correspondiente. Para ingresar más de un par clave-valor, haz clic en el ícono del signo más.
Sigue los redireccionamientos
Booleano
Sigue los redireccionamientos de las URL.
Puedes seleccionar cualquiera de los siguientes valores:
True: Llama a la URL de redireccionamiento si la URL base del extremo se reenvía a otra.
False: No llama a la URL redireccionada si la URL base del extremo se reenvía a otra URL.
La tarea debería fallar en error de HTTP
Booleano
Estrategia de manejo de excepciones cuando falla la llamada a la API de REST.
El extremo de REST de la llamada falla si el código de respuesta HTTP es 4xx o 5xx. Para obtener una lista de códigos de error, consulta Códigos de error. Para otros códigos de respuesta HTTP, muestra el código de error y el mensaje de error en la respuesta.
Puedes seleccionar cualquiera de los siguientes valores:
True: Muestra una excepción.
False: No arroja una excepción. Sin embargo, muestra el código y el mensaje de error en la respuesta.
Encabezado de respuesta (<Task name>)
Cadena
Encabezado de respuesta sin comprimir de la respuesta de la API de REST.
Cuerpo de la respuesta (<Task name>)
Cadena
Cuerpo de respuesta sin comprimir de la respuesta de la API de REST.
Estado de la respuesta (<Task name>)
Cadena
Código de respuesta HTTP y el texto de código correspondiente de la respuesta de la API de REST.
Prácticas recomendadas
Para obtener más información sobre los límites de uso que se aplican a la tarea Llamar a extremo de REST, consulta Límites de uso.
Estrategia de manejo de errores
Una estrategia de manejo de errores de una tarea específica la acción que se debe realizar si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de manejo de errores y conocer los diferentes tipos de estrategias de manejo de errores, consulta Estrategias de manejo de errores.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-03 (UTC)"],[[["\u003cp\u003eThe \u003cstrong\u003eCall REST Endpoint\u003c/strong\u003e task enables integrations to interact with any third-party REST API, with the response data being accessible for use in subsequent tasks.\u003c/p\u003e\n"],["\u003cp\u003eThis task is restricted to calling endpoints accessible over the public internet and cannot connect to resources within private networks like VPCs.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication for REST API calls requires either a pre-configured OAuth 2.0 profile or an attached user-managed service account, however, authentication isn't needed if it's not required by the API.\u003c/p\u003e\n"],["\u003cp\u003eThe task supports various HTTP methods (DELETE, GET, HEAD, PATCH, POST, PUT) and allows for the configuration of URL query string parameters and HTTP headers.\u003c/p\u003e\n"],["\u003cp\u003eThe task has a response limit of 50 MB, and you can manage error handling, with the ability to throw exceptions or return error codes and messages based on HTTP status codes.\u003c/p\u003e\n"]]],[],null,["# Call REST Endpoint task\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nCall REST Endpoint task\n=======================\n\nThe **Call REST Endpoint** task lets you call any third-party REST\nAPI from your integration. The response from the REST API call will be available to\nyou in an integration variable and can be used in other down-stream tasks.\n| **Note:**\n|\n| - The network configuration of the **Call REST Endpoint** task allows it to call endpoints only available over the public internet. Hence, the task can't connect to hosts or IPs that reside only within a private network such as a VPC, even if that VPC is peered with your other Google Cloud services such as Apigee X.\n| - This task can process a maximum of 50 MB of REST response.\n\nBefore you begin\n----------------\n\n- To connect to an authentication endpoint for the REST API call, ensure that you have either [created\n an OAuth 2.0 profile](/application-integration/docs/configuring-auth-profile#createAuthProfile) or [attached a user-managed service account](/application-integration/docs/access-control#add-service-account) to your integration. If your API does not require authentication, then the **Authentication profile** field in the task configuration pane can be left empty. To see a list of configurations, see [Configuration properties](#params).\n\n If your integration has both OAuth 2.0 profile and a user-managed service account configured, then by default the OAuth 2.0 profile is used for authentication. If neither OAuth 2.0 profile nor user-managed service account is configured, then the execution fails.\n- If your integration has a service account attached, then based on the REST endpoint URL, grant the required IAM role to that service account. For example, if your REST endpoint URL calls a Cloud Storage service, then grant the required IAM role for the Cloud Storage service. For information about granting roles to a service account, see [Manage access to service accounts](/iam/docs/manage-access-service-accounts).\n\n- Ensure that [VPC Service Controls](/application-integration/docs/vpc-service-controls) is **NOT** setup for Application Integration in your Google Cloud project. **Warning:** **Cloud Function** does not function or stops functioning if [VPC Service Controls](/application-integration/docs/vpc-service-controls) is setup for Application Integration in your Google Cloud project.\n\nConfigure the Call REST Endpoint task\n-------------------------------------\n\nTo configure the **Call REST Endpoint** 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 **Call REST Endpoint** element in the integration editor.\n6. Click the **Call REST Endpoint** element on the designer to view the **Call REST Endpoint** task configuration pane.\n7. Configure the displayed fields using the [configuration properties](#params) of the task as detailed in the table below.\n\n\n Changes to the properties are saved automatically.\n | **Note:** If you update the authentication profile for a **Call REST Endpoint** task, and test the integration without publishing the changes, the integration uses the old authentication profile. To ensure that the integration uses the updated authentication profile, you must [publish the integration](https://cloud.google.com/application-integration/docs/test-publish-integrations) before testing.\n\nConfiguration properties\n------------------------\n\n\nThe following table describes the configuration properties of the **Call REST Endpoint** task.\n\nBest practices\n--------------\n\nFor information about the usage limits that apply to the **Call REST Endpoint** task, see [Usage limits](/application-integration/docs/quotas#usage-limits).\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\nTo learn how to handle retry strategies for `4xx` or `5xx` errors, see the [How to retry Rest Caller Task based on Response Status](https://www.googlecloudcommunity.com/gc/Integration-Services/How-to-retry-Rest-Caller-Task-based-on-Response-Status/m-p/618079) blog.\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- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
