google-cloud-dialogflow-cx-v3 0.2.0 → 0.5.0

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

@@ -129,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:
@@ -143,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:
@@ -157,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.

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

@@ -112,7 +112,7 @@ module Google
           # Multiple request messages should be sent in order:
           #
           # 1.  The first message must contain
-          # {::Google::Cloud::Dialogflow::CX::V3::StreamingDetectIntentRequest#session session},
+          #     {::Google::Cloud::Dialogflow::CX::V3::StreamingDetectIntentRequest#session session},
           #     {::Google::Cloud::Dialogflow::CX::V3::StreamingDetectIntentRequest#query_input query_input} plus optionally
           #     {::Google::Cloud::Dialogflow::CX::V3::StreamingDetectIntentRequest#query_params query_params}. If the client
           #     wants to receive an audio response, it should also contain
@@ -173,21 +173,29 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # The top-level message returned from the `StreamingDetectIntent` method.
+          # The top-level message returned from the
+          # {::Google::Cloud::Dialogflow::CX::V3::Sessions::Client#streaming_detect_intent StreamingDetectIntent} method.
           #
-          # Multiple response messages can be returned in order:
+          # Multiple response messages (N) can be returned in order.
           #
-          # 1.  If the input was set to streaming audio, the first one or more messages
-          #     contain `recognition_result`. Each `recognition_result` represents a more
-          #     complete transcript of what the user said. The last `recognition_result`
-          #     has `is_final` set to `true`.
+          # The first (N-1) responses set either the `recognition_result` or
+          # `detect_intent_response` field, depending on the request:
           #
-          # 2.  If `enable_partial_response` is true, the following N messages
-          #     (currently 1 <= N <= 4) contain `detect_intent_response`. The first (N-1)
-          #     `detect_intent_response`s will have `response_type` set to `PARTIAL`.
-          #     The last `detect_intent_response` has `response_type` set to `FINAL`.
-          #     If `response_type` is false, response stream only contains
-          #     the final `detect_intent_response`.
+          # *   If the `StreamingDetectIntentRequest.query_input.audio` field was
+          #     set, and the `StreamingDetectIntentRequest.enable_partial_response`
+          #     field was false, the `recognition_result` field is populated for each
+          #     of the (N-1) responses.
+          #     See the {::Google::Cloud::Dialogflow::CX::V3::StreamingRecognitionResult StreamingRecognitionResult} message for details
+          #     about the result message sequence.
+          #
+          # *   If the `StreamingDetectIntentRequest.enable_partial_response` field was
+          #     true, the `detect_intent_response` field is populated for each
+          #     of the (N-1) responses, where 1 <= N <= 4.
+          #     These responses set the {::Google::Cloud::Dialogflow::CX::V3::DetectIntentResponse#response_type DetectIntentResponse.response_type} field
+          #     to `PARTIAL`.
+          #
+          # For the final Nth response message, the `detect_intent_response` is fully
+          # populated, and {::Google::Cloud::Dialogflow::CX::V3::DetectIntentResponse#response_type DetectIntentResponse.response_type} is set to `FINAL`.
           # @!attribute [rw] recognition_result
           #   @return [::Google::Cloud::Dialogflow::CX::V3::StreamingRecognitionResult]
           #     The result of speech recognition.
@@ -203,35 +211,39 @@ module Google
           # that is currently being processed or an indication that this is the end
           # of the single requested utterance.
           #
