suguo
/
googleapis
0
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

feat: added Telephony Gateway DTMF events 

doc: added locations in resource name formats
doc: wording updates for tiers

PiperOrigin-RevId: 331627223
This commit is contained in:
Google APIs 2020-09-14 14:16:43 -07:00 committed by Copybara-Service
parent ba5a928ab8
commit 791be5a400
10 changed files with 410 additions and 152 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
google/cloud/dialogflow/v2beta1/agent.proto
View File

@ -194,6 +194,9 @@ service Agents {
rpc GetValidationResult(GetValidationResultRequest) returns (ValidationResult) {
option (google.api.http) = {
get: "/v2beta1/{parent=projects/*}/agent/validationResult"
additional_bindings {
get: "/v2beta1/{parent=projects/*/locations/*}/agent/validationResult"
}
};
}
}
@ -259,7 +262,8 @@ message Agent {
}
// Required. The project of this agent.
// Format: `projects/<Project ID>`.
// Format: `projects/<Project ID>` or
// `projects/<Project ID>/locations/<Location ID>`
string parent = 1;
// Required. The name of this agent.
@ -320,7 +324,8 @@ message Agent {
// The request message for [Agents.GetAgent][google.cloud.dialogflow.v2beta1.Agents.GetAgent].
message GetAgentRequest {
// Required. The project that the agent to fetch is associated with.
// Format: `projects/<Project ID>`.
// Format: `projects/<Project ID>` or
// `projects/<Project ID>/locations/<Location ID>`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -341,7 +346,8 @@ message SetAgentRequest {
// The request message for [Agents.DeleteAgent][google.cloud.dialogflow.v2beta1.Agents.DeleteAgent].
message DeleteAgentRequest {
// Required. The project that the agent to delete is associated with.
// Format: `projects/<Project ID>`.
// Format: `projects/<Project ID>` or
// `projects/<Project ID>/locations/<Location ID>`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -353,7 +359,8 @@ message DeleteAgentRequest {
// Contains basic configuration for a sub-agent.
message SubAgent {
// Required. The project of this agent.
// Format: `projects/<Project ID>`.
// Format: `projects/<Project ID>` or
// `projects/<Project ID>/locations/<Location ID>`.
string project = 1;
// Optional. The unique identifier (`environment name` in dialogflow console)
@ -365,7 +372,8 @@ message SubAgent {
// The request message for [Agents.SearchAgents][google.cloud.dialogflow.v2beta1.Agents.SearchAgents].
message SearchAgentsRequest {
// Required. The project to list agents from.
// Format: `projects/<Project ID or '-'>`.
// Format: `projects/<Project ID or '-'>` or
// `projects/<Project ID or '-'>/locations/<Location ID>`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -395,7 +403,8 @@ message SearchAgentsResponse {
// The request message for [Agents.TrainAgent][google.cloud.dialogflow.v2beta1.Agents.TrainAgent].
message TrainAgentRequest {
// Required. The project that the agent to train is associated with.
// Format: `projects/<Project ID>`.
// Format: `projects/<Project ID>` or
// `projects/<Project ID>/locations/<Location ID>`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -407,7 +416,8 @@ message TrainAgentRequest {
// The request message for [Agents.ExportAgent][google.cloud.dialogflow.v2beta1.Agents.ExportAgent].
message ExportAgentRequest {
// Required. The project that the agent to export is associated with.
// Format: `projects/<Project ID>`.
// Format: `projects/<Project ID>` or
// `projects/<Project ID>/locations/<Location ID>`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -439,7 +449,8 @@ message ExportAgentResponse {
// The request message for [Agents.ImportAgent][google.cloud.dialogflow.v2beta1.Agents.ImportAgent].
message ImportAgentRequest {
// Required. The project that the agent to import is associated with.
// Format: `projects/<Project ID>`.
// Format: `projects/<Project ID>` or
// `projects/<Project ID>/locations/<Location ID>`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -461,7 +472,8 @@ message ImportAgentRequest {
// The request message for [Agents.RestoreAgent][google.cloud.dialogflow.v2beta1.Agents.RestoreAgent].
message RestoreAgentRequest {
// Required. The project that the agent to restore is associated with.
// Format: `projects/<Project ID>`.
// Format: `projects/<Project ID>` or
// `projects/<Project ID>/locations/<Location ID>`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -483,7 +495,8 @@ message RestoreAgentRequest {
// The request message for [Agents.GetValidationResult][google.cloud.dialogflow.v2beta1.Agents.GetValidationResult].
message GetValidationResultRequest {
// Required. The project that the agent is associated with.
// Format: `projects/<Project ID>`.
// Format: `projects/<Project ID>` or
// `projects/<Project ID>/locations/<Location ID>`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {

121
google/cloud/dialogflow/v2beta1/audio_config.proto
View File

@ -30,36 +30,6 @@ option java_outer_classname = "AudioConfigProto";
option java_package = "com.google.cloud.dialogflow.v2beta1";
option objc_class_prefix = "DF";
// Hints for the speech recognizer to help with recognition in a specific
// conversation state.
message SpeechContext {
// Optional. A list of strings containing words and phrases that the speech
// recognizer should recognize with higher likelihood.
//
// This list can be used to:
//
// * improve accuracy for words and phrases you expect the user to say,
// e.g. typical commands for your Dialogflow agent
// * add additional words to the speech recognizer vocabulary
// * ...
//
// See the [Cloud Speech
// documentation](https://cloud.google.com/speech-to-text/quotas) for usage
// limits.
repeated string phrases = 1;
// Optional. Boost for this context compared to other contexts:
//
// * If the boost is positive, Dialogflow will increase the probability that
// the phrases in this context are recognized over similar sounding phrases.
// * If the boost is unspecified or non-positive, Dialogflow will not apply
// any boost.
//
// Dialogflow recommends that you use boosts in the range (0, 20] and that you
// find a value that fits your use case with binary search.
float boost = 2;
}
// Audio encoding of the audio content sent in the conversational query request.
// Refer to the
// [Cloud Speech API
@ -109,6 +79,36 @@ enum AudioEncoding {
AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE = 7;
}
// Hints for the speech recognizer to help with recognition in a specific
// conversation state.
message SpeechContext {
// Optional. A list of strings containing words and phrases that the speech
// recognizer should recognize with higher likelihood.
//
// This list can be used to:
//
// * improve accuracy for words and phrases you expect the user to say,
// e.g. typical commands for your Dialogflow agent
// * add additional words to the speech recognizer vocabulary
// * ...
//
// See the [Cloud Speech
// documentation](https://cloud.google.com/speech-to-text/quotas) for usage
// limits.
repeated string phrases = 1;
// Optional. Boost for this context compared to other contexts:
//
// * If the boost is positive, Dialogflow will increase the probability that
// the phrases in this context are recognized over similar sounding phrases.
// * If the boost is unspecified or non-positive, Dialogflow will not apply
// any boost.
//
// Dialogflow recommends that you use boosts in the range (0, 20] and that you
// find a value that fits your use case with binary search.
float boost = 2;
}
// Information for a word recognized by the speech recognizer.
message SpeechWordInfo {
// The word this info is for.
@ -350,3 +350,64 @@ enum OutputAudioEncoding {
// than MP3 while using approximately the same bitrate.
OUTPUT_AUDIO_ENCODING_OGG_OPUS = 3;
}
// A wrapper of repeated TelephonyDtmf digits.
message TelephonyDtmfEvents {
// A sequence of TelephonyDtmf digits.
repeated TelephonyDtmf dtmf_events = 1;
}
// [DTMF](https://en.wikipedia.org/wiki/Dual-tone_multi-frequency_signaling)
// digit in Telephony Gateway.
enum TelephonyDtmf {
// Not specified. This value may be used to indicate an absent digit.
TELEPHONY_DTMF_UNSPECIFIED = 0;
// Number: '1'.
DTMF_ONE = 1;
// Number: '2'.
DTMF_TWO = 2;
// Number: '3'.
DTMF_THREE = 3;
// Number: '4'.
DTMF_FOUR = 4;
// Number: '5'.
DTMF_FIVE = 5;
// Number: '6'.
DTMF_SIX = 6;
// Number: '7'.
DTMF_SEVEN = 7;
// Number: '8'.
DTMF_EIGHT = 8;
// Number: '9'.
DTMF_NINE = 9;
// Number: '0'.
DTMF_ZERO = 10;
// Letter: 'A'.
DTMF_A = 11;
// Letter: 'B'.
DTMF_B = 12;
// Letter: 'C'.
DTMF_C = 13;
// Letter: 'D'.
DTMF_D = 14;
// Asterisk/star: '*'.
DTMF_STAR = 15;
// Pound/diamond/hash/square/gate/octothorpe: '#'.
DTMF_POUND = 16;
}

110
google/cloud/dialogflow/v2beta1/context.proto
View File

@ -176,10 +176,16 @@ message Context {
pattern: "projects/{project}/locations/{location}/agent/sessions/{session}/contexts/{context}"
};
// Required. The unique identifier of the context. Format:
// `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
// or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>/contexts/<Context ID>`.
// Required. The unique identifier of the context. Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context
// ID>`,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>/contexts/<Context ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>/contexts/<Context ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>/contexts/<Context ID>`,
//
// The `Context ID` is always converted to lowercase, may only contain
// characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
@ -221,12 +227,19 @@ message Context {
// The request message for [Contexts.ListContexts][google.cloud.dialogflow.v2beta1.Contexts.ListContexts].
message ListContextsRequest {
// Required. The session to list all contexts from.
// Format: `projects/<Project ID>/agent/sessions/<Session ID>` or
// `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`. If `Environment ID` is not specified, we assume
// default 'draft' environment. If `User ID` is not specified, we assume
// default '-' user.
// Required. The session to list all contexts from. Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>`,
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we assume default '-' user.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -255,12 +268,20 @@ message ListContextsResponse {
// The request message for [Contexts.GetContext][google.cloud.dialogflow.v2beta1.Contexts.GetContext].
message GetContextRequest {
// Required. The name of the context. Format:
// `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`
// or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>/contexts/<Context ID>`. If `Environment ID` is
// not specified, we assume default 'draft' environment. If `User ID` is not
// specified, we assume default '-' user.
// Required. The name of the context. Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context
// ID>`,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>/contexts/<Context ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>/contexts/<Context ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>/contexts/<Context ID>`,
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we assume default '-' user.
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -271,12 +292,19 @@ message GetContextRequest {
// The request message for [Contexts.CreateContext][google.cloud.dialogflow.v2beta1.Contexts.CreateContext].
message CreateContextRequest {
// Required. The session to create a context for.
// Format: `projects/<Project ID>/agent/sessions/<Session ID>` or
// `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`. If `Environment ID` is not specified, we assume
// default 'draft' environment. If `User ID` is not specified, we assume
// default '-' user.
// Required. The session to create a context for. Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>`,
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we assume default '-' user.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -299,12 +327,20 @@ message UpdateContextRequest {
// The request message for [Contexts.DeleteContext][google.cloud.dialogflow.v2beta1.Contexts.DeleteContext].
message DeleteContextRequest {
// Required. The name of the context to delete. Format:
// `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`
// or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>/contexts/<Context ID>`. If `Environment ID` is
// not specified, we assume default 'draft' environment. If `User ID` is not
// specified, we assume default '-' user.
// Required. The name of the context to delete. Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context
// ID>`,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>/contexts/<Context ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>/contexts/<Context ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>/contexts/<Context ID>`,
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we assume default '-' user.
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -315,11 +351,19 @@ message DeleteContextRequest {
// The request message for [Contexts.DeleteAllContexts][google.cloud.dialogflow.v2beta1.Contexts.DeleteAllContexts].
message DeleteAllContextsRequest {
// Required. The name of the session to delete all contexts from. Format:
// `projects/<Project ID>/agent/sessions/<Session ID>` or `projects/<Project
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>`. If `Environment ID` is not specified we assume default 'draft'
// environment. If `User ID` is not specified, we assume default '-' user.
// Required. The name of the session to delete all contexts from. Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>`,
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified we assume default 'draft' environment. If
// `User ID` is not specified, we assume default '-' user.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {

27
google/cloud/dialogflow/v2beta1/dialogflow_grpc_service_config.json
View File

@ -2,6 +2,30 @@
"methodConfig": [
{
"name": [
{
"service": "google.cloud.dialogflow.aam.v2beta1.AamDatasets"
},
{
"service": "google.cloud.dialogflow.aam.v2beta1.AamDiscriminants"
},
{
"service": "google.cloud.dialogflow.aam.v2beta1.AamDiscriminantChanges"
},
{
"service": "google.cloud.dialogflow.aam.v2beta1.AamLabels"
},
{
"service": "google.cloud.dialogflow.aam.v2beta1.AamTasks"
},
{
"service": "google.cloud.dialogflow.aam.v2beta1.AamTrainingRuns"
},
{
"service": "google.cloud.dialogflow.aam.v2beta1.AamTranscripts"
},
{
"service": "google.cloud.dialogflow.aam.v2beta1.AamUtterances"
},
{
"service": "google.cloud.dialogflow.v2beta1.Agents"
},
@ -80,6 +104,9 @@
{
"service": "google.cloud.dialogflow.v2beta1.Versions"
},
{
"service": "google.cloud.dialogflow.v2beta1.InternalDatasetService"
},
{
"service": "google.cloud.dialogflow.v2beta1.AogService"
},

52
google/cloud/dialogflow/v2beta1/entity_type.proto
View File

@ -280,7 +280,10 @@ message EntityType {
// The unique identifier of the entity type.
// Required for [EntityTypes.UpdateEntityType][google.cloud.dialogflow.v2beta1.EntityTypes.UpdateEntityType] and
// [EntityTypes.BatchUpdateEntityTypes][google.cloud.dialogflow.v2beta1.EntityTypes.BatchUpdateEntityTypes] methods.
// Format: `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`.
// Supported formats:
// - `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/entityTypes/<Entity
// Type ID>`
string name = 1;
// Required. The name of the entity type.
@ -303,7 +306,9 @@ message EntityType {
// The request message for [EntityTypes.ListEntityTypes][google.cloud.dialogflow.v2beta1.EntityTypes.ListEntityTypes].
message ListEntityTypesRequest {
// Required. The agent to list all entity types from.
// Format: `projects/<Project ID>/agent`.
// Supported formats:
// - `projects/<Project ID>/agent`
// - `projects/<Project ID>/locations/<Location ID>/agent`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -340,7 +345,10 @@ message ListEntityTypesResponse {
// The request message for [EntityTypes.GetEntityType][google.cloud.dialogflow.v2beta1.EntityTypes.GetEntityType].
message GetEntityTypeRequest {
// Required. The name of the entity type.
// Format: `projects/<Project ID>/agent/entityTypes/<EntityType ID>`.
// Supported formats:
// - `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/entityTypes/<Entity
// Type ID>`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -359,7 +367,9 @@ message GetEntityTypeRequest {
// The request message for [EntityTypes.CreateEntityType][google.cloud.dialogflow.v2beta1.EntityTypes.CreateEntityType].
message CreateEntityTypeRequest {
// Required. The agent to create a entity type for.
// Format: `projects/<Project ID>/agent`.
// Supported formats:
// - `projects/<Project ID>/agent`
// - `projects/<Project ID>/locations/<Location ID>/agent`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -397,7 +407,10 @@ message UpdateEntityTypeRequest {
// The request message for [EntityTypes.DeleteEntityType][google.cloud.dialogflow.v2beta1.EntityTypes.DeleteEntityType].
message DeleteEntityTypeRequest {
// Required. The name of the entity type to delete.
// Format: `projects/<Project ID>/agent/entityTypes/<EntityType ID>`.
// Supported formats:
// - `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/entityTypes/<Entity
// Type ID>`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -409,7 +422,9 @@ message DeleteEntityTypeRequest {
// The request message for [EntityTypes.BatchUpdateEntityTypes][google.cloud.dialogflow.v2beta1.EntityTypes.BatchUpdateEntityTypes].
message BatchUpdateEntityTypesRequest {
// Required. The name of the agent to update or create entity types in.
// Format: `projects/<Project ID>/agent`.
// Supported formats:
// - `projects/<Project ID>/agent`
// - `projects/<Project ID>/locations/<Location ID>/agent`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -453,8 +468,10 @@ message BatchUpdateEntityTypesResponse {
// The request message for [EntityTypes.BatchDeleteEntityTypes][google.cloud.dialogflow.v2beta1.EntityTypes.BatchDeleteEntityTypes].
message BatchDeleteEntityTypesRequest {
// Required. The name of the agent to delete all entities types for. Format:
// `projects/<Project ID>/agent`.
// Required. The name of the agent to delete all entities types for.
// Supported formats:
// - `projects/<Project ID>/agent`,
// - `projects/<Project ID>/locations/<Location ID>/agent`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -469,8 +486,11 @@ message BatchDeleteEntityTypesRequest {
// The request message for [EntityTypes.BatchCreateEntities][google.cloud.dialogflow.v2beta1.EntityTypes.BatchCreateEntities].
message BatchCreateEntitiesRequest {
// Required. The name of the entity type to create entities in. Format:
// `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`.
// Required. The name of the entity type to create entities in.
// Supported formats:
// - `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/entityTypes/<Entity
// Type ID>`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -492,7 +512,10 @@ message BatchCreateEntitiesRequest {
// The request message for [EntityTypes.BatchUpdateEntities][google.cloud.dialogflow.v2beta1.EntityTypes.BatchUpdateEntities].
message BatchUpdateEntitiesRequest {
// Required. The name of the entity type to update or create entities in.
// Format: `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`.
// Supported formats:
// - `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/entityTypes/<Entity
// Type ID>`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -516,8 +539,11 @@ message BatchUpdateEntitiesRequest {
// The request message for [EntityTypes.BatchDeleteEntities][google.cloud.dialogflow.v2beta1.EntityTypes.BatchDeleteEntities].
message BatchDeleteEntitiesRequest {
// Required. The name of the entity type to delete entries for. Format:
// `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`.
// Required. The name of the entity type to delete entries for.
// Supported formats:
// - `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/entityTypes/<Entity
// Type ID>`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {

12
google/cloud/dialogflow/v2beta1/environment.proto
View File

@ -97,10 +97,10 @@ message Environment {
}
// Output only. The unique identifier of this agent environment.
// Format:
// Supported formats:
// - `projects/<Project Number / ID>/agent/environments/<Environment ID>`
// - `projects/<Project Number / ID>/locations/<Location
// ID>/agent/environments/<Environment ID>`
// ID>/agent/environments/<Environment ID>`
string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Optional. The developer-provided description for this environment.
@ -108,7 +108,10 @@ message Environment {
string description = 2 [(google.api.field_behavior) = OPTIONAL];
// Optional. The agent version loaded into this environment.
// Format: `projects/<Project ID>/agent/versions/<Version ID>`.
// Supported formats:
// - `projects/<Project ID>/agent/versions/<Version ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version
// ID>`
string agent_version = 3 [(google.api.field_behavior) = OPTIONAL];
// Output only. The state of this environment. This field is read-only, i.e., it cannot be
@ -125,8 +128,7 @@ message ListEnvironmentsRequest {
// Required. The agent to list all environments from.
// Format:
// - `projects/<Project Number / ID>/agent`
// - `projects/<Project Number / ID>/locations/<Location
// ID>/agent
// - `projects/<Project Number / ID>/locations/<Location ID>/agent`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {

39
google/cloud/dialogflow/v2beta1/intent.proto
View File

@ -1064,7 +1064,10 @@ message Intent {
// Optional. The unique identifier of this intent.
// Required for [Intents.UpdateIntent][google.cloud.dialogflow.v2beta1.Intents.UpdateIntent] and [Intents.BatchUpdateIntents][google.cloud.dialogflow.v2beta1.Intents.BatchUpdateIntents]
// methods.
// Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
// Supported formats:
//
// - `projects/<Project ID>/agent/intents/<Intent ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/intents/<Intent ID>`
string name = 1 [(google.api.field_behavior) = OPTIONAL];
// Required. The name of this intent.
@ -1093,6 +1096,7 @@ message Intent {
// DEPRECATED! Please use `ml_disabled` field instead.
// NOTE: If both `ml_enabled` and `ml_disabled` are either not set or false,
// then the default value is determined as follows:
//
// - Before April 15th, 2018 the default is:
// ml_enabled = false / ml_disabled = true.
// - After April 15th, 2018 the default is:
@ -1115,7 +1119,11 @@ message Intent {
// Optional. The list of context names required for this intent to be
// triggered.
// Format: `projects/<Project ID>/agent/sessions/-/contexts/<Context ID>`.
// Formats:
//
// - `projects/<Project ID>/agent/sessions/-/contexts/<Context ID>`
// - `projects/<Project ID>/locations/<Location
// ID>/agent/sessions/-/contexts/<Context ID>`
repeated string input_context_names = 7 [(google.api.field_behavior) = OPTIONAL];
// Optional. The collection of event names that trigger the intent.
@ -1219,7 +1227,10 @@ message ListIntentsResponse {
// The request message for [Intents.GetIntent][google.cloud.dialogflow.v2beta1.Intents.GetIntent].
message GetIntentRequest {
// Required. The name of the intent.
// Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
// Supported formats:
//
// - `projects/<Project ID>/agent/intents/<Intent ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/intents/<Intent ID>`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -1241,7 +1252,10 @@ message GetIntentRequest {
// The request message for [Intents.CreateIntent][google.cloud.dialogflow.v2beta1.Intents.CreateIntent].
message CreateIntentRequest {
// Required. The agent to create a intent for.
// Format: `projects/<Project ID>/agent`.
// Supported formats:
//
// - `projects/<Project ID>/agent`
// - `projects/<Project ID>/locations/<Location ID>/agent`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -1287,7 +1301,10 @@ message DeleteIntentRequest {
// Required. The name of the intent to delete. If this intent has direct or
// indirect followup intents, we also delete them.
//
// Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
// Supported formats:
//
// - `projects/<Project ID>/agent/intents/<Intent ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/intents/<Intent ID>`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -1299,7 +1316,10 @@ message DeleteIntentRequest {
// The request message for [Intents.BatchUpdateIntents][google.cloud.dialogflow.v2beta1.Intents.BatchUpdateIntents].
message BatchUpdateIntentsRequest {
// Required. The name of the agent to update or create intents in.
// Format: `projects/<Project ID>/agent`.
// Supported formats:
//
// - `projects/<Project ID>/agent`
// - `projects/<Project ID>/locations/<Location ID>/agent`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -1345,8 +1365,11 @@ message BatchUpdateIntentsResponse {
// The request message for [Intents.BatchDeleteIntents][google.cloud.dialogflow.v2beta1.Intents.BatchDeleteIntents].
message BatchDeleteIntentsRequest {
// Required. The name of the agent to delete all entities types for. Format:
// `projects/<Project ID>/agent`.
// Required. The name of the agent to delete all entities types for.
// Supported formats:
//
// - `projects/<Project ID>/agent`
// - `projects/<Project ID>/locations/<Location ID>/agent`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {

54
google/cloud/dialogflow/v2beta1/session.proto
View File

@ -88,16 +88,22 @@ service Sessions {
// The request to detect user's intent.
message DetectIntentRequest {
// Required. The name of the session this query is sent to. Format:
// `projects/<Project ID>/agent/sessions/<Session ID>`, or
// `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`. If `Environment ID` is not specified, we assume
// default 'draft' environment. If `User ID` is not specified, we are using
// "-". It's up to the API caller to choose an appropriate `Session ID` and
// `User Id`. They can be a random number or some type of user and session
// identifiers (preferably hashed). The length of the `Session ID` and
// `User ID` must not exceed 36 characters.
// Required. The name of the session this query is sent to. Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>`,
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we are using "-". It's up to the API caller
// to choose an appropriate `Session ID` and `User Id`. They can be a random
// number or some type of user and session identifiers (preferably hashed).
// The length of the `Session ID` and `User ID` must not exceed 36 characters.
// For more information, see the [API interactions
// guide](https://cloud.google.com/dialogflow/docs/api-overview).
string session = 1 [
@ -216,7 +222,7 @@ message QueryParameters {
// Configures the type of sentiment analysis to perform. If not
// provided, sentiment analysis is not performed.
// Note: Sentiment Analysis is only currently available for Enterprise Edition
// Note: Sentiment Analysis is only currently available for Essentials Edition
// agents.
SentimentAnalysisRequestConfig sentiment_analysis_request_config = 10;
@ -461,15 +467,22 @@ message KnowledgeAnswers {
// After you sent all input, you must half-close or abort the request stream.
message StreamingDetectIntentRequest {
// Required. The name of the session the query is sent to.
// Format of the session name:
// `projects/<Project ID>/agent/sessions/<Session ID>`, or
// `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`. If `Environment ID` is not specified, we assume
// default 'draft' environment. If `User ID` is not specified, we are using
// "-". It's up to the API caller to choose an appropriate `Session ID` and
// `User Id`. They can be a random number or some type of user and session
// identifiers (preferably hashed). The length of the `Session ID` and
// `User ID` must not exceed 36 characters.
// Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>`,
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we are using "-". It's up to the API caller
// to choose an appropriate `Session ID` and `User Id`. They can be a random
// number or some type of user and session identifiers (preferably hashed).
// The length of the `Session ID` and `User ID` must not exceed 36 characters.
//
// For more information, see the [API interactions
// guide](https://cloud.google.com/dialogflow/docs/api-overview).
@ -668,6 +681,9 @@ message StreamingRecognitionResult {
// Time offset of the end of this Speech recognition result relative to the
// beginning of the audio. Only populated for `message_type` = `TRANSCRIPT`.
google.protobuf.Duration speech_end_offset = 8;
// DTMF digits. Populated if and only if `message_type` = `DTMF_DIGITS`.
TelephonyDtmfEvents dtmf_digits = 5;
}
// Represents the natural language text to be processed.

98
google/cloud/dialogflow/v2beta1/session_entity_type.proto
View File

@ -194,14 +194,21 @@ message SessionEntityType {
ENTITY_OVERRIDE_MODE_SUPPLEMENT = 2;
}
// Required. The unique identifier of this session entity type. Format:
// `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type
// Display Name>`, or
// `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`.
// If `Environment ID` is not specified, we assume default 'draft'
// environment. If `User ID` is not specified, we assume default '-' user.
// Required. The unique identifier of this session entity type. Supported
// formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity
// Type Display Name>`
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>/entityTypes/<Entity Type Display Name>`
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`
// - `projects/<Project ID>/locations/<Location ID>/agent/environments/
// <Environment ID>/users/<User ID>/sessions/<Session
// ID>/entityTypes/<Entity Type Display Name>`
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we assume default '-' user.
// `<Entity Type Display Name>` must be the display name of an existing entity
// type in the same agent that will be overridden or supplemented.
string name = 1;
@ -218,11 +225,19 @@ message SessionEntityType {
// The request message for [SessionEntityTypes.ListSessionEntityTypes][google.cloud.dialogflow.v2beta1.SessionEntityTypes.ListSessionEntityTypes].
message ListSessionEntityTypesRequest {
// Required. The session to list all session entity types from.
// Format: `projects/<Project ID>/agent/sessions/<Session ID>` or
// `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/
// sessions/<Session ID>`.
// If `Environment ID` is not specified, we assume default 'draft'
// environment. If `User ID` is not specified, we assume default '-' user.
// Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>`,
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we assume default '-' user.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -251,12 +266,20 @@ message ListSessionEntityTypesResponse {
// The request message for [SessionEntityTypes.GetSessionEntityType][google.cloud.dialogflow.v2beta1.SessionEntityTypes.GetSessionEntityType].
message GetSessionEntityTypeRequest {
// Required. The name of the session entity type. Format:
// `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type
// Display Name>` or `projects/<Project ID>/agent/environments/<Environment
// ID>/users/<User ID>/sessions/<Session ID>/entityTypes/<Entity Type Display
// Name>`. If `Environment ID` is not specified, we assume default 'draft'
// environment. If `User ID` is not specified, we assume default '-' user.
// Required. The name of the session entity type. Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity
// Type Display Name>`
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>/entityTypes/<Entity Type Display Name>`
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`
// - `projects/<Project ID>/locations/<Location ID>/agent/environments/
// <Environment ID>/users/<User ID>/sessions/<Session
// ID>/entityTypes/<Entity Type Display Name>`
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we assume default '-' user.
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -268,11 +291,19 @@ message GetSessionEntityTypeRequest {
// The request message for [SessionEntityTypes.CreateSessionEntityType][google.cloud.dialogflow.v2beta1.SessionEntityTypes.CreateSessionEntityType].
message CreateSessionEntityTypeRequest {
// Required. The session to create a session entity type for.
// Format: `projects/<Project ID>/agent/sessions/<Session ID>` or
// `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/
// sessions/<Session ID>`. If `Environment ID` is not specified, we assume
// default 'draft' environment. If `User ID` is not specified, we assume
// default '-' user.
// Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>`,
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we assume default '-' user.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -295,12 +326,21 @@ message UpdateSessionEntityTypeRequest {
// The request message for [SessionEntityTypes.DeleteSessionEntityType][google.cloud.dialogflow.v2beta1.SessionEntityTypes.DeleteSessionEntityType].
message DeleteSessionEntityTypeRequest {
// Required. The name of the entity type to delete. Format:
// `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type
// Display Name>` or `projects/<Project ID>/agent/environments/<Environment
// ID>/users/<User ID>/sessions/<Session ID>/entityTypes/<Entity Type Display
// Name>`. If `Environment ID` is not specified, we assume default 'draft'
// environment. If `User ID` is not specified, we assume default '-' user.
// Required. The name of the entity type to delete.
// Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity
// Type Display Name>`
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>/entityTypes/<Entity Type Display Name>`
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`
// - `projects/<Project ID>/locations/<Location ID>/agent/environments/
// <Environment ID>/users/<User ID>/sessions/<Session
// ID>/entityTypes/<Entity Type Display Name>`
//
// If `Location ID` is not specified we assume default 'us' location. If
// `Environment ID` is not specified, we assume default 'draft' environment.
// If `User ID` is not specified, we assume default '-' user.
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {

16
google/cloud/dialogflow/v2beta1/webhook.proto
View File

@ -35,9 +35,15 @@ option objc_class_prefix = "DF";
message WebhookRequest {
// The unique identifier of detectIntent request session.
// Can be used to identify end-user inside webhook implementation.
// Format: `projects/<Project ID>/agent/sessions/<Session ID>`, or
// `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`.
// Supported formats:
// - `projects/<Project ID>/agent/sessions/<Session ID>,
// - `projects/<Project ID>/locations/<Location ID>/agent/sessions/<Session
// ID>`,
// - `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
// ID>/sessions/<Session ID>`,
// - `projects/<Project ID>/locations/<Location
// ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session
// ID>`,
string session = 4;
// The unique identifier of the response. Contains the same value as
@ -146,8 +152,8 @@ message OriginalDetectIntentRequest {
// "caller_id": "+18558363987"
// }
// }</pre>
// Note: The caller ID field (`caller_id`) will be redacted for Standard
// Note: The caller ID field (`caller_id`) will be redacted for Trial
// Edition agents and populated with the caller ID in [E.164
// format](https://en.wikipedia.org/wiki/E.164) for Enterprise Edition agents.
// format](https://en.wikipedia.org/wiki/E.164) for Essentials Edition agents.
google.protobuf.Struct payload = 3;
}