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: https://github.com/googleapis/googleapis-gen/commit/bba746f8fc7494254decabce122582ad1a717958 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

Author: gcf-owl-bot[bot]

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:

docs/dialogflowcx_v3beta1/services.rst

@@ -4,6 +4,7 @@ Services for Google Cloud Dialogflowcx v3beta1 API
  :maxdepth: 2
 
  agents
+ deployments
  entity_types
  environments
  experiments

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",

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"

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>`__.

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>`__.

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>`__.

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>`__.

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",
+)