docs: Add documentation for enums (#10822)

* 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: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWFwcHMtc2NyaXB0LXR5cGUvLk93bEJvdC55YW1sIiwiaCI6IjAwODBmODMwZGVjMzdjMzM4NDE1NzA4MmJjZTI3OWUzNzA3OWVhNTgifQ==
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWNvbnRlbnR3YXJlaG91c2UvLk93bEJvdC55YW1sIiwiaCI6IjAwODBmODMwZGVjMzdjMzM4NDE1NzA4MmJjZTI3OWUzNzA3OWVhNTgifQ==
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRhdGFjYXRhbG9nLWxpbmVhZ2UvLk93bEJvdC55YW1sIiwiaCI6IjAwODBmODMwZGVjMzdjMzM4NDE1NzA4MmJjZTI3OWUzNzA3OWVhNTgifQ==
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpc2NvdmVyeWVuZ2luZS8uT3dsQm90LnlhbWwiLCJoIjoiMDA4MGY4MzBkZWMzN2MzMzg0MTU3MDgyYmNlMjc5ZTM3MDc5ZWE1OCJ9
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWVudGVycHJpc2Vrbm93bGVkZ2VncmFwaC8uT3dsQm90LnlhbWwiLCJoIjoiMDA4MGY4MzBkZWMzN2MzMzg0MTU3MDgyYmNlMjc5ZTM3MDc5ZWE1OCJ9
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXZtd2FyZWVuZ2luZS8uT3dsQm90LnlhbWwiLCJoIjoiMDA4MGY4MzBkZWMzN2MzMzg0MTU3MDgyYmNlMjc5ZTM3MDc5ZWE1OCJ9
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLW1hcHMtYWRkcmVzc3ZhbGlkYXRpb24vLk93bEJvdC55YW1sIiwiaCI6IjAwODBmODMwZGVjMzdjMzM4NDE1NzA4MmJjZTI3OWUzNzA3OWVhNTgifQ==
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLW1hcHMtcm91dGluZy8uT3dsQm90LnlhbWwiLCJoIjoiMDA4MGY4MzBkZWMzN2MzMzg0MTU3MDgyYmNlMjc5ZTM3MDc5ZWE1OCJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* revert

* lint

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <[email protected]>

Author: gcf-owl-bot[bot]

packages/google-apps-script-type/google/apps/script/type/calendar/types/calendar_addon_manifest.py

@@ -62,6 +62,28 @@ class CalendarAddOnManifest(proto.Message):
     class EventAccess(proto.Enum):
         r"""An enum defining the level of data access event triggers
         require.
+
+        Values:
+            UNSPECIFIED (0):
+                Default value when nothing is set for
+                EventAccess.
+            METADATA (1):
+                METADATA gives event triggers the permission
+                to access the metadata of events such as event
+                id and calendar id.
+            READ (3):
+                READ gives event triggers access to all
+                provided event fields including the metadata,
+                attendees, and conference data.
+            WRITE (4):
+                WRITE gives event triggers access to the
+                metadata of events and the ability to perform
+                all actions, including adding attendees and
+                setting conference data.
+            READ_WRITE (5):
+                READ_WRITE gives event triggers access to all provided event
+                fields including the metadata, attendees, and conference
+                data and the ability to perform all actions.
         """
         UNSPECIFIED = 0
         METADATA = 1

packages/google-apps-script-type/google/apps/script/type/gmail/types/gmail_addon_manifest.py

@@ -161,6 +161,20 @@ class ComposeTrigger(proto.Message):
     class DraftAccess(proto.Enum):
         r"""An enum defining the level of data access this compose
         trigger requires.
+
+        Values:
+            UNSPECIFIED (0):
+                Default value when nothing is set for
+                DraftAccess.
+            NONE (1):
+                NONE means compose trigger won't be able to
+                access any data of the draft when a compose
+                addon is triggered.
+            METADATA (2):
+                METADATA gives compose trigger the permission
+                to access the metadata of the draft when a
+                compose addon is triggered. This includes the
+                audience list (To/cc list) of a draft message.
         """
         UNSPECIFIED = 0
         NONE = 1

packages/google-apps-script-type/google/apps/script/type/types/addon_widget_set.py

@@ -34,7 +34,29 @@ class AddOnWidgetSet(proto.Message):
     """
 
     class WidgetType(proto.Enum):
-        r"""The Widget type. DEFAULT is the basic widget set."""
+        r"""The Widget type. DEFAULT is the basic widget set.
+
+        Values:
+            WIDGET_TYPE_UNSPECIFIED (0):
+                The default widget set.
+            DATE_PICKER (1):
+                The date picker.
+            STYLED_BUTTONS (2):
+                Styled buttons include filled buttons and
+                disabled buttons.
+            PERSISTENT_FORMS (3):
+                Persistent forms allow persisting form values
+                during actions.
+            FIXED_FOOTER (4):
+                Fixed footer in card.
+            UPDATE_SUBJECT_AND_RECIPIENTS (5):
+                Update the subject and recipients of a draft.
+            GRID_WIDGET (6):
+                The grid widget.
+            ADDON_COMPOSE_UI_ACTION (7):
+                A Gmail add-on action that applies to the
+                addon compose UI.
+        """
         WIDGET_TYPE_UNSPECIFIED = 0
         DATE_PICKER = 1
         STYLED_BUTTONS = 2

packages/google-apps-script-type/google/apps/script/type/types/script_manifest.py

@@ -32,7 +32,20 @@
 
 
 class HttpAuthorizationHeader(proto.Enum):
-    r"""Authorization header sent in add-on HTTP requests"""
+    r"""Authorization header sent in add-on HTTP requests
+
+    Values:
+        HTTP_AUTHORIZATION_HEADER_UNSPECIFIED (0):
+            Default value, equivalent to ``SYSTEM_ID_TOKEN``
+        SYSTEM_ID_TOKEN (1):
+            Send an ID token for the project-specific
+            Google Workspace Add-ons system service account
+            (default)
+        USER_ID_TOKEN (2):
+            Send an ID token for the end user
+        NONE (3):
+            Do not send an Authentication header
+    """
     HTTP_AUTHORIZATION_HEADER_UNSPECIFIED = 0
     SYSTEM_ID_TOKEN = 1
     USER_ID_TOKEN = 2

packages/google-cloud-contentwarehouse/google/cloud/contentwarehouse_v1/services/document_link_service/client.py

@@ -904,7 +904,7 @@ def sample_delete_document_link():
             metadata=metadata,
         )
 
-    def __enter__(self):
+    def __enter__(self) -> "DocumentLinkServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

packages/google-cloud-contentwarehouse/google/cloud/contentwarehouse_v1/services/document_schema_service/client.py

@@ -1023,7 +1023,7 @@ def sample_list_document_schemas():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "DocumentSchemaServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

packages/google-cloud-contentwarehouse/google/cloud/contentwarehouse_v1/services/document_service/client.py

@@ -1274,7 +1274,7 @@ def sample_set_acl():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "DocumentServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

packages/google-cloud-contentwarehouse/google/cloud/contentwarehouse_v1/services/rule_set_service/client.py

@@ -1022,7 +1022,7 @@ def sample_list_rule_sets():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "RuleSetServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

packages/google-cloud-contentwarehouse/google/cloud/contentwarehouse_v1/services/synonym_set_service/client.py

@@ -1033,7 +1033,7 @@ def sample_list_synonym_sets():
         # Done; return the response.
         return response
 
-    def __enter__(self):
+    def __enter__(self) -> "SynonymSetServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

packages/google-cloud-contentwarehouse/google/cloud/contentwarehouse_v1/types/common.py

@@ -34,7 +34,23 @@
 
 
 class UpdateType(proto.Enum):
-    r"""Update type of the requests."""
+    r"""Update type of the requests.
+
+    Values:
+        UPDATE_TYPE_UNSPECIFIED (0):
+            Defaults to full replace behavior, ie. FULL_REPLACE.
+        UPDATE_TYPE_REPLACE (1):
+            Fully replace all the fields. Any field masks
+            will be ignored.
+        UPDATE_TYPE_MERGE (2):
+            Merge the fields into the existing entities.
+        UPDATE_TYPE_INSERT_PROPERTIES_BY_NAMES (3):
+            Inserts the properties by names.
+        UPDATE_TYPE_REPLACE_PROPERTIES_BY_NAMES (4):
+            Replace the properties by names.
+        UPDATE_TYPE_DELETE_PROPERTIES_BY_NAMES (5):
+            Delete the properties by names.
+    """
     UPDATE_TYPE_UNSPECIFIED = 0
     UPDATE_TYPE_REPLACE = 1
     UPDATE_TYPE_MERGE = 2
@@ -44,14 +60,39 @@ class UpdateType(proto.Enum):
 
 
 class DatabaseType(proto.Enum):
-    r"""Type of database used by the customer"""
+    r"""Type of database used by the customer
+
+    Values:
+        DB_UNKNOWN (0):
+            This value is required by protobuf best
+            practices
+        DB_INFRA_SPANNER (1):
+            Internal Spanner
+        DB_CLOUD_SQL_POSTGRES (2):
+            Cloud Sql with a Postgres Sql instance
+    """
     DB_UNKNOWN = 0
     DB_INFRA_SPANNER = 1
     DB_CLOUD_SQL_POSTGRES = 2
 
 
 class AccessControlMode(proto.Enum):
-    r"""Access Control Mode."""
+    r"""Access Control Mode.
+
+    Values:
+        ACL_MODE_UNKNOWN (0):
+            This value is required by protobuf best
+            practices
+        ACL_MODE_UNIVERSAL_ACCESS (1):
+            Universal Access: No document level access
+            control.
+        ACL_MODE_DOCUMENT_LEVEL_ACCESS_CONTROL_BYOID (2):
+            Document level access control with customer
+            own Identity Service.
+        ACL_MODE_DOCUMENT_LEVEL_ACCESS_CONTROL_GCI (3):
+            Document level access control using Google
+            Cloud Identity.
+    """
     ACL_MODE_UNKNOWN = 0
     ACL_MODE_UNIVERSAL_ACCESS = 1
     ACL_MODE_DOCUMENT_LEVEL_ACCESS_CONTROL_BYOID = 2