feat(v3beta1): added support for Deployments with ListDeployments and…

… GetDeployment apis (#177) - [ ] Regenerate this pull request now. PiperOrigin-RevId: 399726267 Source-Link: googleapis/googleapis@14829f3 Source-Link: googleapis/googleapis-gen@bba746f Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYmJhNzQ2ZjhmYzc0OTQyNTRkZWNhYmNlMTIyNTgyYWQxYTcxNzk1OCJ9 feat(v3beta1): added support for DeployFlow api under Environments feat(v3beta1): added support for TestCasesConfig under Environment docs(v3beta1): added long running operation explanation for several apis fix(v3beta1): marked resource name of security setting as not-required
googleapis · Sep 30, 2021 · 977e2aa · 977e2aa
1 parent 0e3378d
commit 977e2aa
Show file tree

Hide file tree

Showing 40 changed files with 4,953 additions and 87 deletions.
diff --git a/docs/dialogflowcx_v3beta1/deployments.rst b/docs/dialogflowcx_v3beta1/deployments.rst
@@ -0,0 +1,10 @@
+Deployments
+-----------------------------
+
+.. automodule:: google.cloud.dialogflowcx_v3beta1.services.deployments
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.dialogflowcx_v3beta1.services.deployments.pagers
+    :members:
+    :inherited-members:
diff --git a/docs/dialogflowcx_v3beta1/services.rst b/docs/dialogflowcx_v3beta1/services.rst
@@ -4,6 +4,7 @@ Services for Google Cloud Dialogflowcx v3beta1 API
     :maxdepth: 2
 
     agents
+    deployments
     entity_types
     environments
     experiments

diff --git a/google/cloud/dialogflowcx_v3beta1/__init__.py b/google/cloud/dialogflowcx_v3beta1/__init__.py
@@ -16,6 +16,8 @@
 
 from .services.agents import AgentsClient
 from .services.agents import AgentsAsyncClient
+from .services.deployments import DeploymentsClient
+from .services.deployments import DeploymentsAsyncClient
 from .services.entity_types import EntityTypesClient
 from .services.entity_types import EntityTypesAsyncClient
 from .services.environments import EnvironmentsClient
@@ -67,6 +69,10 @@
 from .types.audio_config import OutputAudioEncoding
 from .types.audio_config import SpeechModelVariant
 from .types.audio_config import SsmlVoiceGender
+from .types.deployment import Deployment
+from .types.deployment import GetDeploymentRequest
+from .types.deployment import ListDeploymentsRequest
+from .types.deployment import ListDeploymentsResponse
 from .types.entity_type import CreateEntityTypeRequest
 from .types.entity_type import DeleteEntityTypeRequest
 from .types.entity_type import EntityType
@@ -77,6 +83,9 @@
 from .types.environment import ContinuousTestResult
 from .types.environment import CreateEnvironmentRequest
 from .types.environment import DeleteEnvironmentRequest
+from .types.environment import DeployFlowMetadata
+from .types.environment import DeployFlowRequest
+from .types.environment import DeployFlowResponse
 from .types.environment import Environment
 from .types.environment import GetEnvironmentRequest
 from .types.environment import ListContinuousTestResultsRequest
@@ -237,6 +246,7 @@
 
 __all__ = (
     "AgentsAsyncClient",
+    "DeploymentsAsyncClient",
     "EntityTypesAsyncClient",
     "EnvironmentsAsyncClient",
     "ExperimentsAsyncClient",
@@ -290,6 +300,11 @@
     "DeleteTransitionRouteGroupRequest",
     "DeleteVersionRequest",
     "DeleteWebhookRequest",
+    "DeployFlowMetadata",
+    "DeployFlowRequest",
+    "DeployFlowResponse",
+    "Deployment",
+    "DeploymentsClient",
     "DetectIntentRequest",
     "DetectIntentResponse",
     "DtmfInput",
@@ -317,6 +332,7 @@
     "Fulfillment",
     "GetAgentRequest",
     "GetAgentValidationResultRequest",
+    "GetDeploymentRequest",
     "GetEntityTypeRequest",
     "GetEnvironmentRequest",
     "GetExperimentRequest",
@@ -346,6 +362,8 @@
     "ListAgentsResponse",
     "ListContinuousTestResultsRequest",
     "ListContinuousTestResultsResponse",
+    "ListDeploymentsRequest",
+    "ListDeploymentsResponse",
     "ListEntityTypesRequest",
     "ListEntityTypesResponse",
     "ListEnvironmentsRequest",

diff --git a/google/cloud/dialogflowcx_v3beta1/gapic_metadata.json b/google/cloud/dialogflowcx_v3beta1/gapic_metadata.json
@@ -109,6 +109,40 @@
         }
       }
     },