-          # Example:
-          #
-          # 1.  transcript: "tube"
-          #
-          # 2.  transcript: "to be a"
-          #
-          # 3.  transcript: "to be"
-          #
-          # 4.  transcript: "to be or not to be"
-          #     is_final: true
-          #
-          # 5.  transcript: " that's"
-          #
-          # 6.  transcript: " that is"
-          #
-          # 7.  message_type: `END_OF_SINGLE_UTTERANCE`
-          #
-          # 8.  transcript: " that is the question"
-          #     is_final: true
-          #
-          # Only two of the responses contain final results (#4 and #8 indicated by
-          # `is_final: true`). Concatenating these generates the full transcript: "to be
-          # or not to be that is the question".
-          #
-          # In each response we populate:
-          #
-          # *  for `TRANSCRIPT`: `transcript` and possibly `is_final`.
-          #
-          # *  for `END_OF_SINGLE_UTTERANCE`: only `message_type`.
+          # While end-user audio is being processed, Dialogflow sends a series of
+          # results. Each result may contain a `transcript` value. A transcript
+          # represents a portion of the utterance. While the recognizer is processing
+          # audio, transcript values may be interim values or finalized values.
+          # Once a transcript is finalized, the `is_final` value is set to true and
+          # processing continues for the next transcript.
+          #
+          # If `StreamingDetectIntentRequest.query_input.audio.config.single_utterance`
+          # was true, and the recognizer has completed processing audio,
+          # the `message_type` value is set to `END_OF_SINGLE_UTTERANCE and the
+          # following (last) result contains the last finalized transcript.
+          #
+          # The complete end-user utterance is determined by concatenating the
+          # finalized transcript values received for the series of results.
+          #
+          # In the following example, single utterance is enabled. In the case where
+          # single utterance is not enabled, result 7 would not occur.
+          #
+          # ```
+          # Num | transcript              | message_type            | is_final
+          # --- | ----------------------- | ----------------------- | --------
+          # 1   | "tube"                  | TRANSCRIPT              | false
+          # 2   | "to be a"               | TRANSCRIPT              | false
+          # 3   | "to be"                 | TRANSCRIPT              | false
+          # 4   | "to be or not to be"    | TRANSCRIPT              | true
+          # 5   | "that's"                | TRANSCRIPT              | false
+          # 6   | "that is                | TRANSCRIPT              | false
+          # 7   | unset                   | END_OF_SINGLE_UTTERANCE | unset
+          # 8   | " that is the question" | TRANSCRIPT              | true
+          # ```
+          #
+          # Concatenating the finalized transcripts with `is_final` set to true,
+          # the complete utterance becomes "to be or not to be that is the question".
           # @!attribute [rw] message_type
           #   @return [::Google::Cloud::Dialogflow::CX::V3::StreamingRecognitionResult::MessageType]
           #     Type of the result message.

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

