fix: add missing resource annotations and additional_bindings (#591)

Author: yoshi-automation

packages/google-cloud-dialogflow/protos/google/cloud/dialogflow/v2/agent.proto

@@ -328,8 +328,6 @@ message DeleteAgentRequest {
   ];
 }
 
-// ============================================================================
-// Requests and responses for custom methods.
 // The request message for [Agents.SearchAgents][google.cloud.dialogflow.v2.Agents.SearchAgents].
 message SearchAgentsRequest {
   // Required. The project to list agents from.

packages/google-cloud-dialogflow/protos/google/cloud/dialogflow/v2/context.proto

@@ -172,7 +172,7 @@ message Context {
   // -   MapKey value: parameter name
   // -   MapValue type:
   //     -   If parameter's entity type is a composite entity: map
-  //     -   Else: string
+  //     -   Else: string or number, depending on parameter value type
   // -   MapValue value:
   //     -   If parameter's entity type is a composite entity:
   //         map from composite entity property names to property values

packages/google-cloud-dialogflow/protos/google/cloud/dialogflow/v2/session.proto

@@ -76,7 +76,6 @@ service Sessions {
   }
 }
 
-// Requests and responses for custom methods.
 // The request to detect user's intent.
 message DetectIntentRequest {
   // Required. The name of the session this query is sent to. Format:
@@ -244,6 +243,20 @@ message QueryResult {
   string action = 3;
 
   // The collection of extracted parameters.
+  //
+  // Depending on your protocol or client library language, this is a
+  // map, associative array, symbol table, dictionary, or JSON object
+  // composed of a collection of (MapKey, MapValue) pairs:
+  //
+  // -   MapKey type: string
+  // -   MapKey value: parameter name
+  // -   MapValue type:
+  //     -   If parameter's entity type is a composite entity: map
+  //     -   Else: string or number, depending on parameter value type
+  // -   MapValue value:
+  //     -   If parameter's entity type is a composite entity:
+  //         map from composite entity property names to property values
+  //     -   Else: parameter value
   google.protobuf.Struct parameters = 4;
 
   // This field is set to:
@@ -539,6 +552,20 @@ message EventInput {
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The collection of parameters associated with the event.
+  //
+  // Depending on your protocol or client library language, this is a
+  // map, associative array, symbol table, dictionary, or JSON object
+  // composed of a collection of (MapKey, MapValue) pairs:
+  //
+  // -   MapKey type: string
+  // -   MapKey value: parameter name
+  // -   MapValue type:
+  //     -   If parameter's entity type is a composite entity: map
+  //     -   Else: string or number, depending on parameter value type
+  // -   MapValue value:
+  //     -   If parameter's entity type is a composite entity:
+  //         map from composite entity property names to property values
+  //     -   Else: parameter value
   google.protobuf.Struct parameters = 2;
 
   // Required. The language of this query. See [Language

packages/google-cloud-dialogflow/protos/google/cloud/dialogflow/v2beta1/audio_config.proto

@@ -194,13 +194,13 @@ message InputAudioConfig {
   // the same session do not necessarily need to specify the same language.
   string language_code = 3;
 
-  // Optional. If `true`, Dialogflow returns [SpeechWordInfo][google.cloud.dialogflow.v2beta1.SpeechWordInfo] in
+  // If `true`, Dialogflow returns [SpeechWordInfo][google.cloud.dialogflow.v2beta1.SpeechWordInfo] in
   // [StreamingRecognitionResult][google.cloud.dialogflow.v2beta1.StreamingRecognitionResult] with information about the recognized speech
   // words, e.g. start and end time offsets. If false or unspecified, Speech
   // doesn't return any word-level information.
   bool enable_word_info = 13;
 
-  // Optional. A list of strings containing words and phrases that the speech
+  // A list of strings containing words and phrases that the speech
   // recognizer should recognize with higher likelihood.
   //
   // See [the Cloud Speech
@@ -210,19 +210,16 @@ message InputAudioConfig {
   // This field is deprecated. Please use [speech_contexts]() instead. If you
   // specify both [phrase_hints]() and [speech_contexts](), Dialogflow will
   // treat the [phrase_hints]() as a single additional [SpeechContext]().
-  repeated string phrase_hints = 4 [
-    deprecated = true,
-    (google.api.field_behavior) = OPTIONAL
-  ];
+  repeated string phrase_hints = 4 [deprecated = true];
 
-  // Optional. Context information to assist speech recognition.
+  // Context information to assist speech recognition.
   //
   // See [the Cloud Speech
   // documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints)
   // for more details.
   repeated SpeechContext speech_contexts = 11;
 
-  // Optional. Which Speech model to select for the given request. Select the
+  // Which Speech model to select for the given request. Select the
   // model best suited to your domain to get best results. If a model is not
   // explicitly specified, then we auto-select a model based on the parameters
   // in the InputAudioConfig.
@@ -235,10 +232,10 @@ message InputAudioConfig {
   // for more details.
   string model = 7;
 
-  // Optional. Which variant of the [Speech model][google.cloud.dialogflow.v2beta1.InputAudioConfig.model] to use.
+  // Which variant of the [Speech model][google.cloud.dialogflow.v2beta1.InputAudioConfig.model] to use.
   SpeechModelVariant model_variant = 10;
 
-  // Optional. If `false` (default), recognition does not cease until the
+  // If `false` (default), recognition does not cease until the
   // client closes the stream.
   // If `true`, the recognizer will detect a single spoken utterance in input
   // audio. Recognition ceases when it detects the audio's voice has

packages/google-cloud-dialogflow/protos/google/cloud/dialogflow/v2beta1/context.proto

@@ -183,15 +183,26 @@ message Context {
   string name = 1;
 
   // Optional. The number of conversational query requests after which the
-  // context expires. If set to `0` (the default) the context expires
+  // context expires. The default is `0`. If set to `0`, the context expires
   // immediately. Contexts expire automatically after 20 minutes if there
   // are no matching queries.
   int32 lifespan_count = 2;
 
   // Optional. The collection of parameters associated with this context.
-  // Refer to [this
-  // doc](https://cloud.google.com/dialogflow/docs/intents-actions-parameters)
-  // for syntax.
+  //
+  // Depending on your protocol or client library language, this is a
+  // map, associative array, symbol table, dictionary, or JSON object
+  // composed of a collection of (MapKey, MapValue) pairs:
+  //
+  // -   MapKey type: string
+  // -   MapKey value: parameter name
+  // -   MapValue type:
+  //     -   If parameter's entity type is a composite entity: map
+  //     -   Else: string or number, depending on parameter value type
+  // -   MapValue value:
+  //     -   If parameter's entity type is a composite entity:
+  //         map from composite entity property names to property values
+  //     -   Else: parameter value
   google.protobuf.Struct parameters = 3;
 }
 

packages/google-cloud-dialogflow/protos/google/cloud/dialogflow/v2beta1/document.proto

@@ -71,9 +71,6 @@ service Documents {
   //
   // Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
   // only use `projects.knowledgeBases.documents`.
-  //
-  // Operation <response: [Document][google.cloud.dialogflow.v2beta1.Document],
-  //            metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2beta1.KnowledgeOperationMetadata]>
   rpc CreateDocument(CreateDocumentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/knowledgeBases/*}/documents"
@@ -83,31 +80,33 @@ service Documents {
         body: "document"
       }
     };
+    option (google.longrunning.operation_info) = {
+      response_type: "Document"
+      metadata_type: "KnowledgeOperationMetadata"
+    };
   }
 
   // Deletes the specified document.
   //
   // Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
   // only use `projects.knowledgeBases.documents`.
-  //
-  // Operation <response: [google.protobuf.Empty][google.protobuf.Empty],
-  //            metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2beta1.KnowledgeOperationMetadata]>
   rpc DeleteDocument(DeleteDocumentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       delete: "/v2beta1/{name=projects/*/knowledgeBases/*/documents/*}"
       additional_bindings {
         delete: "/v2beta1/{name=projects/*/agent/knowledgeBases/*/documents/*}"
       }
     };
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "KnowledgeOperationMetadata"
+    };
   }
 
   // Updates the specified document.
   //
   // Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
   // only use `projects.knowledgeBases.documents`.
-  //
-  // Operation <response: [Document][google.cloud.dialogflow.v2beta1.Document],
-  //            metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2beta1.KnowledgeOperationMetadata]>
   rpc UpdateDocument(UpdateDocumentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       patch: "/v2beta1/{document.name=projects/*/knowledgeBases/*/documents/*}"
@@ -117,6 +116,10 @@ service Documents {
         body: "document"
       }
     };
+    option (google.longrunning.operation_info) = {
+      response_type: "Document"
+      metadata_type: "KnowledgeOperationMetadata"
+    };
   }
 
   // Reloads the specified document from its specified source, content_uri or
@@ -126,9 +129,6 @@ service Documents {
   //
   // Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
   // only use `projects.knowledgeBases.documents`.
-  //
-  // Operation <response: [Document][google.cloud.dialogflow.v2beta1.Document],
-  //            metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2beta1.KnowledgeOperationMetadata]>
   rpc ReloadDocument(ReloadDocumentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2beta1/{name=projects/*/knowledgeBases/*/documents/*}:reload"
@@ -138,6 +138,10 @@ service Documents {
         body: "*"
       }
     };
+    option (google.longrunning.operation_info) = {
+      response_type: "Document"
+      metadata_type: "KnowledgeOperationMetadata"
+    };
   }
 }
 
@@ -299,7 +303,8 @@ message ReloadDocumentRequest {
   // Optional. If provided, the service will load the contents from the source
   // and update document in the knowledge base.
   oneof source {
-    // The path of gcs source file for reloading document content.
+    // Optional. The path for a Cloud Storage source file for reloading document content.
+    // If not provided, the Document's existing source will be reloaded.
     GcsSource gcs_source = 3;
   }
 }