docs: Add documentation for enums (#524)

* 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

* revert

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]

google/cloud/monitoring_v3/services/alert_policy_service/client.py

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

google/cloud/monitoring_v3/services/group_service/client.py

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

google/cloud/monitoring_v3/services/metric_service/client.py

@@ -1589,7 +1589,7 @@ def sample_create_service_time_series():
             metadata=metadata,
         )
 
-    def __enter__(self):
+    def __enter__(self) -> "MetricServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

google/cloud/monitoring_v3/services/notification_channel_service/client.py

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

google/cloud/monitoring_v3/services/query_service/client.py

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

google/cloud/monitoring_v3/services/service_monitoring_service/client.py

@@ -1610,7 +1610,7 @@ def sample_delete_service_level_objective():
             metadata=metadata,
         )
 
-    def __enter__(self):
+    def __enter__(self) -> "ServiceMonitoringServiceClient":
         return self
 
     def __exit__(self, type, value, traceback):

google/cloud/monitoring_v3/services/snooze_service/client.py

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

google/cloud/monitoring_v3/services/uptime_check_service/client.py

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

google/cloud/monitoring_v3/types/alert.py

@@ -133,7 +133,26 @@ class AlertPolicy(proto.Message):
     """
 
     class ConditionCombinerType(proto.Enum):
-        r"""Operators for combining conditions."""
+        r"""Operators for combining conditions.
+
+        Values:
+            COMBINE_UNSPECIFIED (0):
+                An unspecified combiner.
+            AND (1):
+                Combine conditions using the logical ``AND`` operator. An
+                incident is created only if all the conditions are met
+                simultaneously. This combiner is satisfied if all conditions
+                are met, even if they are met on completely different
+                resources.
+            OR (2):
+                Combine conditions using the logical ``OR`` operator. An
+                incident is created if any of the listed conditions is met.
+            AND_WITH_MATCHING_RESOURCE (3):
+                Combine conditions using logical ``AND`` operator, but
+                unlike the regular ``AND`` option, an incident is created
+                only if all conditions are met simultaneously on at least
+                one resource.
+        """
         COMBINE_UNSPECIFIED = 0
         AND = 1
         OR = 2
@@ -243,6 +262,20 @@ class EvaluationMissingData(proto.Enum):
             r"""A condition control that determines how metric-threshold
             conditions are evaluated when data stops arriving.
             This control doesn't affect metric-absence policies.
+
+            Values:
+                EVALUATION_MISSING_DATA_UNSPECIFIED (0):
+                    An unspecified evaluation missing data option. Equivalent to
+                    EVALUATION_MISSING_DATA_NO_OP.
+                EVALUATION_MISSING_DATA_INACTIVE (1):
+                    If there is no data to evaluate the
+                    condition, then evaluate the condition as false.
+                EVALUATION_MISSING_DATA_ACTIVE (2):
+                    If there is no data to evaluate the
+                    condition, then evaluate the condition as true.
+                EVALUATION_MISSING_DATA_NO_OP (3):
+                    Do not evaluate the condition to any value if
+                    there is no data.
             """
             EVALUATION_MISSING_DATA_UNSPECIFIED = 0
             EVALUATION_MISSING_DATA_INACTIVE = 1