From 4c984f3be8e1bd85eb8fe78a2911a83b9785a7ea Mon Sep 17 00:00:00 2001
From: Google APIs <noreply@google.com>
Date: Tue, 10 Aug 2021 09:35:17 -0700
Subject: [PATCH] feat: expose `Locations` service to get/list avaliable
 locations of Dialogflow products; fixed some API annotations

PiperOrigin-RevId: 389905442
---
 google/cloud/dialogflow/v2/dialogflow_v2.yaml | 24 +++++++++++++++++++
 google/cloud/dialogflow/v2/intent.proto       |  7 +++---
 2 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/google/cloud/dialogflow/v2/dialogflow_v2.yaml b/google/cloud/dialogflow/v2/dialogflow_v2.yaml
index 16531a89abf3c..2ae0b04879445 100644
--- a/google/cloud/dialogflow/v2/dialogflow_v2.yaml
+++ b/google/cloud/dialogflow/v2/dialogflow_v2.yaml
@@ -50,6 +50,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:
@@ -91,11 +97,19 @@ backend:
     deadline: 220.0
   - selector: 'google.cloud.dialogflow.v2.Versions.*'
     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: '/v2/{name=projects/*/locations/*}'
+  - selector: google.cloud.location.Locations.ListLocations
+    get: '/v2/{name=projects/*}/locations'
   - selector: google.longrunning.Operations.CancelOperation
     post: '/v2/{name=projects/*/operations/*}:cancel'
     additional_bindings:
@@ -201,6 +215,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/v2/intent.proto b/google/cloud/dialogflow/v2/intent.proto
index fae280cee3067..0c6b0deac878c 100644
--- a/google/cloud/dialogflow/v2/intent.proto
+++ b/google/cloud/dialogflow/v2/intent.proto
@@ -873,12 +873,13 @@ message Intent {
   // copied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).
   repeated Message.Platform default_response_platforms = 15 [(google.api.field_behavior) = OPTIONAL];
 
+  // Output only.
   // Read-only. The unique identifier of the root intent in the chain of
   // followup intents. It identifies the correct followup intents chain for
   // this intent. We populate this field only in the output.
   //
   // Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
-  string root_followup_intent_name = 16;
+  string root_followup_intent_name = 16 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Read-only after creation. The unique identifier of the parent intent in the
   // chain of followup intents. You can set this field when creating an intent,
@@ -890,9 +891,9 @@ message Intent {
   // Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
   string parent_followup_intent_name = 17;
 
-  // Read-only. Information about all followup intents that have this intent as
+  // Output only. Read-only. Information about all followup intents that have this intent as
   // a direct or indirect parent. We populate this field only in the output.
-  repeated FollowupIntentInfo followup_intent_info = 18;
+  repeated FollowupIntentInfo followup_intent_info = 18 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // The request message for [Intents.ListIntents][google.cloud.dialogflow.v2.Intents.ListIntents].