In some cases, you may need to override the default endpoint used by the client library. Use theEndpointOptionwhen initializing the client library to change this default.
For example, this will override the default endpoint forretail_v2::CatalogServiceClient:
// This configuration is common with Private Google Access:
// https://cloud.google.com/vpc/docs/private-google-access
auto options = google::cloud::Options{}.set<google::cloud::EndpointOption>(
"private.googleapis.com");
auto client = google::cloud::retail_v2::CatalogServiceClient(
google::cloud::retail_v2::MakeCatalogServiceConnection(options));
Follow these links to find examples for other*Clientclasses:
[[["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\u003eThe page documents the ability to override the default endpoint used by the client library, using \u003ccode\u003eEndpointOption\u003c/code\u003e when initializing the client.\u003c/p\u003e\n"],["\u003cp\u003eThe latest release candidate version for the retail documentation is 2.37.0-rc, and the current version is 2.22.1.\u003c/p\u003e\n"],["\u003cp\u003eThe document lists all available versions, ranging from 2.11.0 to 2.37.0-rc, of the Retail C++ client library API reference.\u003c/p\u003e\n"],["\u003cp\u003eExamples for overriding the endpoint are provided for various \u003ccode\u003e*Client\u003c/code\u003e classes, including \u003ccode\u003eCatalogServiceClient\u003c/code\u003e, \u003ccode\u003eCompletionServiceClient\u003c/code\u003e, and others.\u003c/p\u003e\n"],["\u003cp\u003eOverriding the default endpoint is useful for scenarios such as configuring the client with Private Google Access, as mentioned in the documentation.\u003c/p\u003e\n"]]],[],null,["Version 2.22.1keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/retail/latest/retail-override-endpoint)\n- [2.41.0](/cpp/docs/reference/retail/2.41.0/retail-override-endpoint)\n- [2.40.0](/cpp/docs/reference/retail/2.40.0/retail-override-endpoint)\n- [2.39.0](/cpp/docs/reference/retail/2.39.0/retail-override-endpoint)\n- [2.38.0](/cpp/docs/reference/retail/2.38.0/retail-override-endpoint)\n- [2.37.0](/cpp/docs/reference/retail/2.37.0/retail-override-endpoint)\n- [2.36.0](/cpp/docs/reference/retail/2.36.0/retail-override-endpoint)\n- [2.35.0](/cpp/docs/reference/retail/2.35.0/retail-override-endpoint)\n- [2.34.0](/cpp/docs/reference/retail/2.34.0/retail-override-endpoint)\n- [2.33.0](/cpp/docs/reference/retail/2.33.0/retail-override-endpoint)\n- [2.32.0](/cpp/docs/reference/retail/2.32.0/retail-override-endpoint)\n- [2.31.0](/cpp/docs/reference/retail/2.31.0/retail-override-endpoint)\n- [2.30.0](/cpp/docs/reference/retail/2.30.0/retail-override-endpoint)\n- [2.29.0](/cpp/docs/reference/retail/2.29.0/retail-override-endpoint)\n- [2.28.0](/cpp/docs/reference/retail/2.28.0/retail-override-endpoint)\n- [2.27.0](/cpp/docs/reference/retail/2.27.0/retail-override-endpoint)\n- [2.26.0](/cpp/docs/reference/retail/2.26.0/retail-override-endpoint)\n- [2.25.1](/cpp/docs/reference/retail/2.25.1/retail-override-endpoint)\n- [2.24.0](/cpp/docs/reference/retail/2.24.0/retail-override-endpoint)\n- [2.23.0](/cpp/docs/reference/retail/2.23.0/retail-override-endpoint)\n- [2.22.1](/cpp/docs/reference/retail/2.22.1/retail-override-endpoint)\n- [2.21.0](/cpp/docs/reference/retail/2.21.0/retail-override-endpoint)\n- [2.20.0](/cpp/docs/reference/retail/2.20.0/retail-override-endpoint)\n- [2.19.0](/cpp/docs/reference/retail/2.19.0/retail-override-endpoint)\n- [2.18.0](/cpp/docs/reference/retail/2.18.0/retail-override-endpoint)\n- [2.17.0](/cpp/docs/reference/retail/2.17.0/retail-override-endpoint)\n- [2.16.0](/cpp/docs/reference/retail/2.16.0/retail-override-endpoint)\n- [2.15.1](/cpp/docs/reference/retail/2.15.1/retail-override-endpoint)\n- [2.14.0](/cpp/docs/reference/retail/2.14.0/retail-override-endpoint)\n- [2.13.0](/cpp/docs/reference/retail/2.13.0/retail-override-endpoint)\n- [2.12.0](/cpp/docs/reference/retail/2.12.0/retail-override-endpoint)\n- [2.11.0](/cpp/docs/reference/retail/2.11.0/retail-override-endpoint) \n\nHow to Override the Default Endpoint\n====================================\n\nIn some cases, you may need to override the default endpoint used by the client library. Use the [EndpointOption](https://cloud.google.com/cpp/docs/reference/common/latest/structgoogle_1_1cloud_1_1EndpointOption.html) when initializing the client library to change this default.\n\nFor example, this will override the default endpoint for `retail_v2::CatalogServiceClient`: \n\n // This configuration is common with Private Google Access:\n // https://cloud.google.com/vpc/docs/private-google-access\n auto options = google::cloud::Options{}.set\u003cgoogle::cloud::EndpointOption\u003e(\n \"private.googleapis.com\");\n auto client = google::cloud::retail_v2::CatalogServiceClient(\n google::cloud::retail_v2::MakeCatalogServiceConnection(options));\n\nFollow these links to find examples for other `*Client` classes:\n\n- [`retail_v2::CatalogServiceClient`](/cpp/docs/reference/retail/2.22.1/retail_v2_1_1CatalogServiceClient-endpoint-snippet)\n- [`retail_v2::CompletionServiceClient`](/cpp/docs/reference/retail/2.22.1/retail_v2_1_1CompletionServiceClient-endpoint-snippet)\n- [`retail_v2::ControlServiceClient`](/cpp/docs/reference/retail/2.22.1/retail_v2_1_1ControlServiceClient-endpoint-snippet)\n- [`retail_v2::ModelServiceClient`](/cpp/docs/reference/retail/2.22.1/retail_v2_1_1ModelServiceClient-endpoint-snippet)\n- [`retail_v2::PredictionServiceClient`](/cpp/docs/reference/retail/2.22.1/retail_v2_1_1PredictionServiceClient-endpoint-snippet)\n- [`retail_v2::ProductServiceClient`](/cpp/docs/reference/retail/2.22.1/retail_v2_1_1ProductServiceClient-endpoint-snippet)\n- [`retail_v2::SearchServiceClient`](/cpp/docs/reference/retail/2.22.1/retail_v2_1_1SearchServiceClient-endpoint-snippet)\n- [`retail_v2::ServingConfigServiceClient`](/cpp/docs/reference/retail/2.22.1/retail_v2_1_1ServingConfigServiceClient-endpoint-snippet)\n- [`retail_v2::UserEventServiceClient`](/cpp/docs/reference/retail/2.22.1/retail_v2_1_1UserEventServiceClient-endpoint-snippet)"]]