google-cloud-dialogflow-cx-v3 0.1.1 → 0.4.0

data/lib/google/cloud/dialogflow/cx/v3/webhooks/client.rb

@@ -185,6 +185,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/dialogflow/cx/v3"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Dialogflow::CX::V3::Webhooks::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Dialogflow::CX::V3::ListWebhooksRequest.new
+              #
+              #   # Call the list_webhooks method.
+              #   result = client.list_webhooks request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can
+              #   # iterate over all elements by calling #each, and the enumerable
+              #   # will lazily make API calls to fetch subsequent pages. Other
+              #   # methods are also available for managing paging directly.
+              #   result.each do |response|
+              #     # Each element is of type ::Google::Cloud::Dialogflow::CX::V3::Webhook.
+              #     p response
+              #   end
+              #
               def list_webhooks request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -202,9 +223,11 @@ module Google
                   gapic_version: ::Google::Cloud::Dialogflow::CX::V3::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                header_params = {}
+                if request.parent
+                  header_params["parent"] = request.parent
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -256,6 +279,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/dialogflow/cx/v3"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Dialogflow::CX::V3::Webhooks::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Dialogflow::CX::V3::GetWebhookRequest.new
+              #
+              #   # Call the get_webhook method.
+              #   result = client.get_webhook request
+              #
+              #   # The returned object is of type Google::Cloud::Dialogflow::CX::V3::Webhook.
+              #   p result
+              #
               def get_webhook request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -273,9 +311,11 @@ module Google
                   gapic_version: ::Google::Cloud::Dialogflow::CX::V3::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -327,6 +367,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/dialogflow/cx/v3"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Dialogflow::CX::V3::Webhooks::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Dialogflow::CX::V3::CreateWebhookRequest.new
+              #
+              #   # Call the create_webhook method.
+              #   result = client.create_webhook request
+              #
+              #   # The returned object is of type Google::Cloud::Dialogflow::CX::V3::Webhook.
+              #   p result
+              #
               def create_webhook request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -344,9 +399,11 @@ module Google
                   gapic_version: ::Google::Cloud::Dialogflow::CX::V3::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                header_params = {}
+                if request.parent
+                  header_params["parent"] = request.parent
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -398,6 +455,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/dialogflow/cx/v3"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Dialogflow::CX::V3::Webhooks::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Dialogflow::CX::V3::UpdateWebhookRequest.new
+              #
+              #   # Call the update_webhook method.
+              #   result = client.update_webhook request
+              #
+              #   # The returned object is of type Google::Cloud::Dialogflow::CX::V3::Webhook.
+              #   p result
+              #
               def update_webhook request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -415,9 +487,11 @@ module Google
                   gapic_version: ::Google::Cloud::Dialogflow::CX::V3::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "webhook.name" => request.webhook.name
-                }
+                header_params = {}
+                if request.webhook&.name
+                  header_params["webhook.name"] = request.webhook.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -478,6 +552,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/dialogflow/cx/v3"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Dialogflow::CX::V3::Webhooks::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Dialogflow::CX::V3::DeleteWebhookRequest.new
+              #
+              #   # Call the delete_webhook method.
+              #   result = client.delete_webhook request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_webhook request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -495,9 +584,11 @@ module Google
                   gapic_version: ::Google::Cloud::Dialogflow::CX::V3::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 

data/lib/google/cloud/dialogflow/cx/v3.rb

@@ -20,15 +20,17 @@ require "google/cloud/dialogflow/cx/v3/pages"
 require "google/cloud/dialogflow/cx/v3/flows"
 require "google/cloud/dialogflow/cx/v3/security_settings_service"
 require "google/cloud/dialogflow/cx/v3/agents"
+require "google/cloud/dialogflow/cx/v3/changelogs"
+require "google/cloud/dialogflow/cx/v3/deployments"
 require "google/cloud/dialogflow/cx/v3/entity_types"
 require "google/cloud/dialogflow/cx/v3/intents"
 require "google/cloud/dialogflow/cx/v3/session_entity_types"
 require "google/cloud/dialogflow/cx/v3/sessions"
 require "google/cloud/dialogflow/cx/v3/transition_route_groups"
 require "google/cloud/dialogflow/cx/v3/test_cases"
+require "google/cloud/dialogflow/cx/v3/webhooks"
 require "google/cloud/dialogflow/cx/v3/environments"
 require "google/cloud/dialogflow/cx/v3/experiments"
