docs: Add documentation for enums (#611)

* 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>

Author: gcf-owl-bot[bot]

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/agents/client.py

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

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/answer_records/client.py

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

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/contexts/client.py

@@ -1148,7 +1148,7 @@ def sample_delete_all_contexts():
             metadata=metadata,
         )
 
-    def __enter__(self):
+    def __enter__(self) -> "ContextsClient":
         return self
 
     def __exit__(self, type, value, traceback):

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/conversation_datasets/client.py

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

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/conversation_models/client.py

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

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/conversation_profiles/client.py

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

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/conversations/client.py

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

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/documents/client.py

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

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/entity_types/client.py

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

packages/google-cloud-dialogflow/google/cloud/dialogflow_v2/services/environments/client.py

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