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\u003eThis page provides documentation for overriding the default endpoint used by the client library, specifically for the Google Cloud Retail API C++ client.\u003c/p\u003e\n"],["\u003cp\u003eVersion 2.37.0-rc is the latest release, but documentation is available for a range of versions, starting from 2.11.0 up to the current latest.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eEndpointOption\u003c/code\u003e within \u003ccode\u003egoogle::cloud::Options\u003c/code\u003e allows for overriding the default endpoint, and it shows how it can be useful with Private Google Access.\u003c/p\u003e\n"],["\u003cp\u003eExamples for overriding the endpoint are given for various \u003ccode\u003e*Client\u003c/code\u003e classes, including \u003ccode\u003eCatalogServiceClient\u003c/code\u003e, \u003ccode\u003eCompletionServiceClient\u003c/code\u003e, and \u003ccode\u003eUserEventServiceClient\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can access the documentation for any version by going to the respective link, where each version is organized per client class, and a snippet example is available.\u003c/p\u003e\n"]]],[],null,["Version 2.23.0keyboard_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.23.0/retail_v2_1_1CatalogServiceClient-endpoint-snippet)\n- [`retail_v2::CompletionServiceClient`](/cpp/docs/reference/retail/2.23.0/retail_v2_1_1CompletionServiceClient-endpoint-snippet)\n- [`retail_v2::ControlServiceClient`](/cpp/docs/reference/retail/2.23.0/retail_v2_1_1ControlServiceClient-endpoint-snippet)\n- [`retail_v2::ModelServiceClient`](/cpp/docs/reference/retail/2.23.0/retail_v2_1_1ModelServiceClient-endpoint-snippet)\n- [`retail_v2::PredictionServiceClient`](/cpp/docs/reference/retail/2.23.0/retail_v2_1_1PredictionServiceClient-endpoint-snippet)\n- [`retail_v2::ProductServiceClient`](/cpp/docs/reference/retail/2.23.0/retail_v2_1_1ProductServiceClient-endpoint-snippet)\n- [`retail_v2::SearchServiceClient`](/cpp/docs/reference/retail/2.23.0/retail_v2_1_1SearchServiceClient-endpoint-snippet)\n- [`retail_v2::ServingConfigServiceClient`](/cpp/docs/reference/retail/2.23.0/retail_v2_1_1ServingConfigServiceClient-endpoint-snippet)\n- [`retail_v2::UserEventServiceClient`](/cpp/docs/reference/retail/2.23.0/retail_v2_1_1UserEventServiceClient-endpoint-snippet)"]]