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 <partheniou@google.com>

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