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 current stable version in focus is 2.36.0, alongside numerous older versions available for reference.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003escheduler_v1::CloudSchedulerClient\u003c/code\u003e class is the primary component of this library, offering all the RPCs (Remote Procedure Calls) as member functions.\u003c/p\u003e\n"],["\u003cp\u003eAlthough this library is in General Availability (GA), it does not adhere to Semantic Versioning, and the documentation provides details on error handling, overriding endpoints and authentication credentials, as well as configuring retry policies and environment variables.\u003c/p\u003e\n"],["\u003cp\u003eA quickstart code example demonstrates how to utilize the library to list jobs within a specified project and location, providing a practical introduction to the Cloud Scheduler API.\u003c/p\u003e\n"]]],[],null,["Version 2.36.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 \"google/cloud/location.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 auto const location = google::cloud::Location(argv[1], argv[2]);\n\n namespace scheduler = ::google::cloud::scheduler_v1;\n auto client = scheduler::CloudSchedulerClient(\n scheduler::MakeCloudSchedulerConnection());\n\n for (auto j : client.ListJobs(location.FullName())) {\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.36.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.36.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.36.0/scheduler-override-endpoint) - describes how to override the default endpoint.\n- [How to Override the Authentication Credentials](/cpp/docs/reference/scheduler/2.36.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.36.0/scheduler-override-retry) - describes how to change the default retry policies.\n- [Environment Variables](/cpp/docs/reference/scheduler/2.36.0/scheduler-env) - describes environment variables that can configure the behavior of the library."]]