docs: Add documentation for enums (#58)

* 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 · cbd289d · cbd289d
1 parent a7a5b9e
commit cbd289d
Show file tree

Hide file tree

Showing 3 changed files with 56 additions and 4 deletions.
diff --git a/google/cloud/bigquery_data_exchange_v1beta1/services/analytics_hub_service/client.py b/google/cloud/bigquery_data_exchange_v1beta1/services/analytics_hub_service/client.py
@@ -2197,7 +2197,7 @@ def sample_test_iam_permissions():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "AnalyticsHubServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/google/cloud/bigquery_data_exchange_v1beta1/types/dataexchange.py b/google/cloud/bigquery_data_exchange_v1beta1/types/dataexchange.py
@@ -308,12 +308,64 @@ class Listing(proto.Message):
     """
 
     class State(proto.Enum):
-        r"""State of the listing."""
+        r"""State of the listing.
+
+        Values:
+            STATE_UNSPECIFIED (0):
+                Default value. This value is unused.
+            ACTIVE (1):
+                Subscribable state. Users with
+                dataexchange.listings.subscribe permission can
+                subscribe to this listing.
+        """
         STATE_UNSPECIFIED = 0
         ACTIVE = 1
 
     class Category(proto.Enum):
-        r"""Listing categories."""
+        r"""Listing categories.
+
+        Values:
+            CATEGORY_UNSPECIFIED (0):
+
+            CATEGORY_OTHERS (1):
+
+            CATEGORY_ADVERTISING_AND_MARKETING (2):
+
+            CATEGORY_COMMERCE (3):
+
+            CATEGORY_CLIMATE_AND_ENVIRONMENT (4):
+
+            CATEGORY_DEMOGRAPHICS (5):
+
+            CATEGORY_ECONOMICS (6):
+
+            CATEGORY_EDUCATION (7):
+
+            CATEGORY_ENERGY (8):
+
+            CATEGORY_FINANCIAL (9):
+
+            CATEGORY_GAMING (10):
+
+            CATEGORY_GEOSPATIAL (11):
+
+            CATEGORY_HEALTHCARE_AND_LIFE_SCIENCE (12):
+
+            CATEGORY_MEDIA (13):
+
+            CATEGORY_PUBLIC_SECTOR (14):
+
+            CATEGORY_RETAIL (15):
+
+            CATEGORY_SPORTS (16):
+
+            CATEGORY_SCIENCE_AND_RESEARCH (17):
+
+            CATEGORY_TRANSPORTATION_AND_LOGISTICS (18):
+
+            CATEGORY_TRAVEL_AND_TOURISM (19):
+
+        """
         CATEGORY_UNSPECIFIED = 0
         CATEGORY_OTHERS = 1
         CATEGORY_ADVERTISING_AND_MARKETING = 2

diff --git a/samples/generated_samples/snippet_metadata_google.cloud.bigquery.dataexchange.v1beta1.json b/samples/generated_samples/snippet_metadata_google.cloud.bigquery.dataexchange.v1beta1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-bigquery-data-exchange",
-    "version": "0.5.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {