An idiomatic C++ client library forCloud Scheduler, a service that creates and manages jobs run on a regular recurring schedule.
While this library isGA, please note Google Cloud C++ client libraries donotfollowSemantic Versioning.
Quickstart
The following shows the code that you'll run in thegoogle/cloud/scheduler/quickstart/directory, which should give you a taste of the Cloud Scheduler API C++ client library API.
The main class in this library isscheduler_v1::CloudSchedulerClient. All RPCs are exposed as member functions of this class. Other classes provide helpers, configuration parameters, and infrastructure to mockscheduler_v1::CloudSchedulerClientwhen testing your application.
More Information
Error Handling- describes how the library reports errors.
[[["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 webpage provides documentation for the Cloud Scheduler API C++ Client Library, which is a tool for creating and managing jobs on a recurring schedule within Google Cloud.\u003c/p\u003e\n"],["\u003cp\u003eThe latest release candidate version is 2.37.0-rc, and the page lists various stable versions, with version 2.16.0 serving as the base reference for this documentation.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003escheduler_v1::CloudSchedulerClient\u003c/code\u003e class is the primary component of the library, through which all Remote Procedure Calls (RPCs) can be made, in addition to other classes for utility and testing.\u003c/p\u003e\n"],["\u003cp\u003eThe library does not adhere to Semantic Versioning, but is considered to be in General Availability (GA) and provides methods to manage error handling, custom endpoints, authentication credentials, retries and environment variables.\u003c/p\u003e\n"],["\u003cp\u003eA quickstart code example is provided, to illustrate the core usage of the Cloud Scheduler API C++ client library.\u003c/p\u003e\n"]]],[],null,["Version 2.16.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/scheduler/latest)\n- [2.41.0](/cpp/docs/reference/scheduler/2.41.0)\n- [2.40.0](/cpp/docs/reference/scheduler/2.40.0)\n- [2.39.0](/cpp/docs/reference/scheduler/2.39.0)\n- [2.38.0](/cpp/docs/reference/scheduler/2.38.0)\n- [2.37.0](/cpp/docs/reference/scheduler/2.37.0)\n- [2.36.0](/cpp/docs/reference/scheduler/2.36.0)\n- [2.35.0](/cpp/docs/reference/scheduler/2.35.0)\n- [2.34.0](/cpp/docs/reference/scheduler/2.34.0)\n- [2.33.0](/cpp/docs/reference/scheduler/2.33.0)\n- [2.32.0](/cpp/docs/reference/scheduler/2.32.0)\n- [2.31.0](/cpp/docs/reference/scheduler/2.31.0)\n- [2.30.0](/cpp/docs/reference/scheduler/2.30.0)\n- [2.29.0](/cpp/docs/reference/scheduler/2.29.0)\n- [2.28.0](/cpp/docs/reference/scheduler/2.28.0)\n- [2.27.0](/cpp/docs/reference/scheduler/2.27.0)\n- [2.26.0](/cpp/docs/reference/scheduler/2.26.0)\n- [2.25.1](/cpp/docs/reference/scheduler/2.25.1)\n- [2.24.0](/cpp/docs/reference/scheduler/2.24.0)\n- [2.23.0](/cpp/docs/reference/scheduler/2.23.0)\n- [2.22.1](/cpp/docs/reference/scheduler/2.22.1)\n- [2.21.0](/cpp/docs/reference/scheduler/2.21.0)\n- [2.20.0](/cpp/docs/reference/scheduler/2.20.0)\n- [2.19.0](/cpp/docs/reference/scheduler/2.19.0)\n- [2.18.0](/cpp/docs/reference/scheduler/2.18.0)\n- [2.17.0](/cpp/docs/reference/scheduler/2.17.0)\n- [2.16.0](/cpp/docs/reference/scheduler/2.16.0)\n- [2.15.1](/cpp/docs/reference/scheduler/2.15.1)\n- [2.14.0](/cpp/docs/reference/scheduler/2.14.0)\n- [2.13.0](/cpp/docs/reference/scheduler/2.13.0)\n- [2.12.0](/cpp/docs/reference/scheduler/2.12.0)\n- [2.11.0](/cpp/docs/reference/scheduler/2.11.0) \n\nCloud Scheduler API C++ Client Library\n======================================\n\nAn idiomatic C++ client library for [Cloud Scheduler](https://cloud.google.com/scheduler/), a service that creates and manages jobs run on a regular recurring schedule.\n\nWhile this library is **GA** , please note Google Cloud C++ client libraries do **not** follow [Semantic Versioning](https://semver.org/).\n\n### Quickstart\n\nThe following shows the code that you'll run in the `google/cloud/scheduler/quickstart/` directory, which should give you a taste of the Cloud Scheduler API C++ client library API. \n\n #include \"google/cloud/scheduler/v1/cloud_scheduler_client.h\"\n #include \u003ciostream\u003e\n\n int main(int argc, char* argv[]) try {\n if (argc != 3) {\n std::cerr \u003c\u003c \"Usage: \" \u003c\u003c argv[0] \u003c\u003c \" project-id location-id\\n\";\n return 1;\n }\n\n namespace scheduler = ::google::cloud::scheduler_v1;\n auto client = scheduler::CloudSchedulerClient(\n scheduler::MakeCloudSchedulerConnection());\n auto const parent =\n std::string{\"projects/\"} + argv[1] + \"/locations/\" + argv[2];\n for (auto j : client.ListJobs(parent)) {\n if (!j) throw std::move(j).status();\n std::cout \u003c\u003c j-\u003eDebugString() \u003c\u003c \"\\n\";\n }\n\n return 0;\n } catch (google::cloud::Status const& status) {\n std::cerr \u003c\u003c \"google::cloud::Status thrown: \" \u003c\u003c status \u003c\u003c \"\\n\";\n return 1;\n }\n\n### Main classes\n\nThe main class in this library is [`scheduler_v1::CloudSchedulerClient`](/cpp/docs/reference/scheduler/2.16.0/classgoogle_1_1cloud_1_1scheduler__v1_1_1CloudSchedulerClient). All RPCs are exposed as member functions of this class. Other classes provide helpers, configuration parameters, and infrastructure to mock [`scheduler_v1::CloudSchedulerClient`](/cpp/docs/reference/scheduler/2.16.0/classgoogle_1_1cloud_1_1scheduler__v1_1_1CloudSchedulerClient) when testing your application.\n\n### More Information\n\n- [Error Handling](https://cloud.google.com/cpp/docs/reference/common/latest/common-error-handling.html) - describes how the library reports errors.\n- [How to Override the Default Endpoint](/cpp/docs/reference/scheduler/2.16.0/scheduler-override-endpoint) - describes how to override the default endpoint.\n- [How to Override the Authentication Credentials](/cpp/docs/reference/scheduler/2.16.0/scheduler-override-authentication) - describes how to change the authentication credentials used by the library.\n- [Override Retry, Backoff, and Idempotency Policies](/cpp/docs/reference/scheduler/2.16.0/scheduler-override-retry) - describes how to change the default retry policies.\n- [Environment Variables](/cpp/docs/reference/scheduler/2.16.0/scheduler-env) - describes environment variables that can configure the behavior of the library."]]