feat: added support for comparing between versions docs: clarified se…

…curity settings API reference (#201)

* feat: added support for comparing between versions docs: clarified security settings API reference

PiperOrigin-RevId: 407624272

Source-Link: googleapis/googleapis@eb773f2

Source-Link: googleapis/googleapis-gen@e69f86b
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZTY5Zjg2YjViYmMyZWQ3NzdhNWQ5N2I2NWMwODBjNDY0NWVhMDJiOCJ9

* 🦉 Updates from OwlBot

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* 🦉 Updates from OwlBot

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: nicain <nicain.seattle@gmail.com>

linkinator.config.json

@@ -6,5 +6,5 @@
     "img.shields.io"
   ],
   "silent": true,
-  "concurrency": 5
+  "concurrency": 10
 }

protos/google/cloud/dialogflow/cx/v3beta1/security_settings.proto

@@ -245,6 +245,11 @@ message SecuritySettings {
   // [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:
@@ -261,6 +266,11 @@ message SecuritySettings {
   // [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:
@@ -281,7 +291,7 @@ message SecuritySettings {
     // 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.

protos/google/cloud/dialogflow/cx/v3beta1/version.proto

@@ -121,6 +121,15 @@ service Versions {
       metadata_type: "google.protobuf.Struct"
     };
   }
+
+  // Compares the specified base version with target version.
+  rpc CompareVersions(CompareVersionsRequest) returns (CompareVersionsResponse) {
+    option (google.api.http) = {
+      post: "/v3beta1/{base_version=projects/*/locations/*/agents/*/flows/*/versions/*}:compareVersions"
+      body: "*"
+    };
+    option (google.api.method_signature) = "base_version";
+  }
 }
 
 // Metadata associated with the long running operation for
@@ -281,3 +290,50 @@ message LoadVersionRequest {
   // will not be overridden (i.e. intents, entities, webhooks).
   bool allow_override_agent_resources = 2;
 }
+
+// The request message for [Versions.CompareVersions][google.cloud.dialogflow.cx.v3beta1.Versions.CompareVersions].
+message CompareVersionsRequest {
+  // 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>`.
+  string base_version = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dialogflow.googleapis.com/Version"
+    }
+  ];
+
+  // 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>`.
+  string target_version = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dialogflow.googleapis.com/Version"
+    }
+  ];
+
+  // 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.
+  string language_code = 3;
+}
+
+// The response message for [Versions.CompareVersions][google.cloud.dialogflow.cx.v3beta1.Versions.CompareVersions].
+message CompareVersionsResponse {
+  // JSON representation of the base version content.
+  string base_version_content_json = 1;
+
+  // JSON representation of the target version content.
+  string target_version_content_json = 2;
+
+  // The timestamp when the two version compares.
+  google.protobuf.Timestamp compare_time = 3;
+}