An idiomatic C++ client library for theCloud 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 isGA, please note Google Cloud C++ client libraries donotfollowSemantic Versioning.
Quickstart
The following shows the code that you'll run in thegoogle/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;
}
Main classes
This library offers multiple*Clientclasses, which are listed below. Each one of these classes exposes all the RPCs for a service as member functions of the class. This library groups multiple services because they are part of the same product or are often used together. A typical example may be the administrative and data plane operations for a single product.
The library also has other classes that provide helpers, configuration parameters, and infrastructure to mock the*Clientclasses when testing your application.
[[["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 Channel API C++ Client Library, which is used by Google Cloud partners to manage a unified resale platform.\u003c/p\u003e\n"],["\u003cp\u003eThe latest release candidate version is 2.37.0-rc, and a range of previous versions are also listed, including the currently displayed version 2.27.0.\u003c/p\u003e\n"],["\u003cp\u003eThe library includes client classes such as \u003ccode\u003echannel_v1::CloudChannelServiceClient\u003c/code\u003e and \u003ccode\u003echannel_v1::CloudChannelReportsServiceClient\u003c/code\u003e, which offer RPCs as member functions for each service.\u003c/p\u003e\n"],["\u003cp\u003eThe library is generally available (GA), but does not follow Semantic Versioning, and you can find information on how to override error handling, endpoints, authentication, and retry policies in the documentation.\u003c/p\u003e\n"],["\u003cp\u003eA quickstart guide is included, showing sample code to interact with the Cloud Channel API, specifically demonstrating the retrieval of product lists using \u003ccode\u003eListProducts\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["Version 2.27.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\nThis library offers multiple `*Client` classes, which are listed below. Each one of these classes exposes all the RPCs for a service as member functions of the class. This library groups multiple services because they are part of the same product or are often used together. A typical example may be the administrative and data plane operations for a single product.\n\nThe library also has other classes that provide helpers, configuration parameters, and infrastructure to mock the `*Client` classes when testing your application.\n\n- [`channel_v1::CloudChannelServiceClient`](/cpp/docs/reference/channel/2.27.0/classgoogle_1_1cloud_1_1channel__v1_1_1CloudChannelServiceClient)\n- [`channel_v1::CloudChannelReportsServiceClient`](/cpp/docs/reference/channel/2.27.0/classgoogle_1_1cloud_1_1channel__v1_1_1CloudChannelReportsServiceClient)\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.27.0/channel-override-endpoint) - describes how to override the default endpoint.\n- [How to Override the Authentication Credentials](/cpp/docs/reference/channel/2.27.0/channel-override-authentication) - describes how to change the authentication credentials used by the library.\n- [Override Retry, Backoff, and Idempotency Policies](/cpp/docs/reference/channel/2.27.0/channel-override-retry) - describes how to change the default retry policies.\n- [Environment Variables](/cpp/docs/reference/channel/2.27.0/channel-env) - describes environment variables that can configure the behavior of the library."]]