+    "Deployments": {
+      "clients": {
+        "grpc": {
+          "libraryClient": "DeploymentsClient",
+          "rpcs": {
+            "GetDeployment": {
+              "methods": [
+                "get_deployment"
+              ]
+            },
+            "ListDeployments": {
+              "methods": [
+                "list_deployments"
+              ]
+            }
+          }
+        },
+        "grpc-async": {
+          "libraryClient": "DeploymentsAsyncClient",
+          "rpcs": {
+            "GetDeployment": {
+              "methods": [
+                "get_deployment"
+              ]
+            },
+            "ListDeployments": {
+              "methods": [
+                "list_deployments"
+              ]
+            }
+          }
+        }
+      }
+    },
     "EntityTypes": {
       "clients": {
         "grpc": {
@@ -188,6 +222,11 @@
                 "delete_environment"
               ]
             },
+            "DeployFlow": {
+              "methods": [
+                "deploy_flow"
+              ]
+            },
             "GetEnvironment": {
               "methods": [
                 "get_environment"
@@ -233,6 +272,11 @@
                 "delete_environment"
               ]
             },
+            "DeployFlow": {
+              "methods": [
+                "deploy_flow"
+              ]
+            },
             "GetEnvironment": {
               "methods": [
                 "get_environment"

diff --git a/google/cloud/dialogflowcx_v3beta1/services/agents/async_client.py b/google/cloud/dialogflowcx_v3beta1/services/agents/async_client.py
@@ -608,8 +608,9 @@ async def export_agent(
         timeout: float = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> operation_async.AsyncOperation:
-        r"""Exports the specified agent to a binary file. This method is a
-        `long-running
+        r"""Exports the specified agent to a binary file.
+
+        This method is a `long-running
         operation <https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation>`__.
         The returned ``Operation`` type has the following
         method-specific fields:
@@ -684,6 +685,16 @@ async def restore_agent(
         existing resources in agent (e.g. intents, entity types, flows)
         will be removed.
 
+        This method is a `long-running
+        operation <https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation>`__.
+        The returned ``Operation`` type has the following
+        method-specific fields:
+
+        -  ``metadata``: An empty `Struct
+           message <https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct>`__
+        -  ``response``: An `Empty
+           message <https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty>`__
+
         Note: You should always train a flow prior to sending it
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/cx/docs/concept/training>`__.

diff --git a/google/cloud/dialogflowcx_v3beta1/services/agents/client.py b/google/cloud/dialogflowcx_v3beta1/services/agents/client.py
@@ -873,8 +873,9 @@ def export_agent(
         timeout: float = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> operation.Operation:
-        r"""Exports the specified agent to a binary file. This method is a
-        `long-running
+        r"""Exports the specified agent to a binary file.
+
+        This method is a `long-running
         operation <https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation>`__.
         The returned ``Operation`` type has the following
         method-specific fields:
@@ -950,6 +951,16 @@ def restore_agent(
         existing resources in agent (e.g. intents, entity types, flows)
         will be removed.
 
+        This method is a `long-running
+        operation <https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation>`__.
+        The returned ``Operation`` type has the following
+        method-specific fields:
+
+        -  ``metadata``: An empty `Struct
+           message <https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct>`__
+        -  ``response``: An `Empty
+           message <https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty>`__
+
         Note: You should always train a flow prior to sending it
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/cx/docs/concept/training>`__.

diff --git a/google/cloud/dialogflowcx_v3beta1/services/agents/transports/grpc.py b/google/cloud/dialogflowcx_v3beta1/services/agents/transports/grpc.py
@@ -386,8 +386,9 @@ def export_agent(
     ) -> Callable[[agent.ExportAgentRequest], operations_pb2.Operation]:
         r"""Return a callable for the export agent method over gRPC.
 
-        Exports the specified agent to a binary file. This method is a
-        `long-running
+        Exports the specified agent to a binary file.
+
+        This method is a `long-running
         operation <https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation>`__.
         The returned ``Operation`` type has the following
         method-specific fields:
@@ -427,6 +428,16 @@ def restore_agent(
         existing resources in agent (e.g. intents, entity types, flows)
         will be removed.
 
+        This method is a `long-running
+        operation <https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation>`__.
+        The returned ``Operation`` type has the following
+        method-specific fields:
+
+        -  ``metadata``: An empty `Struct
+           message <https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct>`__
+        -  ``response``: An `Empty
+           message <https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty>`__
+
         Note: You should always train a flow prior to sending it
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/cx/docs/concept/training>`__.

diff --git a/google/cloud/dialogflowcx_v3beta1/services/agents/transports/grpc_asyncio.py b/google/cloud/dialogflowcx_v3beta1/services/agents/transports/grpc_asyncio.py
@@ -393,8 +393,9 @@ def export_agent(
     ) -> Callable[[agent.ExportAgentRequest], Awaitable[operations_pb2.Operation]]:
         r"""Return a callable for the export agent method over gRPC.
 
-        Exports the specified agent to a binary file. This method is a
-        `long-running
+        Exports the specified agent to a binary file.
+
+        This method is a `long-running
         operation <https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation>`__.
         The returned ``Operation`` type has the following
         method-specific fields:
@@ -434,6 +435,16 @@ def restore_agent(
         existing resources in agent (e.g. intents, entity types, flows)
         will be removed.
 
+        This method is a `long-running
+        operation <https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation>`__.
+        The returned ``Operation`` type has the following
+        method-specific fields:
+
+        -  ``metadata``: An empty `Struct
+           message <https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct>`__
+        -  ``response``: An `Empty
+           message <https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty>`__
+
         Note: You should always train a flow prior to sending it
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/cx/docs/concept/training>`__.

diff --git a/google/cloud/dialogflowcx_v3beta1/services/deployments/__init__.py b/google/cloud/dialogflowcx_v3beta1/services/deployments/__init__.py
@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from .client import DeploymentsClient
+from .async_client import DeploymentsAsyncClient
+
+__all__ = (
+    "DeploymentsClient",
+    "DeploymentsAsyncClient",
+)