Skip to content
This repository has been archived by the owner on Dec 3, 2023. It is now read-only.

Commit

Permalink
docs: clarified meaning of the legacy editions docs: clarified semant…
Browse files Browse the repository at this point in the history 
…ic of the streaming APIs (#753)

- [ ] Regenerate this pull request now.

PiperOrigin-RevId: 404815104

Source-Link: googleapis/googleapis@bb1f3e9

Source-Link: googleapis/googleapis-gen@79e2c39
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNzllMmMzOTA2NmYwNjE2YWEyZGQ2ZjA3YjAwNzVjZTNmYjA2M2I3OCJ9
  • Loading branch information
@gcf-owl-bot
gcf-owl-bot[bot] committed Oct 21, 2021
1 parent 094f18b commit df1d5e0
Show file tree
Hide file tree
Showing 7 changed files with 240 additions and 207 deletions.
21 changes: 12 additions & 9 deletions proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/Agent.java
View file
Expand Up @@ -571,7 +571,7 @@ public enum Tier implements com.google.protobuf.ProtocolMessageEnum {
*
*
* <pre>
* Standard tier.
* Trial Edition, previously known as Standard Edition.
* </pre>
*
* <code>TIER_STANDARD = 1;</code>
Expand All @@ -581,7 +581,7 @@ public enum Tier implements com.google.protobuf.ProtocolMessageEnum {
*
*
* <pre>
* Enterprise tier (Essentials).
* Essentials Edition, previously known as Enterprise Essential Edition.
* </pre>
*
* <code>TIER_ENTERPRISE = 2;</code>
Expand All @@ -591,11 +591,13 @@ public enum Tier implements com.google.protobuf.ProtocolMessageEnum {
*
*
* <pre>
* Enterprise tier (Plus).
* Essentials Edition (same as TIER_ENTERPRISE), previously known as
* Enterprise Plus Edition.
* </pre>
*
* <code>TIER_ENTERPRISE_PLUS = 3;</code>
* <code>TIER_ENTERPRISE_PLUS = 3 [deprecated = true];</code>
*/
@java.lang.Deprecated
TIER_ENTERPRISE_PLUS(3),
UNRECOGNIZED(-1),
;
Expand All @@ -614,7 +616,7 @@ public enum Tier implements com.google.protobuf.ProtocolMessageEnum {
*
*
* <pre>
* Standard tier.
* Trial Edition, previously known as Standard Edition.
* </pre>
*
* <code>TIER_STANDARD = 1;</code>
Expand All @@ -624,7 +626,7 @@ public enum Tier implements com.google.protobuf.ProtocolMessageEnum {
*
*
* <pre>
* Enterprise tier (Essentials).
* Essentials Edition, previously known as Enterprise Essential Edition.
* </pre>
*
* <code>TIER_ENTERPRISE = 2;</code>
Expand All @@ -634,12 +636,13 @@ public enum Tier implements com.google.protobuf.ProtocolMessageEnum {
*
*
* <pre>
* Enterprise tier (Plus).
* Essentials Edition (same as TIER_ENTERPRISE), previously known as
* Enterprise Plus Edition.
* </pre>
*
* <code>TIER_ENTERPRISE_PLUS = 3;</code>
* <code>TIER_ENTERPRISE_PLUS = 3 [deprecated = true];</code>
*/
public static final int TIER_ENTERPRISE_PLUS_VALUE = 3;
@java.lang.Deprecated public static final int TIER_ENTERPRISE_PLUS_VALUE = 3;

public final int getNumber() {
if (this == UNRECOGNIZED) {
Expand Down
188 changes: 94 additions & 94 deletions ...o-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/AgentProto.java
View file
Expand Up @@ -92,7 +92,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
+ "alogflow/v2/validation_result.proto\032#goo"
+ "gle/longrunning/operations.proto\032\033google"
+ "/protobuf/empty.proto\032 google/protobuf/f"
+ "ield_mask.proto\"\241\007\n\005Agent\022C\n\006parent\030\001 \001("
+ "ield_mask.proto\"\245\007\n\005Agent\022C\n\006parent\030\001 \001("
+ "\tB3\340A\002\372A-\n+cloudresourcemanager.googleap"
+ "is.com/Project\022\031\n\014display_name\030\002 \001(\tB\003\340A"
+ "\002\022\"\n\025default_language_code\030\003 \001(\tB\003\340A\002\022%\n"
Expand All @@ -110,101 +110,101 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
+ "BRID\020\001\022\026\n\022MATCH_MODE_ML_ONLY\020\002\"l\n\nApiVer"
+ "sion\022\033\n\027API_VERSION_UNSPECIFIED\020\000\022\022\n\016API"
+ "_VERSION_V1\020\001\022\022\n\016API_VERSION_V2\020\002\022\031\n\025API"
+ "_VERSION_V2_BETA_1\020\003\"^\n\004Tier\022\024\n\020TIER_UNS"
+ "_VERSION_V2_BETA_1\020\003\"b\n\004Tier\022\024\n\020TIER_UNS"
+ "PECIFIED\020\000\022\021\n\rTIER_STANDARD\020\001\022\023\n\017TIER_EN"
+ "TERPRISE\020\002\022\030\n\024TIER_ENTERPRISE_PLUS\020\003:m\352A"
+ "j\n\037dialogflow.googleapis.com/Agent\022\030proj"
+ "ects/{project}/agent\022-projects/{project}"
+ "/locations/{location}/agent\"J\n\017GetAgentR"
+ "equest\0227\n\006parent\030\001 \001(\tB\'\340A\002\372A!\022\037dialogfl"
+ "ow.googleapis.com/Agent\"~\n\017SetAgentReque"
+ "st\0225\n\005agent\030\001 \001(\0132!.google.cloud.dialogf"
+ "low.v2.AgentB\003\340A\002\0224\n\013update_mask\030\002 \001(\0132\032"
+ ".google.protobuf.FieldMaskB\003\340A\001\"M\n\022Delet"
+ "eAgentRequest\0227\n\006parent\030\001 \001(\tB\'\340A\002\372A!\022\037d"
+ "ialogflow.googleapis.com/Agent\"z\n\023Search"
+ "AgentsRequest\0227\n\006parent\030\001 \001(\tB\'\340A\002\372A!\022\037d"
+ "ialogflow.googleapis.com/Agent\022\026\n\tpage_s"
+ "ize\030\002 \001(\005B\003\340A\001\022\022\n\npage_token\030\003 \001(\t\"b\n\024Se"
+ "archAgentsResponse\0221\n\006agents\030\001 \003(\0132!.goo"
+ "gle.cloud.dialogflow.v2.Agent\022\027\n\017next_pa"
+ "ge_token\030\002 \001(\t\"L\n\021TrainAgentRequest\0227\n\006p"
+ "arent\030\001 \001(\tB\'\340A\002\372A!\022\037dialogflow.googleap"
+ "is.com/Agent\"e\n\022ExportAgentRequest\0227\n\006pa"
+ "rent\030\001 \001(\tB\'\340A\002\372A!\022\037dialogflow.googleapi"
+ "s.com/Agent\022\026\n\tagent_uri\030\002 \001(\tB\003\340A\002\"L\n\023E"
+ "xportAgentResponse\022\023\n\tagent_uri\030\001 \001(\tH\000\022"
+ "\027\n\ragent_content\030\002 \001(\014H\000B\007\n\005agent\"\204\001\n\022Im"
+ "portAgentRequest\0227\n\006parent\030\001 \001(\tB\'\340A\002\372A!"
+ "\022\037dialogflow.googleapis.com/Agent\022\023\n\tage"
+ "nt_uri\030\002 \001(\tH\000\022\027\n\ragent_content\030\003 \001(\014H\000B"
+ "\007\n\005agent\"\205\001\n\023RestoreAgentRequest\0227\n\006pare"
+ "nt\030\001 \001(\tB\'\340A\002\372A!\022\037dialogflow.googleapis."
+ "com/Agent\022\023\n\tagent_uri\030\002 \001(\tH\000\022\027\n\ragent_"
+ "content\030\003 \001(\014H\000B\007\n\005agent\"q\n\032GetValidatio"
+ "nResultRequest\0227\n\006parent\030\001 \001(\tB\'\340A\002\372A!\022\037"
+ "dialogflow.googleapis.com/Agent\022\032\n\rlangu"
+ "age_code\030\003 \001(\tB\003\340A\0012\252\021\n\006Agents\022\267\001\n\010GetAg"
+ "ent\022+.google.cloud.dialogflow.v2.GetAgen"
+ "tRequest\032!.google.cloud.dialogflow.v2.Ag"
+ "ent\"[\202\323\344\223\002L\022\035/v2/{parent=projects/*}/age"
+ "ntZ+\022)/v2/{parent=projects/*/locations/*"
+ "}/agent\332A\006parent\022\320\001\n\010SetAgent\022+.google.c"
+ "loud.dialogflow.v2.SetAgentRequest\032!.goo"
+ "gle.cloud.dialogflow.v2.Agent\"t\202\323\344\223\002f\"#/"
+ "v2/{agent.parent=projects/*}/agent:\005agen"
+ "tZ8\"//v2/{agent.parent=projects/*/locati"
+ "ons/*}/agent:\005agent\332A\005agent\022\262\001\n\013DeleteAg"
+ "ent\022..google.cloud.dialogflow.v2.DeleteA"
+ "gentRequest\032\026.google.protobuf.Empty\"[\202\323\344"
+ "\223\002L*\035/v2/{parent=projects/*}/agentZ+*)/v"
+ "2/{parent=projects/*/locations/*}/agent\332"
+ "A\006parent\022\334\001\n\014SearchAgents\022/.google.cloud"
+ ".dialogflow.v2.SearchAgentsRequest\0320.goo"
+ "gle.cloud.dialogflow.v2.SearchAgentsResp"
+ "onse\"i\202\323\344\223\002Z\022$/v2/{parent=projects/*}/ag"
+ "ent:searchZ2\0220/v2/{parent=projects/*/loc"
+ "ations/*}/agent:search\332A\006parent\022\374\001\n\nTrai"
+ "nAgent\022-.google.cloud.dialogflow.v2.Trai"
+ "nAgentRequest\032\035.google.longrunning.Opera"
+ "tion\"\237\001\202\323\344\223\002^\"#/v2/{parent=projects/*}/a"
+ "gent:train:\001*Z4\"//v2/{parent=projects/*/"
+ "locations/*}/agent:train:\001*\332A\006parent\312A/\n"
+ "\025google.protobuf.Empty\022\026google.protobuf."
+ "Struct\022\231\002\n\013ExportAgent\022..google.cloud.di"
+ "alogflow.v2.ExportAgentRequest\032\035.google."
+ "longrunning.Operation\"\272\001\202\323\344\223\002`\"$/v2/{par"
+ "ent=projects/*}/agent:export:\001*Z5\"0/v2/{"
+ "parent=projects/*/locations/*}/agent:exp"
+ "ort:\001*\332A\006parent\312AH\n.google.cloud.dialogf"
+ "low.v2.ExportAgentResponse\022\026google.proto"
+ "buf.Struct\022\367\001\n\013ImportAgent\022..google.clou"
+ "d.dialogflow.v2.ImportAgentRequest\032\035.goo"
+ "gle.longrunning.Operation\"\230\001\202\323\344\223\002`\"$/v2/"
+ "{parent=projects/*}/agent:import:\001*Z5\"0/"
+ "TERPRISE\020\002\022\034\n\024TIER_ENTERPRISE_PLUS\020\003\032\002\010\001"
+ ":m\352Aj\n\037dialogflow.googleapis.com/Agent\022\030"
+ "projects/{project}/agent\022-projects/{proj"
+ "ect}/locations/{location}/agent\"J\n\017GetAg"
+ "entRequest\0227\n\006parent\030\001 \001(\tB\'\340A\002\372A!\022\037dial"
+ "ogflow.googleapis.com/Agent\"~\n\017SetAgentR"
+ "equest\0225\n\005agent\030\001 \001(\0132!.google.cloud.dia"
+ "logflow.v2.AgentB\003\340A\002\0224\n\013update_mask\030\002 \001"
+ "(\0132\032.google.protobuf.FieldMaskB\003\340A\001\"M\n\022D"
+ "eleteAgentRequest\0227\n\006parent\030\001 \001(\tB\'\340A\002\372A"
+ "!\022\037dialogflow.googleapis.com/Agent\"z\n\023Se"
+ "archAgentsRequest\0227\n\006parent\030\001 \001(\tB\'\340A\002\372A"
+ "!\022\037dialogflow.googleapis.com/Agent\022\026\n\tpa"
+ "ge_size\030\002 \001(\005B\003\340A\001\022\022\n\npage_token\030\003 \001(\t\"b"
+ "\n\024SearchAgentsResponse\0221\n\006agents\030\001 \003(\0132!"
+ ".google.cloud.dialogflow.v2.Agent\022\027\n\017nex"
+ "t_page_token\030\002 \001(\t\"L\n\021TrainAgentRequest\022"
+ "7\n\006parent\030\001 \001(\tB\'\340A\002\372A!\022\037dialogflow.goog"
+ "leapis.com/Agent\"e\n\022ExportAgentRequest\0227"
+ "\n\006parent\030\001 \001(\tB\'\340A\002\372A!\022\037dialogflow.googl"
+ "eapis.com/Agent\022\026\n\tagent_uri\030\002 \001(\tB\003\340A\002\""
+ "L\n\023ExportAgentResponse\022\023\n\tagent_uri\030\001 \001("
+ "\tH\000\022\027\n\ragent_content\030\002 \001(\014H\000B\007\n\005agent\"\204\001"
+ "\n\022ImportAgentRequest\0227\n\006parent\030\001 \001(\tB\'\340A"
+ "\002\372A!\022\037dialogflow.googleapis.com/Agent\022\023\n"
+ "\tagent_uri\030\002 \001(\tH\000\022\027\n\ragent_content\030\003 \001("
+ "\014H\000B\007\n\005agent\"\205\001\n\023RestoreAgentRequest\0227\n\006"
+ "parent\030\001 \001(\tB\'\340A\002\372A!\022\037dialogflow.googlea"
+ "pis.com/Agent\022\023\n\tagent_uri\030\002 \001(\tH\000\022\027\n\rag"
+ "ent_content\030\003 \001(\014H\000B\007\n\005agent\"q\n\032GetValid"
+ "ationResultRequest\0227\n\006parent\030\001 \001(\tB\'\340A\002\372"
+ "A!\022\037dialogflow.googleapis.com/Agent\022\032\n\rl"
+ "anguage_code\030\003 \001(\tB\003\340A\0012\252\021\n\006Agents\022\267\001\n\010G"
+ "etAgent\022+.google.cloud.dialogflow.v2.Get"
+ "AgentRequest\032!.google.cloud.dialogflow.v"
+ "2.Agent\"[\202\323\344\223\002L\022\035/v2/{parent=projects/*}"
+ "/agentZ+\022)/v2/{parent=projects/*/locatio"
+ "ns/*}/agent\332A\006parent\022\320\001\n\010SetAgent\022+.goog"
+ "le.cloud.dialogflow.v2.SetAgentRequest\032!"
+ ".google.cloud.dialogflow.v2.Agent\"t\202\323\344\223\002"
+ "f\"#/v2/{agent.parent=projects/*}/agent:\005"
+ "agentZ8\"//v2/{agent.parent=projects/*/lo"
+ "cations/*}/agent:\005agent\332A\005agent\022\262\001\n\013Dele"
+ "teAgent\022..google.cloud.dialogflow.v2.Del"
+ "eteAgentRequest\032\026.google.protobuf.Empty\""
+ "[\202\323\344\223\002L*\035/v2/{parent=projects/*}/agentZ+"
+ "*)/v2/{parent=projects/*/locations/*}/ag"
+ "ent\332A\006parent\022\334\001\n\014SearchAgents\022/.google.c"
+ "loud.dialogflow.v2.SearchAgentsRequest\0320"
+ ".google.cloud.dialogflow.v2.SearchAgents"
+ "Response\"i\202\323\344\223\002Z\022$/v2/{parent=projects/*"
+ "}/agent:searchZ2\0220/v2/{parent=projects/*"
+ "/locations/*}/agent:search\332A\006parent\022\374\001\n\n"
+ "TrainAgent\022-.google.cloud.dialogflow.v2."
+ "TrainAgentRequest\032\035.google.longrunning.O"
+ "peration\"\237\001\202\323\344\223\002^\"#/v2/{parent=projects/"
+ "*}/agent:train:\001*Z4\"//v2/{parent=project"
+ "s/*/locations/*}/agent:train:\001*\332A\006parent"
+ "\312A/\n\025google.protobuf.Empty\022\026google.proto"
+ "buf.Struct\022\231\002\n\013ExportAgent\022..google.clou"
+ "d.dialogflow.v2.ExportAgentRequest\032\035.goo"
+ "gle.longrunning.Operation\"\272\001\202\323\344\223\002`\"$/v2/"
+ "{parent=projects/*}/agent:export:\001*Z5\"0/"
+ "v2/{parent=projects/*/locations/*}/agent"
+ ":import:\001*\312A/\n\025google.protobuf.Empty\022\026go"
+ "ogle.protobuf.Struct\022\373\001\n\014RestoreAgent\022/."
+ "google.cloud.dialogflow.v2.RestoreAgentR"
+ "equest\032\035.google.longrunning.Operation\"\232\001"
+ "\202\323\344\223\002b\"%/v2/{parent=projects/*}/agent:re"
+ "store:\001*Z6\"1/v2/{parent=projects/*/locat"
+ "ions/*}/agent:restore:\001*\312A/\n\025google.prot"
+ "obuf.Empty\022\026google.protobuf.Struct\022\361\001\n\023G"
+ "etValidationResult\0226.google.cloud.dialog"
+ "flow.v2.GetValidationResultRequest\032,.goo"
+ "gle.cloud.dialogflow.v2.ValidationResult"
+ "\"t\202\323\344\223\002n\022./v2/{parent=projects/*}/agent/"
+ "validationResultZ<\022:/v2/{parent=projects"
+ "/*/locations/*}/agent/validationResult\032x"
+ "\312A\031dialogflow.googleapis.com\322AYhttps://w"
+ "ww.googleapis.com/auth/cloud-platform,ht"
+ "tps://www.googleapis.com/auth/dialogflow"
+ "B\231\001\n\036com.google.cloud.dialogflow.v2B\nAge"
+ "ntProtoP\001ZDgoogle.golang.org/genproto/go"
+ "ogleapis/cloud/dialogflow/v2;dialogflow\370"
+ "\001\001\242\002\002DF\252\002\032Google.Cloud.Dialogflow.V2b\006pr"
+ "oto3"
+ ":export:\001*\332A\006parent\312AH\n.google.cloud.dia"
+ "logflow.v2.ExportAgentResponse\022\026google.p"
+ "rotobuf.Struct\022\367\001\n\013ImportAgent\022..google."
+ "cloud.dialogflow.v2.ImportAgentRequest\032\035"
+ ".google.longrunning.Operation\"\230\001\202\323\344\223\002`\"$"
+ "/v2/{parent=projects/*}/agent:import:\001*Z"
+ "5\"0/v2/{parent=projects/*/locations/*}/a"
+ "gent:import:\001*\312A/\n\025google.protobuf.Empty"
+ "\022\026google.protobuf.Struct\022\373\001\n\014RestoreAgen"
+ "t\022/.google.cloud.dialogflow.v2.RestoreAg"
+ "entRequest\032\035.google.longrunning.Operatio"
+ "n\"\232\001\202\323\344\223\002b\"%/v2/{parent=projects/*}/agen"
+ "t:restore:\001*Z6\"1/v2/{parent=projects/*/l"
+ "ocations/*}/agent:restore:\001*\312A/\n\025google."
+ "protobuf.Empty\022\026google.protobuf.Struct\022\361"
+ "\001\n\023GetValidationResult\0226.google.cloud.di"
+ "alogflow.v2.GetValidationResultRequest\032,"
+ ".google.cloud.dialogflow.v2.ValidationRe"
+ "sult\"t\202\323\344\223\002n\022./v2/{parent=projects/*}/ag"
+ "ent/validationResultZ<\022:/v2/{parent=proj"
+ "ects/*/locations/*}/agent/validationResu"
+ "lt\032x\312A\031dialogflow.googleapis.com\322AYhttps"
+ "://www.googleapis.com/auth/cloud-platfor"
+ "m,https://www.googleapis.com/auth/dialog"
+ "flowB\231\001\n\036com.google.cloud.dialogflow.v2B"
+ "\nAgentProtoP\001ZDgoogle.golang.org/genprot"
+ "o/googleapis/cloud/dialogflow/v2;dialogf"
+ "low\370\001\001\242\002\002DF\252\002\032Google.Cloud.Dialogflow.V2"
+ "b\006proto3"
};
descriptor =
com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
Expand Down
18 changes: 10 additions & 8 deletions ...ogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/StreamingDetectIntentResponse.java
View file
Expand Up @@ -25,10 +25,11 @@
* The top-level message returned from the
* `StreamingDetectIntent` method.
* Multiple response messages can be returned in order:
* 1. If the input was set to streaming audio, the first one or more messages
* contain `recognition_result`. Each `recognition_result` represents a more
* complete transcript of what the user said. The last `recognition_result`
* has `is_final` set to `true`.
* 1. If the `StreamingDetectIntentRequest.input_audio` field was
* set, the `recognition_result` field is populated for one
* or more messages.
* See the [StreamingRecognitionResult][google.cloud.dialogflow.v2.StreamingRecognitionResult] message for details
* about the result message sequence.
* 2. The next message contains `response_id`, `query_result`
* and optionally `webhook_status` if a WebHook was called.
* </pre>
Expand Down Expand Up @@ -688,10 +689,11 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
* The top-level message returned from the
* `StreamingDetectIntent` method.
* Multiple response messages can be returned in order:
* 1. If the input was set to streaming audio, the first one or more messages
* contain `recognition_result`. Each `recognition_result` represents a more
* complete transcript of what the user said. The last `recognition_result`
* has `is_final` set to `true`.
* 1. If the `StreamingDetectIntentRequest.input_audio` field was
* set, the `recognition_result` field is populated for one
* or more messages.
* See the [StreamingRecognitionResult][google.cloud.dialogflow.v2.StreamingRecognitionResult] message for details
* about the result message sequence.
* 2. The next message contains `response_id`, `query_result`
* and optionally `webhook_status` if a WebHook was called.
* </pre>
Expand Down

0 comments on commit df1d5e0

Please sign in to comment.