API Core: Add client_options documentation. (#8834)

1 files changed, 21 insertions, 0 deletions

diff --git a/google/api_core/client_options.py b/google/api_core/client_options.py
index 580aba9..1144d2f 100644
--- a/google/api_core/client_options.py
+++ b/google/api_core/client_options.py
@@ -16,6 +16,27 @@
 
 Client options provide a consistent interface for user options to be defined
 across clients.
+
+You can pass a client options object to a client.
+
+.. code-block:: python
+
+    from google.api_core.client_options import ClientOptions
+    from google.cloud.vision_v1 import ImageAnnotatorClient
+
+    options = ClientOptions(api_endpoint="foo.googleapis.com")
+
+    client = ImageAnnotatorClient(client_options=options)
+
+You can also pass a dictionary.
+
+.. code-block:: python
+
+    from google.cloud.vision_v1 import ImageAnnotatorClient
+
+    client = ImageAnnotatorClient(client_options={"api_endpoint": "foo.googleapis.com"})
+
+
 """