Cloud Tasks API Connector Overview Stay organized with collections Save and categorize content based on your preferences.
The Workflows connector defines the built-infunctions that can be used to access other Google Cloud products within aworkflow.
This page provides an overview of the individual connector.There is no need to import or load connector libraries in a workflow—connectorswork out of the box when used in a call step.
Creates a queue. Queues created with this method allow tasks to live fora maximum of 31 days. After a task is 31 days old, the task will bedeleted regardless of whether it was dispatched or not. WARNING: Usingthis method may have unintended side effects if you are using an AppEnginequeue.yaml orqueue.xml file to manage your queues. ReadOverview of Queue Management andqueue.yaml before usingthis method.
Deletes a queue. This command will delete the queue even if it has tasksin it. Note: If you delete a queue, a queue with the same name can't becreated for 7 days. WARNING: Using this method may have unintended sideeffects if you are using an App Enginequeue.yaml orqueue.xml fileto manage your queues. ReadOverview of Queue Management andqueue.yaml before usingthis method.
Gets the access control policy for a Queue. Returns an empty policy ifthe resource exists and does not have a policy set. Authorizationrequires the followingGoogle IAMpermission on the specified resource parent: *cloudtasks.queues.getIamPolicy
Updates a queue. This method creates the queue if it does not exist andupdates the queue if it does exist. Queues created with this methodallow tasks to live for a maximum of 31 days. After a task is 31 daysold, the task will be deleted regardless of whether it was dispatched ornot. WARNING: Using this method may have unintended side effects if youare using an App Enginequeue.yaml orqueue.xml file to manage yourqueues. ReadOverview of Queue Management andqueue.yaml before usingthis method.
Pauses the queue. If a queue is paused then the system will stopdispatching tasks until the queue is resumed via ResumeQueue. Tasks canstill be added when the queue is paused. A queue is paused if its stateis PAUSED.
Purges a queue by deleting all of its tasks. All tasks created beforethis method is called are permanently deleted. Purge operations can takeup to one minute to take effect. Tasks might be dispatched before thepurge takes effect. A purge is irreversible.
Resume a queue. This method resumes a queue after it has been PAUSED orDISABLED. The state of a queue is stored in the queue's state; aftercalling this method it will be set to RUNNING. WARNING: Resuming manyhigh-QPS queues at the same time can lead to target overloading. If youare resuming high-QPS queues, follow the 500/50/5 pattern described inManaging Cloud Tasks ScalingRisks.
Sets the access control policy for a Queue. Replaces any existingpolicy. Note: The Cloud Console does not check queue-level IAMpermissions yet. Project-level permissions are required to use the CloudConsole. Authorization requires the followingGoogleIAM permission on the specified resourceparent: *cloudtasks.queues.setIamPolicy
Returns permissions that a caller has on a Queue. If the resource doesnot exist, this will return an empty set of permissions, not a NOT_FOUNDerror. Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.
Lists the tasks in a queue. By default, only the BASIC view is retrieveddue to performance considerations; response_view controls the subset ofinformation which is returned. The tasks may be returned in any order.The ordering may change at any time.
Forces a task to run now. When this method is called, Cloud Tasks willdispatch the task, even if the task is already running, the queue hasreached its RateLimits or is PAUSED. This command is meant to be usedfor manual debugging. For example, RunTask can be used to retry a failedtask after a fix has been made or to manually force a task to bedispatched now. The dispatched task is returned. That is, the task thatis returned contains the status after the task is dispatched but beforethe task is received by its target. If Cloud Tasks receives a successfulresponse from the task's target, then the task will be deleted;otherwise the task's schedule_time will be reset to the time thatRunTask was called plus the retry delay specified in the queue'sRetryConfig. RunTask returns NOT_FOUND when it is called on a task thathas already succeeded or permanently failed.
Creates a queue. Queues created with this method allow tasks to live fora maximum of 31 days. After a task is 31 days old, the task will bedeleted regardless of whether it was dispatched or not. WARNING: Usingthis method may have unintended side effects if you are using an AppEnginequeue.yaml orqueue.xml file to manage your queues. ReadOverview of Queue Management andqueue.yaml before usingthis method.
Deletes a queue. This command will delete the queue even if it has tasksin it. Note: If you delete a queue, a queue with the same name can't becreated for 7 days. WARNING: Using this method may have unintended sideeffects if you are using an App Enginequeue.yaml orqueue.xml fileto manage your queues. ReadOverview of Queue Management andqueue.yaml before usingthis method.
Gets the access control policy for a Queue. Returns an empty policy ifthe resource exists and does not have a policy set. Authorizationrequires the followingGoogle IAMpermission on the specified resource parent: *cloudtasks.queues.getIamPolicy
Updates a queue. This method creates the queue if it does not exist andupdates the queue if it does exist. Queues created with this methodallow tasks to live for a maximum of 31 days. After a task is 31 daysold, the task will be deleted regardless of whether it was dispatched ornot. WARNING: Using this method may have unintended side effects if youare using an App Enginequeue.yaml orqueue.xml file to manage yourqueues. ReadOverview of Queue Management andqueue.yaml before usingthis method.
Pauses the queue. If a queue is paused then the system will stopdispatching tasks until the queue is resumed via ResumeQueue. Tasks canstill be added when the queue is paused. A queue is paused if its stateis PAUSED.
Purges a queue by deleting all of its tasks. All tasks created beforethis method is called are permanently deleted. Purge operations can takeup to one minute to take effect. Tasks might be dispatched before thepurge takes effect. A purge is irreversible.
Resume a queue. This method resumes a queue after it has been PAUSED orDISABLED. The state of a queue is stored in the queue's state; aftercalling this method it will be set to RUNNING. WARNING: Resuming manyhigh-QPS queues at the same time can lead to target overloading. If youare resuming high-QPS queues, follow the 500/50/5 pattern described inManaging Cloud Tasks ScalingRisks.
Sets the access control policy for a Queue. Replaces any existingpolicy. Note: The Cloud Console does not check queue-level IAMpermissions yet. Project-level permissions are required to use the CloudConsole. Authorization requires the followingGoogleIAM permission on the specified resourceparent: *cloudtasks.queues.setIamPolicy
Returns permissions that a caller has on a Queue. If the resource doesnot exist, this will return an empty set of permissions, not a NOT_FOUNDerror. Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.
Lists the tasks in a queue. By default, only the BASIC view is retrieveddue to performance considerations; response_view controls the subset ofinformation which is returned. The tasks may be returned in any order.The ordering may change at any time.
Forces a task to run now. When this method is called, Cloud Tasks willdispatch the task, even if the task is already running, the queue hasreached its RateLimits or is PAUSED. This command is meant to be usedfor manual debugging. For example, RunTask can be used to retry a failedtask after a fix has been made or to manually force a task to bedispatched now. The dispatched task is returned. That is, the task thatis returned contains the status after the task is dispatched but beforethe task is received by its target. If Cloud Tasks receives a successfulresponse from the task's target, then the task will be deleted;otherwise the task's schedule_time will be reset to the time thatRunTask was called plus the retry delay specified in the queue'sRetryConfig. RunTask returns NOT_FOUND when it is called on a task thathas already succeeded or permanently failed.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-02-19 UTC."],[],[]]