@@ -175,6 +175,49 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # The request message for {::Google::Cloud::Dialogflow::CX::V3::Versions::Client#compare_versions Versions.CompareVersions}.
+          # @!attribute [rw] base_version
+          #   @return [::String]
+          #     Required. Name of the base flow version to compare with the target version. Use
+          #     version ID `0` to indicate the draft version of the specified flow.
+          #
+          #     Format: `projects/<Project ID>/locations/<Location ID>/agents/
+          #     <Agent ID>/flows/<Flow ID>/versions/<Version ID>`.
+          # @!attribute [rw] target_version
+          #   @return [::String]
+          #     Required. Name of the target flow version to compare with the
+          #     base version. Use version ID `0` to indicate the draft version of the
+          #     specified flow. Format: `projects/<Project ID>/locations/<Location
+          #     ID>/agents/<Agent ID>/flows/<Flow ID>/versions/<Version ID>`.
+          # @!attribute [rw] language_code
+          #   @return [::String]
+          #     The language to compare the flow versions for.
+          #
+          #     If not specified, the agent's default language is used.
+          #     [Many
+          #     languages](https://cloud.google.com/dialogflow/docs/reference/language) are
+          #     supported. Note: languages must be enabled in the agent before they can be
+          #     used.
+          class CompareVersionsRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The response message for {::Google::Cloud::Dialogflow::CX::V3::Versions::Client#compare_versions Versions.CompareVersions}.
+          # @!attribute [rw] base_version_content_json
+          #   @return [::String]
+          #     JSON representation of the base version content.
+          # @!attribute [rw] target_version_content_json
+          #   @return [::String]
+          #     JSON representation of the target version content.
+          # @!attribute [rw] compare_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The timestamp when the two version compares.
+          class CompareVersionsResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end

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

@@ -69,6 +69,19 @@ module Google
             #   @return [::Google::Protobuf::Map{::String => ::String}]
             #     The HTTP request headers to send together with webhook
             #     requests.
+            # @!attribute [rw] allowed_ca_certs
+            #   @return [::Array<::String>]
+            #     Optional. Specifies a list of allowed custom CA certificates (in DER format) for
+            #     HTTPS verification. This overrides the default SSL trust store. If this
+            #     is empty or unspecified, Dialogflow will use Google's default trust store
+            #     to verify certificates.
+            #     N.B. Make sure the HTTPS server certificates are signed with "subject alt
+            #     name". For instance a certificate can be self-signed using the following
+            #     command,
+            #        openssl x509 -req -days 200 -in example.com.csr \
+            #          -signkey example.com.key \
+            #          -out example.com.crt \
+            #          -extfile <(printf "\nsubjectAltName='DNS:www.example.com'")
             class GenericWebService
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -386,6 +399,10 @@ module Google
           #     The unique identifier of the current page.
           #     Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
           #     ID>/flows/<Flow ID>/pages/<Page ID>`.
+          # @!attribute [rw] display_name
+          #   @return [::String]
+          #     Always present for {::Google::Cloud::Dialogflow::CX::V3::WebhookRequest WebhookRequest}. Ignored for {::Google::Cloud::Dialogflow::CX::V3::WebhookResponse WebhookResponse}.
+          #     The display name of the current page.
           # @!attribute [rw] form_info
           #   @return [::Google::Cloud::Dialogflow::CX::V3::PageInfo::FormInfo]
           #     Optional for both {::Google::Cloud::Dialogflow::CX::V3::WebhookRequest WebhookRequest} and {::Google::Cloud::Dialogflow::CX::V3::WebhookResponse WebhookResponse}.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-dialogflow-cx-v3
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-18 00:00:00.000000000 Z
+date: 2022-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -185,6 +185,12 @@ files:
 - lib/google/cloud/dialogflow/cx/v3/agents/operations.rb
 - lib/google/cloud/dialogflow/cx/v3/agents/paths.rb
 - lib/google/cloud/dialogflow/cx/v3/audio_config_pb.rb
+- lib/google/cloud/dialogflow/cx/v3/changelog_pb.rb
+- lib/google/cloud/dialogflow/cx/v3/changelog_services_pb.rb
+- lib/google/cloud/dialogflow/cx/v3/changelogs.rb
+- lib/google/cloud/dialogflow/cx/v3/changelogs/client.rb
+- lib/google/cloud/dialogflow/cx/v3/changelogs/credentials.rb
+- lib/google/cloud/dialogflow/cx/v3/changelogs/paths.rb
 - lib/google/cloud/dialogflow/cx/v3/deployment_pb.rb
 - lib/google/cloud/dialogflow/cx/v3/deployment_services_pb.rb
 - lib/google/cloud/dialogflow/cx/v3/deployments.rb
@@ -283,6 +289,7 @@ files:
 - proto_docs/google/cloud/dialogflow/cx/v3/advanced_settings.rb
 - proto_docs/google/cloud/dialogflow/cx/v3/agent.rb
 - proto_docs/google/cloud/dialogflow/cx/v3/audio_config.rb
+- proto_docs/google/cloud/dialogflow/cx/v3/changelog.rb
 - proto_docs/google/cloud/dialogflow/cx/v3/deployment.rb
 - proto_docs/google/cloud/dialogflow/cx/v3/entity_type.rb
 - proto_docs/google/cloud/dialogflow/cx/v3/environment.rb
@@ -328,7 +335,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.4
 signing_key: 
 specification_version: 4
 summary: API Client library for the Dialogflow CX V3 API