Skip to content

Commit

Permalink
fix: add missing resource annotations and additional_bindings (#591)
Browse files Browse the repository at this point in the history
  • Loading branch information
yoshi-automation authored Apr 14, 2020
1 parent c3fe6b1 commit f5a6217
Show file tree
Hide file tree
Showing 46 changed files with 21,286 additions and 30,433 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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:
Expand Down Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.
Expand All @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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;
}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand All @@ -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/*}"
Expand All @@ -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
Expand All @@ -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"
Expand All @@ -138,6 +138,10 @@ service Documents {
body: "*"
}
};
option (google.longrunning.operation_info) = {
response_type: "Document"
metadata_type: "KnowledgeOperationMetadata"
};
}
}

Expand Down Expand Up @@ -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;
}
}
Loading

0 comments on commit f5a6217

Please sign in to comment.