feat: added support for DLP templates; expose Locations service to get/list avaliable locations of Dialogflow products

Google APIs · copybara-github · commit 626df528c5ae · 2021-08-10T11:48:32.000-07:00
PiperOrigin-RevId: 389939863
diff --git a/google/cloud/dialogflow/cx/v3/dialogflow_v3.yaml b/google/cloud/dialogflow/cx/v3/dialogflow_v3.yaml
@@ -57,6 +57,12 @@ documentation:
 
     For more information, see the
     [Dialogflow documentation](https://cloud.google.com/dialogflow/docs).
+  rules:
+  - selector: google.cloud.location.Locations.GetLocation
+    description: Gets information about a location.
+
+  - selector: google.cloud.location.Locations.ListLocations
+    description: Lists information about the supported locations for this service.
 
 backend:
   rules:
@@ -94,11 +100,19 @@ backend:
     deadline: 60.0
   - selector: 'google.cloud.dialogflow.cx.v3.Webhooks.*'
     deadline: 60.0
+  - selector: google.cloud.location.Locations.GetLocation
+    deadline: 60.0
+  - selector: google.cloud.location.Locations.ListLocations
+    deadline: 60.0
   - selector: 'google.longrunning.Operations.*'
     deadline: 60.0
 
 http:
   rules:
+  - selector: google.cloud.location.Locations.GetLocation
+    get: '/v3/{name=projects/*/locations/*}'
+  - selector: google.cloud.location.Locations.ListLocations
+    get: '/v3/{name=projects/*}/locations'
   - selector: google.longrunning.Operations.CancelOperation
     post: '/v3/{name=projects/*/operations/*}:cancel'
     additional_bindings:
@@ -184,6 +198,16 @@ authentication:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform,
         https://www.googleapis.com/auth/dialogflow
+  - selector: google.cloud.location.Locations.GetLocation
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/dialogflow
+  - selector: google.cloud.location.Locations.ListLocations
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/dialogflow
   - selector: 'google.longrunning.Operations.*'
     oauth:
       canonical_scopes: |-
diff --git a/google/cloud/dialogflow/cx/v3/security_settings.proto b/google/cloud/dialogflow/cx/v3/security_settings.proto
@@ -31,6 +31,16 @@ option java_multiple_files = true;
 option java_outer_classname = "SecuritySettingsProto";
 option java_package = "com.google.cloud.dialogflow.cx.v3";
 option objc_class_prefix = "DF";
+option (google.api.resource_definition) = {
+  type: "dlp.googleapis.com/InspectTemplate"
+  pattern: "organizations/{organization}/locations/{location}/inspectTemplates/{inspect_template}"
+  pattern: "projects/{project}/locations/{location}/inspectTemplates/{inspect_template}"
+};
+option (google.api.resource_definition) = {
+  type: "dlp.googleapis.com/DeidentifyTemplate"
+  pattern: "organizations/{organization}/locations/{location}/deidentifyTemplates/{deidentify_template}"
+  pattern: "projects/{project}/locations/{location}/deidentifyTemplates/{deidentify_template}"
+};
 
 // Service for managing security settings for Dialogflow.
 service SecuritySettingsService {
@@ -234,11 +244,31 @@ message SecuritySettings {
   // If empty, we use the default DLP inspect config.
   //
   // The template name will have one of the following formats:
-  // `projects/<Project ID>/inspectTemplates/<Template ID>` OR
   // `projects/<Project ID>/locations/<Location ID>/inspectTemplates/<Template
-  // ID>` OR
-  // `organizations/<Organization ID>/inspectTemplates/<Template ID>`
-  string inspect_template = 9;
+  // ID>` OR `organizations/<Organization ID>/locations/<Location
+  // ID>/inspectTemplates/<Template ID>`
+  //
+  // Note: `inspect_template` must be located in the same region as the
+  // `SecuritySettings`.
+  string inspect_template = 9 [(google.api.resource_reference) = {
+                                 type: "dlp.googleapis.com/InspectTemplate"
+                               }];
+
+  // [DLP](https://cloud.google.com/dlp/docs) deidentify template name. Use this
+  // template to define de-identification configuration for the content.
+  //
+  // If empty, Dialogflow replaces sensitive info with `[redacted]` text.
+  //
+  // The template name will have one of the following formats:
+  // `projects/<Project ID>/locations/<Location
+  // ID>/deidentifyTemplates/<Template ID>` OR `organizations/<Organization
+  // ID>/locations/<Location ID>/deidentifyTemplates/<Template ID>`
+  //
+  // Note: `deidentify_template` must be located in the same region as the
+  // `SecuritySettings`.
+  string deidentify_template = 17 [(google.api.resource_reference) = {
+                                     type: "dlp.googleapis.com/DeidentifyTemplate"
+                                   }];
 
   // Specifies how data is retained. Note that even if the data is
   // purged due to retention policy, we may still hold it in backup storage for
@@ -259,10 +289,10 @@ message SecuritySettings {
   // List of types of data to remove when retention settings triggers purge.
   repeated PurgeDataType purge_data_types = 8;
 
-  // Optional. Controls conversation exporting settings to Insights after conversation is
+  // Controls conversation exporting settings to Insights after conversation is
   // completed.
   //
   // If [retention_strategy][google.cloud.dialogflow.cx.v3.SecuritySettings.retention_strategy] is set to REMOVE_AFTER_CONVERSATION,
   // Insights export is disabled no matter what you configure here.
-  InsightsExportSettings insights_export_settings = 13 [(google.api.field_behavior) = OPTIONAL];
+  InsightsExportSettings insights_export_settings = 13;
 }
