docs: update languages link

PiperOrigin-RevId: 359099050
googleapis · Feb 23, 2021 · b89bcc4 · b89bcc4
1 parent cb039bd
commit b89bcc4
Show file tree

Hide file tree

Showing 9 changed files with 69 additions and 67 deletions.
diff --git a/google/cloud/dialogflow/cx/v3/BUILD.bazel b/google/cloud/dialogflow/cx/v3/BUILD.bazel
@@ -1,5 +1,5 @@
 # This file was automatically generated by BuildFileGenerator
-# https://github.com/googleapis/gapic-generator/tree/master/rules_gapic/bazel
+# https://github.com/googleapis/rules_gapic/tree/master/bazel
 
 # Most of the manual changes to this file will be overwritten.
 # It's **only** allowed to change the following rule attribute values:
@@ -160,6 +160,7 @@ go_gapic_library(
     srcs = [":cx_proto_with_info"],
     grpc_service_config = "dialogflow_grpc_service_config.json",
     importpath = "cloud.google.com/go/dialogflow/cx/apiv3;cx",
+    metadata = True,
     service_yaml = "dialogflow_v3.yaml",
     deps = [
         ":cx_go_proto",
@@ -183,6 +184,7 @@ go_gapic_assembly_pkg(
     name = "gapi-cloud-dialogflow-cx-v3-go",
     deps = [
         ":cx_go_gapic",
+        ":cx_go_gapic_srcjar-metadata.srcjar",
         ":cx_go_gapic_srcjar-test.srcjar",
         ":cx_go_proto",
     ],

diff --git a/google/cloud/dialogflow/cx/v3/agent.proto b/google/cloud/dialogflow/cx/v3/agent.proto
@@ -160,7 +160,7 @@ message Agent {
 
   // Immutable. The default language of the agent as a language tag.
   // See [Language
-  // Support](https://cloud.google.com/dialogflow/docs/reference/language)
+  // Support](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // for a list of the currently supported language codes.
   // This field cannot be set by the [Agents.UpdateAgent][google.cloud.dialogflow.cx.v3.Agents.UpdateAgent] method.
   string default_language_code = 3 [(google.api.field_behavior) = IMMUTABLE];

diff --git a/google/cloud/dialogflow/cx/v3/audio_config.proto b/google/cloud/dialogflow/cx/v3/audio_config.proto
@@ -29,6 +29,31 @@ option java_outer_classname = "AudioConfigProto";
 option java_package = "com.google.cloud.dialogflow.cx.v3";
 option objc_class_prefix = "DF";
 
+// Information for a word recognized by the speech recognizer.
+message SpeechWordInfo {
+  // The word this info is for.
+  string word = 3;
+
+  // Time offset relative to the beginning of the audio that corresponds to the
+  // start of the spoken word. This is an experimental feature and the accuracy
+  // of the time offset can vary.
+  google.protobuf.Duration start_offset = 1;
+
+  // Time offset relative to the beginning of the audio that corresponds to the
+  // end of the spoken word. This is an experimental feature and the accuracy of
+  // the time offset can vary.
+  google.protobuf.Duration end_offset = 2;
+
+  // The Speech confidence between 0.0 and 1.0 for this word. A higher number
+  // indicates an estimated greater likelihood that the recognized word is
+  // correct. The default of 0.0 is a sentinel value indicating that confidence
+  // was not set.
+  //
+  // This field is not guaranteed to be fully stable over time for the same
+  // audio input. Users should also not rely on it to always be provided.
+  float confidence = 4;
+}
+
 // Audio encoding of the audio content sent in the conversational query request.
 // Refer to the
 // [Cloud Speech API
@@ -78,31 +103,6 @@ enum AudioEncoding {
   AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE = 7;
 }
 
-// Information for a word recognized by the speech recognizer.
-message SpeechWordInfo {
-  // The word this info is for.
-  string word = 3;
-
-  // Time offset relative to the beginning of the audio that corresponds to the
-  // start of the spoken word. This is an experimental feature and the accuracy
-  // of the time offset can vary.
-  google.protobuf.Duration start_offset = 1;
-
-  // Time offset relative to the beginning of the audio that corresponds to the
-  // end of the spoken word. This is an experimental feature and the accuracy of
-  // the time offset can vary.
-  google.protobuf.Duration end_offset = 2;
-
-  // The Speech confidence between 0.0 and 1.0 for this word. A higher number
-  // indicates an estimated greater likelihood that the recognized word is
-  // correct. The default of 0.0 is a sentinel value indicating that confidence
-  // was not set.
-  //
-  // This field is not guaranteed to be fully stable over time for the same
-  // audio input. Users should also not rely on it to always be provided.
-  float confidence = 4;
-}
-
 // Instructs the speech recognizer on how to process the audio content.
 message InputAudioConfig {
   // Required. Audio encoding of the audio content to process.
@@ -250,6 +250,22 @@ message SynthesizeSpeechConfig {
   VoiceSelectionParams voice = 4;
 }
 
+// Instructs the speech synthesizer how to generate the output audio content.
+message OutputAudioConfig {
+  // Required. Audio encoding of the synthesized audio content.
+  OutputAudioEncoding audio_encoding = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The synthesis sample rate (in hertz) for this audio. If not
+  // provided, then the synthesizer will use the default sample rate based on
+  // the audio encoding. If this is different from the voice's natural sample
+  // rate, then the synthesizer will honor this request by converting to the
+  // desired sample rate (which might result in worse audio quality).
+  int32 sample_rate_hertz = 2;
+
+  // Optional. Configuration of how speech should be synthesized.
+  SynthesizeSpeechConfig synthesize_speech_config = 3;
+}
+
 // Gender of the voice as described in
 // [SSML voice element](https://www.w3.org/TR/speech-synthesis11/#edef_voice).
 enum SsmlVoiceGender {
@@ -267,22 +283,6 @@ enum SsmlVoiceGender {
   SSML_VOICE_GENDER_NEUTRAL = 3;
 }
 
-// Instructs the speech synthesizer how to generate the output audio content.
-message OutputAudioConfig {
-  // Required. Audio encoding of the synthesized audio content.
-  OutputAudioEncoding audio_encoding = 1 [(google.api.field_behavior) = REQUIRED];
-
-  // Optional. The synthesis sample rate (in hertz) for this audio. If not
-  // provided, then the synthesizer will use the default sample rate based on
-  // the audio encoding. If this is different from the voice's natural sample
-  // rate, then the synthesizer will honor this request by converting to the
-  // desired sample rate (which might result in worse audio quality).
-  int32 sample_rate_hertz = 2;
-
-  // Optional. Configuration of how speech should be synthesized.
-  SynthesizeSpeechConfig synthesize_speech_config = 3;
-}
-
 // Audio encoding of the output audio format in Text-To-Speech.
 enum OutputAudioEncoding {
   // Not specified.

diff --git a/google/cloud/dialogflow/cx/v3/entity_type.proto b/google/cloud/dialogflow/cx/v3/entity_type.proto
@@ -231,7 +231,7 @@ message ListEntityTypesRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;
@@ -276,7 +276,7 @@ message GetEntityTypeRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;
@@ -304,7 +304,7 @@ message CreateEntityTypeRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 3;
@@ -323,7 +323,7 @@ message UpdateEntityTypeRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;

diff --git a/google/cloud/dialogflow/cx/v3/flow.proto b/google/cloud/dialogflow/cx/v3/flow.proto
@@ -250,7 +250,7 @@ message CreateFlowRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 3;
@@ -307,7 +307,7 @@ message ListFlowsRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 4;
@@ -344,7 +344,7 @@ message GetFlowRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;
@@ -366,7 +366,7 @@ message UpdateFlowRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 3;

diff --git a/google/cloud/dialogflow/cx/v3/intent.proto b/google/cloud/dialogflow/cx/v3/intent.proto
@@ -236,7 +236,7 @@ message ListIntentsRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;
@@ -282,7 +282,7 @@ message GetIntentRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;
@@ -308,7 +308,7 @@ message CreateIntentRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 3;
@@ -325,7 +325,7 @@ message UpdateIntentRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;

diff --git a/google/cloud/dialogflow/cx/v3/page.proto b/google/cloud/dialogflow/cx/v3/page.proto
@@ -386,7 +386,7 @@ message ListPagesRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;
@@ -434,7 +434,7 @@ message GetPageRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;
@@ -466,7 +466,7 @@ message CreatePageRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 3;
@@ -488,7 +488,7 @@ message UpdatePageRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;

diff --git a/google/cloud/dialogflow/cx/v3/session.proto b/google/cloud/dialogflow/cx/v3/session.proto
@@ -433,9 +433,9 @@ message QueryInput {
   }
 
   // Required. The language of the input. See [Language
-  // 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.
+  // Support](https://cloud.google.com/dialogflow/cx/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.
   string language_code = 4 [(google.api.field_behavior) = REQUIRED];
 }
 
@@ -462,7 +462,7 @@ message QueryResult {
 
   // The language that was triggered during intent detection.
   // See [Language
-  // Support](https://cloud.google.com/dialogflow/docs/reference/language)
+  // Support](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // for a list of the currently supported language codes.
   string language_code = 2;
 

diff --git a/google/cloud/dialogflow/cx/v3/transition_route_group.proto b/google/cloud/dialogflow/cx/v3/transition_route_group.proto
@@ -130,7 +130,7 @@ message ListTransitionRouteGroupsRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 4;
@@ -167,7 +167,7 @@ message GetTransitionRouteGroupRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 2;
@@ -194,7 +194,7 @@ message CreateTransitionRouteGroupRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 3;
@@ -214,7 +214,7 @@ message UpdateTransitionRouteGroupRequest {
   //
   // If not specified, the agent's default language is used.
   // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // languages](https://cloud.google.com/dialogflow/cx/docs/reference/language)
   // are supported.
   // Note: languages must be enabled in the agent before they can be used.
   string language_code = 3;