An idiomatic C++ client library for the Cloud Channel API, a service that enables Google Cloud partners to have a single unified resale platform and APIs across all of Google Cloud including GCP, Workspace, Maps and Chrome.
While this library is GA, please note Google Cloud C++ client libraries do not follow Semantic Versioning.
Quickstart
The following shows the code that you'll run in the google/cloud/channel/quickstart/ directory, which should give you a taste of the Cloud Channel API C++ client library API.
#include "google/cloud/channel/v1/cloud_channel_client.h"
#include <iostream>
#include <string>
int main(int argc, char* argv[]) try {
if (argc != 2) {
std::cerr << "Usage: " << argv[0] << " account-id\n";
return 1;
}
namespace channel = ::google::cloud::channel_v1;
auto client = channel::CloudChannelServiceClient(
channel::MakeCloudChannelServiceConnection());
// Fill in this request as needed.
auto request = google::cloud::channel::v1::ListProductsRequest{};
request.set_account(std::string("accounts/") + argv[1]);
for (auto r : client.ListProducts(std::move(request))) {
if (!r) throw std::move(r).status();
std::cout << r->DebugString() << "\n";
}
return 0;
} catch (google::cloud::Status const& status) {
std::cerr << "google::cloud::Status thrown: " << status << "\n";
return 1;
}
The library automatically retries requests that fail with transient errors, and uses exponential backoff to backoff between retries. Application developers can override the default policies.
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"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["\u003cp\u003eThe Cloud Channel API C++ Client Library provides a unified platform for Google Cloud partners to manage resale across GCP, Workspace, Maps, and Chrome.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version of the Cloud Channel API C++ Client Library is 2.37.0-rc, and the documentation page also includes historical versions ranging back to version 2.11.0.\u003c/p\u003e\n"],["\u003cp\u003eThis library automatically retries requests with transient errors and uses exponential backoff, but the default retry policies can be overridden by developers.\u003c/p\u003e\n"],["\u003cp\u003eThe primary class in this library is \u003ccode\u003echannel_v1::CloudChannelServiceClient\u003c/code\u003e, which exposes all RPCs as its member functions.\u003c/p\u003e\n"],["\u003cp\u003eThe library documentation details error handling, how to override endpoints and authentication, and configurable environment variables.\u003c/p\u003e\n"]]],[],null,["Version 2.11.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/channel/latest)\n- [2.41.0](/cpp/docs/reference/channel/2.41.0)\n- [2.40.0](/cpp/docs/reference/channel/2.40.0)\n- [2.39.0](/cpp/docs/reference/channel/2.39.0)\n- [2.38.0](/cpp/docs/reference/channel/2.38.0)\n- [2.37.0](/cpp/docs/reference/channel/2.37.0)\n- [2.36.0](/cpp/docs/reference/channel/2.36.0)\n- [2.35.0](/cpp/docs/reference/channel/2.35.0)\n- [2.34.0](/cpp/docs/reference/channel/2.34.0)\n- [2.33.0](/cpp/docs/reference/channel/2.33.0)\n- [2.32.0](/cpp/docs/reference/channel/2.32.0)\n- [2.31.0](/cpp/docs/reference/channel/2.31.0)\n- [2.30.0](/cpp/docs/reference/channel/2.30.0)\n- [2.29.0](/cpp/docs/reference/channel/2.29.0)\n- [2.28.0](/cpp/docs/reference/channel/2.28.0)\n- [2.27.0](/cpp/docs/reference/channel/2.27.0)\n- [2.26.0](/cpp/docs/reference/channel/2.26.0)\n- [2.25.1](/cpp/docs/reference/channel/2.25.1)\n- [2.24.0](/cpp/docs/reference/channel/2.24.0)\n- [2.23.0](/cpp/docs/reference/channel/2.23.0)\n- [2.22.1](/cpp/docs/reference/channel/2.22.1)\n- [2.21.0](/cpp/docs/reference/channel/2.21.0)\n- [2.20.0](/cpp/docs/reference/channel/2.20.0)\n- [2.19.0](/cpp/docs/reference/channel/2.19.0)\n- [2.18.0](/cpp/docs/reference/channel/2.18.0)\n- [2.17.0](/cpp/docs/reference/channel/2.17.0)\n- [2.16.0](/cpp/docs/reference/channel/2.16.0)\n- [2.15.1](/cpp/docs/reference/channel/2.15.1)\n- [2.14.0](/cpp/docs/reference/channel/2.14.0)\n- [2.13.0](/cpp/docs/reference/channel/2.13.0)\n- [2.12.0](/cpp/docs/reference/channel/2.12.0)\n- [2.11.0](/cpp/docs/reference/channel/2.11.0) \n\nCloud Channel API C++ Client Library\n====================================\n\nAn idiomatic C++ client library for the [Cloud Channel API](https://cloud.google.com/channel), a service that enables Google Cloud partners to have a single unified resale platform and APIs across all of Google Cloud including GCP, Workspace, Maps and Chrome.\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/channel/quickstart/` directory, which should give you a taste of the Cloud Channel API C++ client library API. \n\n #include \"google/cloud/channel/v1/cloud_channel_client.h\"\n #include \u003ciostream\u003e\n #include \u003cstring\u003e\n\n int main(int argc, char* argv[]) try {\n if (argc != 2) {\n std::cerr \u003c\u003c \"Usage: \" \u003c\u003c argv[0] \u003c\u003c \" account-id\\n\";\n return 1;\n }\n\n namespace channel = ::google::cloud::channel_v1;\n auto client = channel::CloudChannelServiceClient(\n channel::MakeCloudChannelServiceConnection());\n\n // Fill in this request as needed.\n auto request = google::cloud::channel::v1::ListProductsRequest{};\n request.set_account(std::string(\"accounts/\") + argv[1]);\n for (auto r : client.ListProducts(std::move(request))) {\n if (!r) throw std::move(r).status();\n std::cout \u003c\u003c r-\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 [`channel_v1::CloudChannelServiceClient`](/cpp/docs/reference/channel/2.11.0/classgoogle_1_1cloud_1_1channel__v1_1_1CloudChannelServiceClient). All RPCs are exposed as member functions of this class. Other classes provide helpers, configuration parameters, and infrastructure to mock [`channel_v1::CloudChannelServiceClient`](/cpp/docs/reference/channel/2.11.0/classgoogle_1_1cloud_1_1channel__v1_1_1CloudChannelServiceClient) when testing your application.\n\n### Retry, Backoff, and Idempotency Policies.\n\nThe library automatically retries requests that fail with transient errors, and uses [exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff) to backoff between retries. Application developers can override the default policies.\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/channel/2.11.0/channel-override-endpoint) - describes how to override the default endpoint.\n- [How to Override the Authentication Credentials](/cpp/docs/reference/channel/2.11.0/channel-override-authentication) - describes how to change the authentication credentials used by the library.\n- [Environment Variables](/cpp/docs/reference/channel/2.11.0/channel-env) - describes environment variables that can configure the behavior of the library."]]