docs: update OPTIONAL annotations for some fields (#289)

This PR was generated using Autosynth. 🌈 Synth log will be available here: https://source.cloud.google.com/results/invocations/82a0afa3-6ece-4dc0-8f66-40c2ce25f020/targets - [ ] To automatically regenerate this PR, check this box. PiperOrigin-RevId: 333132625 Source-Link: googleapis/googleapis@470d84e
googleapis · Sep 22, 2020 · 69a18ce · 69a18ce
1 parent e66ad6a
commit 69a18ce
Show file tree

Hide file tree

Showing 9 changed files with 252 additions and 248 deletions.
diff --git a/...v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/DeleteKnowledgeBaseRequest.java b/...v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/DeleteKnowledgeBaseRequest.java
@@ -181,7 +181,7 @@ public com.google.protobuf.ByteString getNameBytes() {
    * in the knowledge base are also deleted.
    * </pre>
    *
-   * <code>bool force = 2;</code>
+   * <code>bool force = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
    *
    * @return The force.
    */
@@ -657,7 +657,7 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      * in the knowledge base are also deleted.
      * </pre>
      *
-     * <code>bool force = 2;</code>
+     * <code>bool force = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
      *
      * @return The force.
      */
@@ -673,7 +673,7 @@ public boolean getForce() {
      * in the knowledge base are also deleted.
      * </pre>
      *
-     * <code>bool force = 2;</code>
+     * <code>bool force = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
      *
      * @param value The force to set.
      * @return This builder for chaining.
@@ -692,7 +692,7 @@ public Builder setForce(boolean value) {
      * in the knowledge base are also deleted.
      * </pre>
      *
-     * <code>bool force = 2;</code>
+     * <code>bool force = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
      *
      * @return This builder for chaining.
      */

diff --git a/...rc/main/java/com/google/cloud/dialogflow/v2beta1/DeleteKnowledgeBaseRequestOrBuilder.java b/...rc/main/java/com/google/cloud/dialogflow/v2beta1/DeleteKnowledgeBaseRequestOrBuilder.java
@@ -62,7 +62,7 @@ public interface DeleteKnowledgeBaseRequestOrBuilder
    * in the knowledge base are also deleted.
    * </pre>
    *
-   * <code>bool force = 2;</code>
+   * <code>bool force = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
    *
    * @return The force.
    */

diff --git a/...logflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/KnowledgeBaseProto.java b/...logflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/KnowledgeBaseProto.java
@@ -75,69 +75,69 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\003\340A\002\022\025\n\rlanguage_code\030\004 \001(\t:`\352A]\n\'dialog"
           + "flow.googleapis.com/KnowledgeBase\0222proje"
           + "cts/{project}/knowledgeBases/{knowledge_"
-          + "base}\"\215\001\n\031ListKnowledgeBasesRequest\022?\n\006p"
+          + "base}\"\203\001\n\031ListKnowledgeBasesRequest\022?\n\006p"
           + "arent\030\001 \001(\tB/\340A\002\372A)\022\'dialogflow.googleap"
-          + "is.com/KnowledgeBase\022\026\n\tpage_size\030\002 \001(\005B"
-          + "\003\340A\001\022\027\n\npage_token\030\003 \001(\tB\003\340A\001\"~\n\032ListKno"
-          + "wledgeBasesResponse\022G\n\017knowledge_bases\030\001"
-          + " \003(\0132..google.cloud.dialogflow.v2beta1.K"
-          + "nowledgeBase\022\027\n\017next_page_token\030\002 \001(\t\"X\n"
-          + "\027GetKnowledgeBaseRequest\022=\n\004name\030\001 \001(\tB/"
-          + "\340A\002\372A)\n\'dialogflow.googleapis.com/Knowle"
-          + "dgeBase\"\252\001\n\032CreateKnowledgeBaseRequest\022?"
-          + "\n\006parent\030\001 \001(\tB/\340A\002\372A)\022\'dialogflow.googl"
-          + "eapis.com/KnowledgeBase\022K\n\016knowledge_bas"
-          + "e\030\002 \001(\0132..google.cloud.dialogflow.v2beta"
-          + "1.KnowledgeBaseB\003\340A\002\"j\n\032DeleteKnowledgeB"
-          + "aseRequest\022=\n\004name\030\001 \001(\tB/\340A\002\372A)\n\'dialog"
-          + "flow.googleapis.com/KnowledgeBase\022\r\n\005for"
-          + "ce\030\002 \001(\010\"\237\001\n\032UpdateKnowledgeBaseRequest\022"
-          + "K\n\016knowledge_base\030\001 \001(\0132..google.cloud.d"
-          + "ialogflow.v2beta1.KnowledgeBaseB\003\340A\002\0224\n\013"
-          + "update_mask\030\002 \001(\0132\032.google.protobuf.Fiel"
-          + "dMaskB\003\340A\0012\341\013\n\016KnowledgeBases\022\200\002\n\022ListKn"
-          + "owledgeBases\022:.google.cloud.dialogflow.v"
-          + "2beta1.ListKnowledgeBasesRequest\032;.googl"
-          + "e.cloud.dialogflow.v2beta1.ListKnowledge"
-          + "BasesResponse\"q\202\323\344\223\002b\022+/v2beta1/{parent="
-          + "projects/*}/knowledgeBasesZ3\0221/v2beta1/{"
-          + "parent=projects/*/agent}/knowledgeBases\332"
-          + "A\006parent\022\355\001\n\020GetKnowledgeBase\0228.google.c"
-          + "loud.dialogflow.v2beta1.GetKnowledgeBase"
+          + "is.com/KnowledgeBase\022\021\n\tpage_size\030\002 \001(\005\022"
+          + "\022\n\npage_token\030\003 \001(\t\"~\n\032ListKnowledgeBase"
+          + "sResponse\022G\n\017knowledge_bases\030\001 \003(\0132..goo"
+          + "gle.cloud.dialogflow.v2beta1.KnowledgeBa"
+          + "se\022\027\n\017next_page_token\030\002 \001(\t\"X\n\027GetKnowle"
+          + "dgeBaseRequest\022=\n\004name\030\001 \001(\tB/\340A\002\372A)\n\'di"
+          + "alogflow.googleapis.com/KnowledgeBase\"\252\001"
+          + "\n\032CreateKnowledgeBaseRequest\022?\n\006parent\030\001"
+          + " \001(\tB/\340A\002\372A)\022\'dialogflow.googleapis.com/"
+          + "KnowledgeBase\022K\n\016knowledge_base\030\002 \001(\0132.."
+          + "google.cloud.dialogflow.v2beta1.Knowledg"
+          + "eBaseB\003\340A\002\"o\n\032DeleteKnowledgeBaseRequest"
+          + "\022=\n\004name\030\001 \001(\tB/\340A\002\372A)\n\'dialogflow.googl"
+          + "eapis.com/KnowledgeBase\022\022\n\005force\030\002 \001(\010B\003"
+          + "\340A\001\"\237\001\n\032UpdateKnowledgeBaseRequest\022K\n\016kn"
+          + "owledge_base\030\001 \001(\0132..google.cloud.dialog"
+          + "flow.v2beta1.KnowledgeBaseB\003\340A\002\0224\n\013updat"
+          + "e_mask\030\002 \001(\0132\032.google.protobuf.FieldMask"
+          + "B\003\340A\0012\341\013\n\016KnowledgeBases\022\200\002\n\022ListKnowled"
+          + "geBases\022:.google.cloud.dialogflow.v2beta"
+          + "1.ListKnowledgeBasesRequest\032;.google.clo"
+          + "ud.dialogflow.v2beta1.ListKnowledgeBases"
+          + "Response\"q\202\323\344\223\002b\022+/v2beta1/{parent=proje"
+          + "cts/*}/knowledgeBasesZ3\0221/v2beta1/{paren"
+          + "t=projects/*/agent}/knowledgeBases\332A\006par"
+          + "ent\022\355\001\n\020GetKnowledgeBase\0228.google.cloud."
+          + "dialogflow.v2beta1.GetKnowledgeBaseReque"
+          + "st\032..google.cloud.dialogflow.v2beta1.Kno"
+          + "wledgeBase\"o\202\323\344\223\002b\022+/v2beta1/{name=proje"
+          + "cts/*/knowledgeBases/*}Z3\0221/v2beta1/{nam"
+          + "e=projects/*/agent/knowledgeBases/*}\332A\004n"
+          + "ame\022\246\002\n\023CreateKnowledgeBase\022;.google.clo"
+          + "ud.dialogflow.v2beta1.CreateKnowledgeBas"
+          + "eRequest\032..google.cloud.dialogflow.v2bet"
+          + "a1.KnowledgeBase\"\241\001\202\323\344\223\002\202\001\"+/v2beta1/{pa"
+          + "rent=projects/*}/knowledgeBases:\016knowled"
+          + "ge_baseZC\"1/v2beta1/{parent=projects/*/a"
+          + "gent}/knowledgeBases:\016knowledge_base\332A\025p"
+          + "arent,knowledge_base\022\333\001\n\023DeleteKnowledge"
+          + "Base\022;.google.cloud.dialogflow.v2beta1.D"
+          + "eleteKnowledgeBaseRequest\032\026.google.proto"
+          + "buf.Empty\"o\202\323\344\223\002b*+/v2beta1/{name=projec"
+          + "ts/*/knowledgeBases/*}Z3*1/v2beta1/{name"
+          + "=projects/*/agent/knowledgeBases/*}\332A\004na"
+          + "me\022\332\002\n\023UpdateKnowledgeBase\022;.google.clou"
+          + "d.dialogflow.v2beta1.UpdateKnowledgeBase"
           + "Request\032..google.cloud.dialogflow.v2beta"
-          + "1.KnowledgeBase\"o\202\323\344\223\002b\022+/v2beta1/{name="
-          + "projects/*/knowledgeBases/*}Z3\0221/v2beta1"
-          + "/{name=projects/*/agent/knowledgeBases/*"
-          + "}\332A\004name\022\246\002\n\023CreateKnowledgeBase\022;.googl"
-          + "e.cloud.dialogflow.v2beta1.CreateKnowled"
-          + "geBaseRequest\032..google.cloud.dialogflow."
-          + "v2beta1.KnowledgeBase\"\241\001\202\323\344\223\002\202\001\"+/v2beta"
-          + "1/{parent=projects/*}/knowledgeBases:\016kn"
-          + "owledge_baseZC\"1/v2beta1/{parent=project"
-          + "s/*/agent}/knowledgeBases:\016knowledge_bas"
-          + "e\332A\025parent,knowledge_base\022\333\001\n\023DeleteKnow"
-          + "ledgeBase\022;.google.cloud.dialogflow.v2be"
-          + "ta1.DeleteKnowledgeBaseRequest\032\026.google."
-          + "protobuf.Empty\"o\202\323\344\223\002b*+/v2beta1/{name=p"
-          + "rojects/*/knowledgeBases/*}Z3*1/v2beta1/"
-          + "{name=projects/*/agent/knowledgeBases/*}"
-          + "\332A\004name\022\332\002\n\023UpdateKnowledgeBase\022;.google"
-          + ".cloud.dialogflow.v2beta1.UpdateKnowledg"
-          + "eBaseRequest\032..google.cloud.dialogflow.v"
-          + "2beta1.KnowledgeBase\"\325\001\202\323\344\223\002\240\0012:/v2beta1"
-          + "/{knowledge_base.name=projects/*/knowled"
-          + "geBases/*}:\016knowledge_baseZR2@/v2beta1/{"
-          + "knowledge_base.name=projects/*/agent/kno"
-          + "wledgeBases/*}:\016knowledge_base\332A\032knowled"
-          + "ge_base,update_mask\332A\016knowledge_base\032x\312A"
-          + "\031dialogflow.googleapis.com\322AYhttps://www"
-          + ".googleapis.com/auth/cloud-platform,http"
-          + "s://www.googleapis.com/auth/dialogflowB\260"
-          + "\001\n#com.google.cloud.dialogflow.v2beta1B\022"
-          + "KnowledgeBaseProtoP\001ZIgoogle.golang.org/"
-          + "genproto/googleapis/cloud/dialogflow/v2b"
-          + "eta1;dialogflow\370\001\001\242\002\002DF\252\002\037Google.Cloud.D"
-          + "ialogflow.V2beta1b\006proto3"
+          + "1.KnowledgeBase\"\325\001\202\323\344\223\002\240\0012:/v2beta1/{kno"
+          + "wledge_base.name=projects/*/knowledgeBas"
+          + "es/*}:\016knowledge_baseZR2@/v2beta1/{knowl"
+          + "edge_base.name=projects/*/agent/knowledg"
+          + "eBases/*}:\016knowledge_base\332A\032knowledge_ba"
+          + "se,update_mask\332A\016knowledge_base\032x\312A\031dial"
+          + "ogflow.googleapis.com\322AYhttps://www.goog"
+          + "leapis.com/auth/cloud-platform,https://w"
+          + "ww.googleapis.com/auth/dialogflowB\260\001\n#co"
+          + "m.google.cloud.dialogflow.v2beta1B\022Knowl"
+          + "edgeBaseProtoP\001ZIgoogle.golang.org/genpr"
+          + "oto/googleapis/cloud/dialogflow/v2beta1;"
+          + "dialogflow\370\001\001\242\002\002DF\252\002\037Google.Cloud.Dialog"
+          + "flow.V2beta1b\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(

diff --git a/...-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/ListKnowledgeBasesRequest.java b/...-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/ListKnowledgeBasesRequest.java
@@ -185,11 +185,11 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    *
    * <pre>
-   * Optional. The maximum number of items to return in a single page. By
+   * The maximum number of items to return in a single page. By
    * default 10 and at most 100.
    * </pre>
    *
-   * <code>int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
+   * <code>int32 page_size = 2;</code>
    *
    * @return The pageSize.
    */
@@ -204,10 +204,10 @@ public int getPageSize() {
    *
    *
    * <pre>
-   * Optional. The next_page_token value returned from a previous list request.
+   * The next_page_token value returned from a previous list request.
    * </pre>
    *
-   * <code>string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
+   * <code>string page_token = 3;</code>
    *
    * @return The pageToken.
    */
@@ -227,10 +227,10 @@ public java.lang.String getPageToken() {
    *
    *
    * <pre>
-   * Optional. The next_page_token value returned from a previous list request.
+   * The next_page_token value returned from a previous list request.
    * </pre>
    *
-   * <code>string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
+   * <code>string page_token = 3;</code>
    *
    * @return The bytes for pageToken.
    */
@@ -726,11 +726,11 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      *
      * <pre>
-     * Optional. The maximum number of items to return in a single page. By
+     * The maximum number of items to return in a single page. By
      * default 10 and at most 100.
      * </pre>
      *
-     * <code>int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
+     * <code>int32 page_size = 2;</code>
      *
      * @return The pageSize.
      */
@@ -742,11 +742,11 @@ public int getPageSize() {
      *
      *
      * <pre>
-     * Optional. The maximum number of items to return in a single page. By
+     * The maximum number of items to return in a single page. By
      * default 10 and at most 100.
      * </pre>
      *
-     * <code>int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
+     * <code>int32 page_size = 2;</code>
      *
      * @param value The pageSize to set.
      * @return This builder for chaining.
@@ -761,11 +761,11 @@ public Builder setPageSize(int value) {
      *
      *
      * <pre>
-     * Optional. The maximum number of items to return in a single page. By
+     * The maximum number of items to return in a single page. By
      * default 10 and at most 100.
      * </pre>
      *
-     * <code>int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
+     * <code>int32 page_size = 2;</code>
      *
      * @return This builder for chaining.
      */
@@ -781,10 +781,10 @@ public Builder clearPageSize() {
      *
      *
      * <pre>
-     * Optional. The next_page_token value returned from a previous list request.
+     * The next_page_token value returned from a previous list request.
      * </pre>
      *
-     * <code>string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
+     * <code>string page_token = 3;</code>
      *
      * @return The pageToken.
      */
@@ -803,10 +803,10 @@ public java.lang.String getPageToken() {
      *
      *
      * <pre>
-     * Optional. The next_page_token value returned from a previous list request.
+     * The next_page_token value returned from a previous list request.
      * </pre>
      *
-     * <code>string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
+     * <code>string page_token = 3;</code>
      *
      * @return The bytes for pageToken.
      */
@@ -825,10 +825,10 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * <pre>
-     * Optional. The next_page_token value returned from a previous list request.
+     * The next_page_token value returned from a previous list request.
      * </pre>
      *
-     * <code>string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
+     * <code>string page_token = 3;</code>
      *
      * @param value The pageToken to set.
      * @return This builder for chaining.
@@ -846,10 +846,10 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * <pre>
-     * Optional. The next_page_token value returned from a previous list request.
+     * The next_page_token value returned from a previous list request.
      * </pre>
      *
-     * <code>string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
+     * <code>string page_token = 3;</code>
      *
      * @return This builder for chaining.
      */
@@ -863,10 +863,10 @@ public Builder clearPageToken() {
      *
      *
      * <pre>
-     * Optional. The next_page_token value returned from a previous list request.
+     * The next_page_token value returned from a previous list request.
      * </pre>
      *
-     * <code>string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
+     * <code>string page_token = 3;</code>
      *
      * @param value The bytes for pageToken to set.
      * @return This builder for chaining.

diff --git a/...src/main/java/com/google/cloud/dialogflow/v2beta1/ListKnowledgeBasesRequestOrBuilder.java b/...src/main/java/com/google/cloud/dialogflow/v2beta1/ListKnowledgeBasesRequestOrBuilder.java
@@ -58,11 +58,11 @@ public interface ListKnowledgeBasesRequestOrBuilder
    *
    *
    * <pre>
-   * Optional. The maximum number of items to return in a single page. By
+   * The maximum number of items to return in a single page. By
    * default 10 and at most 100.
    * </pre>
    *
-   * <code>int32 page_size = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
+   * <code>int32 page_size = 2;</code>
    *
    * @return The pageSize.
    */
@@ -72,10 +72,10 @@ public interface ListKnowledgeBasesRequestOrBuilder
    *
    *
    * <pre>
-   * Optional. The next_page_token value returned from a previous list request.
+   * The next_page_token value returned from a previous list request.
    * </pre>
    *
-   * <code>string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
+   * <code>string page_token = 3;</code>
    *
    * @return The pageToken.
    */
@@ -84,10 +84,10 @@ public interface ListKnowledgeBasesRequestOrBuilder
    *
    *
    * <pre>
-   * Optional. The next_page_token value returned from a previous list request.
+   * The next_page_token value returned from a previous list request.
    * </pre>
    *
-   * <code>string page_token = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
+   * <code>string page_token = 3;</code>
    *
    * @return The bytes for pageToken.
    */