docs: clarified the behavior of language_code in EventInput in the context of a followup event input

Google APIs · copybara-github · commit 5556688216b2 · 2022-03-07T09:23:04.000-08:00
docs: clarified wording around Cloud Storage usage
docs: added a new resource name pattern for ConversationModel

PiperOrigin-RevId: 432962774
diff --git a/google/cloud/dialogflow/v2/agent.proto b/google/cloud/dialogflow/v2/agent.proto
@@ -461,6 +461,12 @@ message ExportAgentRequest {
   // URI to export the agent to.
   // The format of this URI must be `gs://<bucket-name>/<object-name>`.
   // If left unspecified, the serialized agent is returned inline.
+  //
+  // Dialogflow performs a write operation for the Cloud Storage object
+  // on the caller's behalf, so your request authentication must
+  // have write permissions for the object. For more information, see
+  // [Dialogflow access
+  // control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
   string agent_uri = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
@@ -492,6 +498,12 @@ message ImportAgentRequest {
   oneof agent {
     // The URI to a Google Cloud Storage file containing the agent to import.
     // Note: The URI must start with "gs://".
+    //
+    // Dialogflow performs a read operation for the Cloud Storage object
+    // on the caller's behalf, so your request authentication must
+    // have read permissions for the object. For more information, see
+    // [Dialogflow access
+    // control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
     string agent_uri = 2;
 
     // Zip compressed raw byte content for agent.
@@ -514,6 +526,12 @@ message RestoreAgentRequest {
   oneof agent {
     // The URI to a Google Cloud Storage file containing the agent to restore.
     // Note: The URI must start with "gs://".
+    //
+    // Dialogflow performs a read operation for the Cloud Storage object
+    // on the caller's behalf, so your request authentication must
+    // have read permissions for the object. For more information, see
+    // [Dialogflow access
+    // control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
     string agent_uri = 2;
 
     // Zip compressed raw byte content for agent.
diff --git a/google/cloud/dialogflow/v2/conversation_model.proto b/google/cloud/dialogflow/v2/conversation_model.proto
@@ -201,8 +201,8 @@ service ConversationModels {
 message ConversationModel {
   option (google.api.resource) = {
     type: "dialogflow.googleapis.com/ConversationModel"
-    pattern: "projects/{project}/conversationModels/{conversation_model}"
     pattern: "projects/{project}/locations/{location}/conversationModels/{conversation_model}"
+    pattern: "projects/{project}/conversationModels/{conversation_model}"
   };
 
   // State of the model.
diff --git a/google/cloud/dialogflow/v2/session.proto b/google/cloud/dialogflow/v2/session.proto
@@ -652,6 +652,11 @@ message EventInput {
   // Support](https://cloud.google.com/dialogflow/docs/reference/language)
   // for a list of the currently supported language codes. Note that queries in
   // the same session do not necessarily need to specify the same language.
+  //
+  // This field is ignored when used in the context of a
+  // [WebhookResponse.followup_event_input][google.cloud.dialogflow.v2.WebhookResponse.followup_event_input] field,
+  // because the language was already defined in the originating detect
+  // intent request.
   string language_code = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