-require "google/cloud/dialogflow/cx/v3/webhooks"
 require "google/cloud/dialogflow/cx/v3/versions"
 require "google/cloud/dialogflow/cx/v3/version"
 

data/proto_docs/google/cloud/dialogflow/cx/v3/changelog.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Dialogflow
+      module CX
+        module V3
+          # The request message for {::Google::Cloud::Dialogflow::CX::V3::Changelogs::Client#list_changelogs Changelogs.ListChangelogs}.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The agent containing the changelogs.
+          #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>`.
+          # @!attribute [rw] filter
+          #   @return [::String]
+          #     The filter string. Supports filter by user_email, resource, type and
+          #     create_time. Some examples:
+          #       1. By user email:
+          #            user_email = "someone@google.com"
+          #       2. By resource name:
+          #            resource = "projects/123/locations/global/agents/456/flows/789"
+          #       3. By resource display name:
+          #            display_name = "my agent"
+          #       4. By action:
+          #            action = "Create"
+          #       5. By type:
+          #            type = "flows"
+          #       6. By create time. Currently predicates on `create_time` and
+          #          `create_time_epoch_seconds` are supported:
+          #            create_time_epoch_seconds > 1551790877 AND create_time <=
+          #            2017-01-15T01:30:15.01Z
+          #       7. Combination of above filters:
+          #            resource = "projects/123/locations/global/agents/456/flows/789"
+          #              AND user_email = "someone@google.com"
+          #              AND create_time <= 2017-01-15T01:30:15.01Z
+          # @!attribute [rw] page_size
+          #   @return [::Integer]
+          #     The maximum number of items to return in a single page. By default 100 and
+          #     at most 1000.
+          # @!attribute [rw] page_token
+          #   @return [::String]
+          #     The next_page_token value returned from a previous list request.
+          class ListChangelogsRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The response message for {::Google::Cloud::Dialogflow::CX::V3::Changelogs::Client#list_changelogs Changelogs.ListChangelogs}.
+          # @!attribute [rw] changelogs
+          #   @return [::Array<::Google::Cloud::Dialogflow::CX::V3::Changelog>]
+          #     The list of changelogs. There will be a maximum number of items returned
+          #     based on the page_size field in the request. The changelogs will be ordered
+          #     by timestamp.
+          # @!attribute [rw] next_page_token
+          #   @return [::String]
+          #     Token to retrieve the next page of results, or empty if there are no more
+          #     results in the list.
+          class ListChangelogsResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The request message for {::Google::Cloud::Dialogflow::CX::V3::Changelogs::Client#get_changelog Changelogs.GetChangelog}.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The name of the changelog to get.
+          #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+          #     ID>/changelogs/<Changelog ID>`.
+          class GetChangelogRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Changelogs represents a change made to a given agent.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     The unique identifier of the changelog.
+          #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+          #     ID>/changelogs/<Changelog ID>`.
+          # @!attribute [rw] user_email
+          #   @return [::String]
+          #     Email address of the authenticated user.
+          # @!attribute [rw] display_name
+          #   @return [::String]
+          #     The affected resource display name of the change.
+          # @!attribute [rw] action
+          #   @return [::String]
+          #     The action of the change.
+          # @!attribute [rw] type
+          #   @return [::String]
+          #     The affected resource type.
+          # @!attribute [rw] resource
+          #   @return [::String]
+          #     The affected resource name of the change.
+          # @!attribute [rw] create_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The timestamp of the change.
+          class Changelog
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/dialogflow/cx/v3/deployment.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Dialogflow
+      module CX
+        module V3
+          # Represents an deployment in an environment. A deployment happens when a flow
+          # version configured to be active in the environment. You can configure running
+          # pre-deployment steps, e.g. running validation test cases, experiment
+          # auto-rollout, etc.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     The name of the deployment.
+          #     Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent
+          #     ID>/environments/<Environment ID>/deployments/<Deployment ID>.
+          # @!attribute [rw] flow_version
+          #   @return [::String]
+          #     The name of the flow version for this deployment.
+          #     Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent
+          #     ID>/flows/<Flow ID>/versions/<Verion ID>.
+          # @!attribute [rw] state
+          #   @return [::Google::Cloud::Dialogflow::CX::V3::Deployment::State]
+          #     The current state of the deployment.
+          # @!attribute [rw] result
+          #   @return [::Google::Cloud::Dialogflow::CX::V3::Deployment::Result]
+          #     Result of the deployment.
+          # @!attribute [rw] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Start time of this deployment.
+          # @!attribute [rw] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     End time of this deployment.
+          class Deployment
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Result of the deployment.
+            # @!attribute [rw] deployment_test_results
+            #   @return [::Array<::String>]
+            #     Results of test cases running before the deployment.
+            #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+            #     ID>/testCases/<TestCase ID>/results/<TestCaseResult ID>`.
+            # @!attribute [rw] experiment
+            #   @return [::String]
+            #     The name of the experiment triggered by this deployment.
+            #     Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent
+            #     ID>/environments/<Environment ID>/experiments/<Experiment ID>.
+            class Result
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # The state of the deployment.
+            module State
+              # State unspecified.
+              STATE_UNSPECIFIED = 0
+
+              # The deployment is running.
+              RUNNING = 1
+
+              # The deployment succeeded.
+              SUCCEEDED = 2
+
+              # The deployment failed.
+              FAILED = 3
+            end
+          end
+
+          # The request message for {::Google::Cloud::Dialogflow::CX::V3::Deployments::Client#list_deployments Deployments.ListDeployments}.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The {::Google::Cloud::Dialogflow::CX::V3::Environment Environment} to list all environments for.
+          #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+          #     ID>/environments/<Environment ID>`.
+          # @!attribute [rw] page_size
+          #   @return [::Integer]
+          #     The maximum number of items to return in a single page. By default 20 and
+          #     at most 100.
+          # @!attribute [rw] page_token
+          #   @return [::String]
+          #     The next_page_token value returned from a previous list request.
+          class ListDeploymentsRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The response message for {::Google::Cloud::Dialogflow::CX::V3::Deployments::Client#list_deployments Deployments.ListDeployments}.
+          # @!attribute [rw] deployments
+          #   @return [::Array<::Google::Cloud::Dialogflow::CX::V3::Deployment>]
+          #     The list of deployments. There will be a maximum number of items
+          #     returned based on the page_size field in the request. The list may in some
+          #     cases be empty or contain fewer entries than page_size even if this isn't
+          #     the last page.
+          # @!attribute [rw] next_page_token
+          #   @return [::String]
+          #     Token to retrieve the next page of results, or empty if there are no more
+          #     results in the list.
+          class ListDeploymentsResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The request message for {::Google::Cloud::Dialogflow::CX::V3::Deployments::Client#get_deployment Deployments.GetDeployment}.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The name of the {::Google::Cloud::Dialogflow::CX::V3::Deployment Deployment}.
+          #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+          #     ID>/environments/<Environment ID>/deployments/<Deployment ID>`.
+          class GetDeploymentRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/dialogflow/cx/v3/environment.rb

@@ -52,6 +52,9 @@ module Google
           # @!attribute [r] update_time
           #   @return [::Google::Protobuf::Timestamp]
           #     Output only. Update time of this environment.
+          # @!attribute [rw] test_cases_config
+          #   @return [::Google::Cloud::Dialogflow::CX::V3::Environment::TestCasesConfig]
+          #     The test cases config for continuous tests of this environment.
           class Environment
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -65,6 +68,25 @@ module Google
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
+
+            # The configuration for continuous tests.
+            # @!attribute [rw] test_cases
+            #   @return [::Array<::String>]
+            #     A list of test case names to run. They should be under the same agent.
+            #     Format of each test case name: `projects/<Project ID>/locations/
+            #     <Location ID>/agents/<AgentID>/testCases/<TestCase ID>`
+            # @!attribute [rw] enable_continuous_run
+            #   @return [::Boolean]
+            #     Whether to run test cases in {::Google::Cloud::Dialogflow::CX::V3::Environment::TestCasesConfig#test_cases TestCasesConfig.test_cases} periodically.
+            #     Default false. If set to ture, run once a day.
+            # @!attribute [rw] enable_predeployment_run
+            #   @return [::Boolean]
+            #     Whether to run test cases in {::Google::Cloud::Dialogflow::CX::V3::Environment::TestCasesConfig#test_cases TestCasesConfig.test_cases} before
+            #     deploying a flow version to the environment. Default false.
+            class TestCasesConfig
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
 
           # The request message for {::Google::Cloud::Dialogflow::CX::V3::Environments::Client#list_environments Environments.ListEnvironments}.
@@ -272,6 +294,46 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # The request message for {::Google::Cloud::Dialogflow::CX::V3::Environments::Client#deploy_flow Environments.DeployFlow}.
+          # @!attribute [rw] environment
+          #   @return [::String]
+          #     Required. The environment to deploy the flow to.
+          #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/
+          #     environments/<Environment ID>`.
+          # @!attribute [rw] flow_version
+          #   @return [::String]
+          #     Required. The flow version to deploy.
+          #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/
+          #     flows/<Flow ID>/versions/<Version ID>`.
+          class DeployFlowRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The response message for {::Google::Cloud::Dialogflow::CX::V3::Environments::Client#deploy_flow Environments.DeployFlow}.
+          # @!attribute [rw] environment
+          #   @return [::Google::Cloud::Dialogflow::CX::V3::Environment]
+          #     The updated environment where the flow is deployed.
+          # @!attribute [rw] deployment
+          #   @return [::String]
+          #     The name of the flow version {::Google::Cloud::Dialogflow::CX::V3::Deployment Deployment}.
+          #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/
+          #     environments/<Environment ID>/deployments/<Deployment ID>`.
+          class DeployFlowResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Metadata returned for the {::Google::Cloud::Dialogflow::CX::V3::Environments::Client#deploy_flow Environments.DeployFlow} long running
+          # operation.
+          # @!attribute [rw] test_errors
+          #   @return [::Array<::Google::Cloud::Dialogflow::CX::V3::TestError>]
+          #     Errors of running deployment tests.
+          class DeployFlowMetadata
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end

data/proto_docs/google/cloud/dialogflow/cx/v3/response_message.rb

@@ -76,6 +76,10 @@ module Google
           #     {::Google::Cloud::Dialogflow::CX::V3::ResponseMessage#play_audio play_audio}.
           #     This message is generated by Dialogflow only and not supposed to be
           #     defined by the user.
+          # @!attribute [rw] telephony_transfer_call
+          #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::TelephonyTransferCall]
+          #     A signal that the client should transfer the phone call connected to
+          #     this agent to a third-party endpoint.
           class ResponseMessage
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +216,17 @@ module Google
                 extend ::Google::Protobuf::MessageExts::ClassMethods
               end
             end
+
+            # Represents the signal that telles the client to transfer the phone call
+            # connected to the agent to a third-party endpoint.
+            # @!attribute [rw] phone_number
+            #   @return [::String]
+            #     Transfer the call to a phone number
+            #     in [E.164 format](https://en.wikipedia.org/wiki/E.164).
+            class TelephonyTransferCall
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
         end
       end

data/proto_docs/google/cloud/dialogflow/cx/v3/security_settings.rb

@@ -106,7 +106,10 @@ module Google
           # propagate to all the related components and take effect.
           # @!attribute [rw] name
           #   @return [::String]
-          #     Required. Resource name of the settings.
+          #     Resource name of the settings.
+          #     Required for the {::Google::Cloud::Dialogflow::CX::V3::SecuritySettingsService::Client#update_security_settings SecuritySettingsService.UpdateSecuritySettings} method.
+          #     {::Google::Cloud::Dialogflow::CX::V3::SecuritySettingsService::Client#create_security_settings SecuritySettingsService.CreateSecuritySettings} populates the name
+          #     automatically.
           #     Format: `projects/<Project ID>/locations/<Location
           #     ID>/securitySettings/<Security Settings ID>`.
           # @!attribute [rw] display_name
@@ -126,6 +129,11 @@ module Google
           #     [DLP](https://cloud.google.com/dlp/docs) inspect template name. Use this
           #     template to define inspect base settings.
           #
+          #     The `DLP Inspect Templates Reader` role is needed on the Dialogflow
+          #     service identity service account (has the form
+          #     `service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com`)
+          #     for your agent's project.
+          #
           #     If empty, we use the default DLP inspect config.
           #
           #     The template name will have one of the following formats:
@@ -140,6 +148,11 @@ module Google
           #     [DLP](https://cloud.google.com/dlp/docs) deidentify template name. Use this
           #     template to define de-identification configuration for the content.
           #
+          #     The `DLP De-identify Templates Reader` role is needed on the Dialogflow
+          #     service identity service account (has the form
+          #     `service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com`)
+          #     for your agent's project.
+          #
           #     If empty, Dialogflow replaces sensitive info with `[redacted]` text.
           #
           #     The template name will have one of the following formats:
@@ -154,7 +167,7 @@ module Google
           #     Retains data in interaction logging for the specified number of days.
           #     This does not apply to Cloud logging, which is owned by the user - not
           #     Dialogflow.
-          #     User must Set a value lower than Dialogflow's default 30d TTL. Setting a
+          #     User must set a value lower than Dialogflow's default 365d TTL. Setting a
           #     value higher than that has no effect.
           #     A missing value or setting to 0 also means we use Dialogflow's default
           #     TTL.