docs: Add documentation for enums (#230)

gcf-owl-bot[bot] · web-flow · commit 7923a861af0a · 2023-01-20T11:46:14.000-05:00
* 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: https://github.com/googleapis/googleapis-gen/commit/0080f830dec37c3384157082bce279e37079ea58 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>
diff --git a/google/cloud/billing_v1/services/cloud_billing/client.py b/google/cloud/billing_v1/services/cloud_billing/client.py
@@ -1701,7 +1701,7 @@ def sample_test_iam_permissions():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "CloudBillingClient":
         return self
 
     def __exit__(self, type, value, traceback):
diff --git a/google/cloud/billing_v1/services/cloud_catalog/client.py b/google/cloud/billing_v1/services/cloud_catalog/client.py
@@ -651,7 +651,7 @@ def sample_list_skus():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "CloudCatalogClient":
         return self
 
     def __exit__(self, type, value, traceback):
diff --git a/google/cloud/billing_v1/types/cloud_catalog.py b/google/cloud/billing_v1/types/cloud_catalog.py
@@ -364,6 +364,14 @@ class AggregationLevel(proto.Enum):
         Example: "ACCOUNT" aggregation level indicates that usage for
         tiered pricing is aggregated across all projects in a single
         account.
+
+        Values:
+            AGGREGATION_LEVEL_UNSPECIFIED (0):
+
+            ACCOUNT (1):
+
+            PROJECT (2):
+
         """
         AGGREGATION_LEVEL_UNSPECIFIED = 0
         ACCOUNT = 1
@@ -373,6 +381,14 @@ class AggregationInterval(proto.Enum):
         r"""The interval at which usage is aggregated to compute cost.
         Example: "MONTHLY" aggregation interval indicates that usage for
         tiered pricing is aggregated every month.
+
+        Values:
+            AGGREGATION_INTERVAL_UNSPECIFIED (0):
+
+            DAILY (1):
+
+            MONTHLY (2):
+
         """
         AGGREGATION_INTERVAL_UNSPECIFIED = 0
         DAILY = 1
@@ -408,7 +424,22 @@ class GeoTaxonomy(proto.Message):
     """
 
     class Type(proto.Enum):
-        r"""The type of Geo Taxonomy: GLOBAL, REGIONAL, or MULTI_REGIONAL."""
+        r"""The type of Geo Taxonomy: GLOBAL, REGIONAL, or MULTI_REGIONAL.
+
+        Values:
+            TYPE_UNSPECIFIED (0):
+                The type is not specified.
+            GLOBAL (1):
+                The sku is global in nature, e.g. a license
+                sku. Global skus are available in all regions,
+                and so have an empty region list.
+            REGIONAL (2):
+                The sku is available in a specific region,
+                e.g. "us-west2".
+            MULTI_REGIONAL (3):
+                The sku is associated with multiple regions,
+                e.g. "us-west2" and "us-east1".
+        """
         TYPE_UNSPECIFIED = 0
         GLOBAL = 1
         REGIONAL = 2
diff --git a/samples/generated_samples/snippet_metadata_google.cloud.billing.v1.json b/samples/generated_samples/snippet_metadata_google.cloud.billing.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-billing",
-    "version": "1.9.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {

Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`],`
`9`	`9`	`"language": "PYTHON",`
`10`	`10`	`"name": "google-cloud-billing",`
`11`		`- "version": "1.9.0"`
	`11`	`+ "version": "0.1.0"`
`12`	`12`	`},`
`13`	`13`	`"snippets": [`
`14`	`14`	`{`