The returned connection object should not be used directly; instead it should be passed as an argument to the constructor ofCloudTasksClient.
The optionaloptionsargument may be used to configure aspects of the returnedCloudTasksConnection. Expected options are any of the types in the following option lists:
[[["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 2025-09-04 UTC."],[[["\u003cp\u003eThis page provides documentation for the Google Cloud Tasks C++ client library, with the current version being 2.15.1.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation includes links to various versions of the library, ranging from 2.11.0 to the latest release candidate 2.37.0-rc, allowing developers to navigate to the version they are using.\u003c/p\u003e\n"],["\u003cp\u003eIt outlines key classes such as \u003ccode\u003eCloudTasksClient\u003c/code\u003e, \u003ccode\u003eCloudTasksConnection\u003c/code\u003e, and related retry and policy classes, which are essential for managing background work execution in applications.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation also details how to create a \u003ccode\u003eCloudTasksConnection\u003c/code\u003e object, including the various options that can be used to configure it.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eCloudTasksPolicyOptionList\u003c/code\u003e type alias represents the collection of options applicable to Cloud Tasks, including \u003ccode\u003eCloudTasksRetryPolicyOption\u003c/code\u003e, \u003ccode\u003eCloudTasksBackoffPolicyOption\u003c/code\u003e, and \u003ccode\u003eCloudTasksConnectionIdempotencyPolicyOption\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Namespace google::cloud::tasks_v2 (2.15.1)\n\nVersion 2.15.1keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/tasks/latest/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.41.0](/cpp/docs/reference/tasks/2.41.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.40.0](/cpp/docs/reference/tasks/2.40.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.39.0](/cpp/docs/reference/tasks/2.39.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.38.0](/cpp/docs/reference/tasks/2.38.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.37.0](/cpp/docs/reference/tasks/2.37.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.36.0](/cpp/docs/reference/tasks/2.36.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.35.0](/cpp/docs/reference/tasks/2.35.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.34.0](/cpp/docs/reference/tasks/2.34.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.33.0](/cpp/docs/reference/tasks/2.33.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.32.0](/cpp/docs/reference/tasks/2.32.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.31.0](/cpp/docs/reference/tasks/2.31.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.30.0](/cpp/docs/reference/tasks/2.30.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.29.0](/cpp/docs/reference/tasks/2.29.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.28.0](/cpp/docs/reference/tasks/2.28.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.27.0](/cpp/docs/reference/tasks/2.27.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.26.0](/cpp/docs/reference/tasks/2.26.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.25.1](/cpp/docs/reference/tasks/2.25.1/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.24.0](/cpp/docs/reference/tasks/2.24.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.23.0](/cpp/docs/reference/tasks/2.23.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.22.1](/cpp/docs/reference/tasks/2.22.1/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.21.0](/cpp/docs/reference/tasks/2.21.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.20.0](/cpp/docs/reference/tasks/2.20.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.19.0](/cpp/docs/reference/tasks/2.19.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.18.0](/cpp/docs/reference/tasks/2.18.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.17.0](/cpp/docs/reference/tasks/2.17.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.16.0](/cpp/docs/reference/tasks/2.16.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.15.1](/cpp/docs/reference/tasks/2.15.1/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.14.0](/cpp/docs/reference/tasks/2.14.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.13.0](/cpp/docs/reference/tasks/2.13.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.12.0](/cpp/docs/reference/tasks/2.12.0/namespacegoogle_1_1cloud_1_1tasks__v2)\n- [2.11.0](/cpp/docs/reference/tasks/2.11.0/namespacegoogle_1_1cloud_1_1tasks__v2) \n\nClasses\n-------\n\n### [CloudTasksClient](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksClient)\n\nCloud Tasks allows developers to manage the execution of background work in their applications.\n\n### [CloudTasksConnection](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksConnection)\n\nThe [`CloudTasksConnection`](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksConnection) object for [`CloudTasksClient`](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksClient).\n\n### [CloudTasksConnectionIdempotencyPolicy](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksConnectionIdempotencyPolicy)\n\n### [CloudTasksLimitedErrorCountRetryPolicy](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksLimitedErrorCountRetryPolicy)\n\nA retry policy for [`CloudTasksConnection`](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksConnection) based on counting errors.\n\n### [CloudTasksLimitedTimeRetryPolicy](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksLimitedTimeRetryPolicy)\n\nA retry policy for [`CloudTasksConnection`](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksConnection) based on elapsed time.\n\n### [CloudTasksRetryPolicy](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksRetryPolicy)\n\nThe retry policy for [`CloudTasksConnection`](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksConnection).\n\nStructs\n-------\n\n### [CloudTasksBackoffPolicyOption](/cpp/docs/reference/tasks/2.15.1/structgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksBackoffPolicyOption)\n\nUse with [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) to configure the backoff policy.\n\n### [CloudTasksConnectionIdempotencyPolicyOption](/cpp/docs/reference/tasks/2.15.1/structgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksConnectionIdempotencyPolicyOption)\n\nUse with [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) to configure which operations are retried.\n\n### [CloudTasksRetryPolicyOption](/cpp/docs/reference/tasks/2.15.1/structgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksRetryPolicyOption)\n\nUse with [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) to configure the retry policy.\n\nFunctions\n---------\n\n### MakeCloudTasksConnection(Options)\n\nA factory function to construct an object of type [`CloudTasksConnection`](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksConnection). \nThe returned connection object should not be used directly; instead it should be passed as an argument to the constructor of [CloudTasksClient](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksClient).\n\nThe optional `options` argument may be used to configure aspects of the returned [`CloudTasksConnection`](/cpp/docs/reference/tasks/2.15.1/classgoogle_1_1cloud_1_1tasks__v2_1_1CloudTasksConnection). Expected options are any of the types in the following option lists:\n\n- [`google::cloud::CommonOptionList`](https://cloud.google.com/cpp/docs/reference/common/latest/namespacegoogle_1_1cloud.html)\n- [`google::cloud::GrpcOptionList`](https://cloud.google.com/cpp/docs/reference/common/latest/namespacegoogle_1_1cloud.html)\n- [`google::cloud::UnifiedCredentialsOptionList`](https://cloud.google.com/cpp/docs/reference/common/latest/namespacegoogle_1_1cloud.html)\n- [`google::cloud::tasks_v2::CloudTasksPolicyOptionList`](/cpp/docs/reference/tasks/2.15.1/namespacegoogle_1_1cloud_1_1tasks__v2)\n\n| **Note:** Unexpected options will be ignored. To log unexpected options instead, set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment.\n\n### MakeDefaultCloudTasksConnectionIdempotencyPolicy()\n\nType Aliases\n------------\n\n### CloudTasksPolicyOptionList\n\n**Alias Of** : `OptionList\u003c CloudTasksRetryPolicyOption, CloudTasksBackoffPolicyOption, CloudTasksConnectionIdempotencyPolicyOption \u003e` \nThe options applicable to CloudTasks."]]
