chore: use gapic-generator-python 0.63.1 (#245)

- [x] Regenerate this pull request now.

docs: add autogenerated code snippets
PiperOrigin-RevId: 426256923

Source-Link: googleapis/googleapis@9ebabfa

Source-Link: googleapis/googleapis-gen@a881752
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYTg4MTc1MjYzZTYwYTFkNDVkM2E0NDc4NDg2NTJiMGY2NzBiMmNiOCJ9

Fixes #229

packages/google-cloud-dialogflow-cx/.repo-metadata.json

@@ -12,5 +12,5 @@
     "api_id": "dialogflow.googleapis.com",
     "default_version": "v3",
     "codeowner_team": "@googleapis/cdpe-cloudai",
-    "api_shortname": "dialogflow-cx"
+    "api_shortname": "dialogflow"
 }

packages/google-cloud-dialogflow-cx/docs/README.rst

@@ -0,0 +1 @@
+../README.rst

packages/google-cloud-dialogflow-cx/docs/index.rst

@@ -2,6 +2,9 @@
 
 .. include:: multiprocessing.rst
 
+This package includes clients for multiple versions of Dialogflow CX.
+By default, you will get version ``dialogflowcx_v3``.
+
 
 API Reference
 -------------
@@ -10,15 +13,22 @@ API Reference
 
     dialogflowcx_v3/services
     dialogflowcx_v3/types
+
+API Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
     dialogflowcx_v3beta1/services
     dialogflowcx_v3beta1/types
 
+
 Changelog
 ---------
 
 For a list of all ``google-cloud-dialogflow-cx`` releases:
 
 .. toctree::
-   :maxdepth: 2
+    :maxdepth: 2
 
-   changelog
+    changelog

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/services/agents/async_client.py

@@ -230,6 +230,25 @@ async def list_agents(
         r"""Returns the list of all agents in the specified
         location.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflowcx_v3
+
+            def sample_list_agents():
+                # Create a client
+                client = dialogflowcx_v3.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflowcx_v3.ListAgentsRequest(
+                    parent="parent_value",
+                )
+
+                # Make the request
+                page_result = client.list_agents(request=request)
+                for response in page_result:
+                    print(response)
+
         Args:
             request (Union[google.cloud.dialogflowcx_v3.types.ListAgentsRequest, dict]):
                 The request object. The request message for
@@ -310,6 +329,25 @@ async def get_agent(
     ) -> agent.Agent:
         r"""Retrieves the specified agent.
 
+        .. code-block::
+
+            from google.cloud import dialogflowcx_v3
+
+            def sample_get_agent():
+                # Create a client
+                client = dialogflowcx_v3.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflowcx_v3.GetAgentRequest(
+                    name="name_value",
+                )
+
+                # Make the request
+                response = client.get_agent(request=request)
+
+                # Handle response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflowcx_v3.types.GetAgentRequest, dict]):
                 The request object. The request message for
@@ -398,6 +436,32 @@ async def create_agent(
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/cx/docs/concept/training>`__.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflowcx_v3
+
+            def sample_create_agent():
+                # Create a client
+                client = dialogflowcx_v3.AgentsClient()
+
+                # Initialize request argument(s)
+                agent = dialogflowcx_v3.Agent()
+                agent.display_name = "display_name_value"
+                agent.default_language_code = "default_language_code_value"
+                agent.time_zone = "time_zone_value"
+
+                request = dialogflowcx_v3.CreateAgentRequest(
+                    parent="parent_value",
+                    agent=agent,
+                )
+
+                # Make the request
+                response = client.create_agent(request=request)
+
+                # Handle response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflowcx_v3.types.CreateAgentRequest, dict]):
                 The request object. The request message for
@@ -493,6 +557,31 @@ async def update_agent(
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/cx/docs/concept/training>`__.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflowcx_v3
+
+            def sample_update_agent():
+                # Create a client
+                client = dialogflowcx_v3.AgentsClient()
+
+                # Initialize request argument(s)
+                agent = dialogflowcx_v3.Agent()
+                agent.display_name = "display_name_value"
+                agent.default_language_code = "default_language_code_value"
+                agent.time_zone = "time_zone_value"
+
+                request = dialogflowcx_v3.UpdateAgentRequest(
+                    agent=agent,
+                )
+
+                # Make the request
+                response = client.update_agent(request=request)
+
+                # Handle response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflowcx_v3.types.UpdateAgentRequest, dict]):
                 The request object. The request message for
@@ -586,6 +675,22 @@ async def delete_agent(
     ) -> None:
         r"""Deletes the specified agent.
 
+        .. code-block::
+
+            from google.cloud import dialogflowcx_v3
+
+            def sample_delete_agent():
+                # Create a client
+                client = dialogflowcx_v3.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflowcx_v3.DeleteAgentRequest(
+                    name="name_value",
+                )
+
+                # Make the request
+                response = client.delete_agent(request=request)
+
         Args:
             request (Union[google.cloud.dialogflowcx_v3.types.DeleteAgentRequest, dict]):
                 The request object. The request message for
@@ -659,6 +764,28 @@ async def export_agent(
         -  ``response``:
            [ExportAgentResponse][google.cloud.dialogflow.cx.v3.ExportAgentResponse]
 
+
+        .. code-block::
+
+            from google.cloud import dialogflowcx_v3
+
+            def sample_export_agent():
+                # Create a client
+                client = dialogflowcx_v3.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflowcx_v3.ExportAgentRequest(
+                    name="name_value",
+                )
+
+                # Make the request
+                operation = client.export_agent(request=request)
+
+                print("Waiting for operation to complete...")
+
+                response = operation.result()
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflowcx_v3.types.ExportAgentRequest, dict]):
                 The request object. The request message for
@@ -738,6 +865,29 @@ async def restore_agent(
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/cx/docs/concept/training>`__.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflowcx_v3
+
+            def sample_restore_agent():
+                # Create a client
+                client = dialogflowcx_v3.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflowcx_v3.RestoreAgentRequest(
+                    agent_uri="agent_uri_value",
+                    name="name_value",
+                )
+
+                # Make the request
+                operation = client.restore_agent(request=request)
+
+                print("Waiting for operation to complete...")
+
+                response = operation.result()
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflowcx_v3.types.RestoreAgentRequest, dict]):
                 The request object. The request message for
@@ -811,6 +961,26 @@ async def validate_agent(
         validated. Please call this API after the training is
         completed to get the complete validation results.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflowcx_v3
+
+            def sample_validate_agent():
+                # Create a client
+                client = dialogflowcx_v3.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflowcx_v3.ValidateAgentRequest(
+                    name="name_value",
+                )
+
+                # Make the request
+                response = client.validate_agent(request=request)
+
+                # Handle response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflowcx_v3.types.ValidateAgentRequest, dict]):
                 The request object. The request message for
@@ -862,6 +1032,26 @@ async def get_agent_validation_result(
         r"""Gets the latest agent validation result. Agent
         validation is performed when ValidateAgent is called.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflowcx_v3
+
+            def sample_get_agent_validation_result():
+                # Create a client
+                client = dialogflowcx_v3.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflowcx_v3.GetAgentValidationResultRequest(
+                    name="name_value",
+                )
+
+                # Make the request
+                response = client.get_agent_validation_result(request=request)
+
+                # Handle response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflowcx_v3.types.GetAgentValidationResultRequest, dict]):
                 The request object. The request message for