docs: Add documentation for enums (#208)

* docs: Add documentation for enums fix: Add context manager return types chore: Update gapic-generator-python to v1.8.1 PiperOrigin-RevId: 503210727 Source-Link: googleapis/googleapis@a391fd1 Source-Link: googleapis/googleapis-gen@0080f83 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMDA4MGY4MzBkZWMzN2MzMzg0MTU3MDgyYmNlMjc5ZTM3MDc5ZWE1OCJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
googleapis · Jan 20, 2023 · 51fbfc0 · 51fbfc0
1 parent 1647e94
commit 51fbfc0
Show file tree

Hide file tree

Showing 7 changed files with 35 additions and 6 deletions.
diff --git a/google/cloud/recommendationengine_v1beta1/services/catalog_service/client.py b/google/cloud/recommendationengine_v1beta1/services/catalog_service/client.py
@@ -1196,7 +1196,7 @@ def sample_import_catalog_items():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "CatalogServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/google/cloud/recommendationengine_v1beta1/services/prediction_api_key_registry/client.py b/google/cloud/recommendationengine_v1beta1/services/prediction_api_key_registry/client.py
@@ -837,7 +837,7 @@ def sample_delete_prediction_api_key_registration():
             metadata=metadata,
         )
 
-    def __enter__(self):
+    def __enter__(self) -> "PredictionApiKeyRegistryClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/google/cloud/recommendationengine_v1beta1/services/prediction_service/client.py b/google/cloud/recommendationengine_v1beta1/services/prediction_service/client.py
@@ -619,7 +619,7 @@ def sample_predict():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "PredictionServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/google/cloud/recommendationengine_v1beta1/services/user_event_service/client.py b/google/cloud/recommendationengine_v1beta1/services/user_event_service/client.py
@@ -1249,7 +1249,7 @@ def sample_import_user_events():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "UserEventServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/google/cloud/recommendationengine_v1beta1/types/catalog.py b/google/cloud/recommendationengine_v1beta1/types/catalog.py
@@ -212,6 +212,20 @@ class ProductCatalogItem(proto.Message):
     class StockState(proto.Enum):
         r"""Item stock state. If this field is unspecified, the item is
         assumed to be in stock.
+
+        Values:
+            STOCK_STATE_UNSPECIFIED (0):
+                Default item stock status. Should never be
+                used.
+            IN_STOCK (0):
+                Item in stock.
+            OUT_OF_STOCK (1):
+                Item out of stock.
+            PREORDER (2):
+                Item that is in pre-order state.
+            BACKORDER (3):
+                Item that is back-ordered (i.e. temporarily
+                out of stock).
         """
         _pb_options = {"allow_alias": True}
         STOCK_STATE_UNSPECIFIED = 0

diff --git a/google/cloud/recommendationengine_v1beta1/types/user_event.py b/google/cloud/recommendationengine_v1beta1/types/user_event.py
@@ -103,7 +103,22 @@ class UserEvent(proto.Message):
     """
 
     class EventSource(proto.Enum):
-        r"""User event source."""
+        r"""User event source.
+
+        Values:
+            EVENT_SOURCE_UNSPECIFIED (0):
+                Unspecified event source.
+            AUTOML (1):
+                The event is ingested via a javascript pixel
+                or Recommendations AI Tag through automl
+                datalayer or JS Macros.
+            ECOMMERCE (2):
+                The event is ingested via Recommendations AI
+                Tag through Enhanced Ecommerce datalayer.
+            BATCH_UPLOAD (3):
+                The event is ingested via Import user events
+                API.
+        """
         EVENT_SOURCE_UNSPECIFIED = 0
         AUTOML = 1
         ECOMMERCE = 2

diff --git a/samples/generated_samples/snippet_metadata_google.cloud.recommendationengine.v1beta1.json b/samples/generated_samples/snippet_metadata_google.cloud.recommendationengine.v1beta1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-recommendations-ai",
-    "version": "0.10.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {