docs: Add documentation for enums (#265)

* 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 · 77e882b · 77e882b
1 parent cf64e94
commit 77e882b
Show file tree

Hide file tree

Showing 3 changed files with 45 additions and 3 deletions.
diff --git a/google/cloud/accessapproval_v1/services/access_approval/client.py b/google/cloud/accessapproval_v1/services/access_approval/client.py
@@ -1443,7 +1443,7 @@ def sample_get_access_approval_service_account():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "AccessApprovalClient":
         return self
 
     def __exit__(self, type, value, traceback):

diff --git a/google/cloud/accessapproval_v1/types/accessapproval.py b/google/cloud/accessapproval_v1/types/accessapproval.py
@@ -50,6 +50,13 @@
 class EnrollmentLevel(proto.Enum):
     r"""Represents the type of enrollment for a given service to
     Access Approval.
+
+    Values:
+        ENROLLMENT_LEVEL_UNSPECIFIED (0):
+            Default value for proto, shouldn't be used.
+        BLOCK_ALL (1):
+            Service is enrolled in Access Approval for
+            all requests
     """
     ENROLLMENT_LEVEL_UNSPECIFIED = 0
     BLOCK_ALL = 1
@@ -113,7 +120,42 @@ class AccessReason(proto.Message):
     """
 
     class Type(proto.Enum):
-        r"""Type of access justification."""
+        r"""Type of access justification.
+
+        Values:
+            TYPE_UNSPECIFIED (0):
+                Default value for proto, shouldn't be used.
+            CUSTOMER_INITIATED_SUPPORT (1):
+                Customer made a request or raised an issue that required the
+                principal to access customer data. ``detail`` is of the form
+                ("#####" is the issue ID):
+
+                -  "Feedback Report: #####"
+                -  "Case Number: #####"
+                -  "Case ID: #####"
+                -  "E-PIN Reference: #####"
+                -  "Google-#####"
+                -  "T-#####".
+            GOOGLE_INITIATED_SERVICE (2):
+                The principal accessed customer data in order
+                to diagnose or resolve a suspected issue in
+                services. Often this access is used to confirm
+                that customers are not affected by a suspected
+                service issue or to remediate a reversible
+                system issue.
+            GOOGLE_INITIATED_REVIEW (3):
+                Google initiated service for security, fraud,
+                abuse, or compliance purposes.
+            THIRD_PARTY_DATA_REQUEST (4):
+                The principal was compelled to access
+                customer data in order to respond to a legal
+                third party data request or process, including
+                legal processes from customers themselves.
+            GOOGLE_RESPONSE_TO_PRODUCTION_ALERT (5):
+                The principal accessed customer data in order
+                to diagnose or resolve a suspected issue in
+                services or a known outage.
+        """
         TYPE_UNSPECIFIED = 0
         CUSTOMER_INITIATED_SUPPORT = 1
         GOOGLE_INITIATED_SERVICE = 2

diff --git a/samples/generated_samples/snippet_metadata_google.cloud.accessapproval.v1.json b/samples/generated_samples/snippet_metadata_google.cloud.accessapproval.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-access-approval",
-    "version": "1.10.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {