docs: regenerate from protos (#13)

Author: yoshi-automation

google-cloud-datacatalog/src/main/java/com/google/cloud/datacatalog/v1beta1/DataCatalogClient.java

@@ -718,7 +718,7 @@ public final UnaryCallable<SearchCatalogRequest, SearchCatalogResponse> searchCa
    *     <p>Note that this EntryGroup and its child resources may not actually be stored in the
    *     location in this name.
    * @param entryGroupId Required. The id of the entry group to create.
-   * @param entryGroup Optional. The entry group to create. Defaults to an empty entry group.
+   * @param entryGroup The entry group to create. Defaults to an empty entry group.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final EntryGroup createEntryGroup(
@@ -806,7 +806,7 @@ public final UnaryCallable<CreateEntryGroupRequest, EntryGroup> createEntryGroup
    *
    * @param name Required. The name of the entry group. For example,
    *     `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}`.
-   * @param readMask Optional. The fields to return. If not set or empty, all fields are returned.
+   * @param readMask The fields to return. If not set or empty, all fields are returned.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final EntryGroup getEntryGroup(String name, FieldMask readMask) {
@@ -1050,10 +1050,12 @@ public final UnaryCallable<CreateEntryRequest, Entry> createEntryCallable() {
    * }
    * </code></pre>
    *
-   * @param entry Required. The updated entry.
-   * @param updateMask Optional. The fields to update on the entry. If absent or empty, all
-   *     modifiable fields are updated.
-   *     <p>Currently only `schema` field in Cloud Pub/Sub topic entries is modifiable.
+   * @param entry Required. The updated entry. The "name" field must be set.
+   * @param updateMask The fields to update on the entry. If absent or empty, all modifiable fields
+   *     are updated.
+   *     <p>The following fields are modifiable: &#42; For entries with type `DATA_STREAM`: &#42;
+   *     `schema` &#42; For entries with type `FILESET` &#42; `schema` &#42; `display_name` &#42;
+   *     `description` &#42; `gcs_fileset_spec` &#42; `gcs_fileset_spec.file_patterns`
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Entry updateEntry(Entry entry, FieldMask updateMask) {
@@ -1486,8 +1488,8 @@ public final UnaryCallable<GetTagTemplateRequest, TagTemplate> getTagTemplateCal
    * }
    * </code></pre>
    *
-   * @param tagTemplate Required. The template to update.
-   * @param updateMask Optional. The field mask specifies the parts of the template to overwrite.
+   * @param tagTemplate Required. The template to update. The "name" field must be set.
+   * @param updateMask The field mask specifies the parts of the template to overwrite.
    *     <p>Allowed fields:
    *     <p>&#42; `display_name`
    *     <p>If absent or empty, all of the allowed fields above will be updated.
@@ -1758,8 +1760,8 @@ public final TagTemplateField createTagTemplateField(CreateTagTemplateFieldReque
    *     <p>&#42;
    *     projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id}
    * @param tagTemplateField Required. The template to update.
-   * @param updateMask Optional. The field mask specifies the parts of the template to be updated.
-   *     Allowed fields:
+   * @param updateMask The field mask specifies the parts of the template to be updated. Allowed
+   *     fields:
    *     <p>&#42; `display_name` &#42; `type.enum_type`
    *     <p>If `update_mask` is not set or empty, all of the allowed fields above will be updated.
    *     <p>When updating an enum type, the provided values will be merged with the existing values.
@@ -2114,9 +2116,9 @@ public final UnaryCallable<CreateTagRequest, Tag> createTagCallable() {
    * }
    * </code></pre>
    *
-   * @param tag Required. The updated tag.
-   * @param updateMask Optional. The fields to update on the Tag. If absent or empty, all modifiable
-   *     fields are updated. Currently the only modifiable field is the field `fields`.
+   * @param tag Required. The updated tag. The "name" field must be set.
+   * @param updateMask The fields to update on the Tag. If absent or empty, all modifiable fields
+   *     are updated. Currently the only modifiable field is the field `fields`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final Tag updateTag(Tag tag, FieldMask updateMask) {

proto-google-cloud-datacatalog-v1beta1/src/main/java/com/google/cloud/datacatalog/BigQueryDateShardedSpec.java

@@ -179,11 +179,12 @@ public com.google.protobuf.ByteString getDatasetBytes() {
    *
    * <pre>
    * Output only. The table name prefix of the shards. The name of any given
-   * shard is `[table_prefix]YYYYMMDD`, for example, for shard
-   * `MyTable20180101`, the `table_prefix` is `MyTable`.
+   * shard is
+   * `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the
+   * `table_prefix` is `MyTable`.
    * </pre>
    *
-   * <code>string table_prefix = 2;</code>
+   * <code>string table_prefix = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
    */
   public java.lang.String getTablePrefix() {
     java.lang.Object ref = tablePrefix_;
@@ -201,11 +202,12 @@ public java.lang.String getTablePrefix() {
    *
    * <pre>
    * Output only. The table name prefix of the shards. The name of any given
-   * shard is `[table_prefix]YYYYMMDD`, for example, for shard
-   * `MyTable20180101`, the `table_prefix` is `MyTable`.
+   * shard is
+   * `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the
+   * `table_prefix` is `MyTable`.
    * </pre>
    *
-   * <code>string table_prefix = 2;</code>
+   * <code>string table_prefix = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
    */
   public com.google.protobuf.ByteString getTablePrefixBytes() {
     java.lang.Object ref = tablePrefix_;
@@ -228,7 +230,7 @@ public com.google.protobuf.ByteString getTablePrefixBytes() {
    * Output only. Total number of shards.
    * </pre>
    *
-   * <code>int64 shard_count = 3;</code>
+   * <code>int64 shard_count = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
    */
   public long getShardCount() {
     return shardCount_;
@@ -705,11 +707,12 @@ public Builder setDatasetBytes(com.google.protobuf.ByteString value) {
      *
      * <pre>
      * Output only. The table name prefix of the shards. The name of any given
-     * shard is `[table_prefix]YYYYMMDD`, for example, for shard
-     * `MyTable20180101`, the `table_prefix` is `MyTable`.
+     * shard is
+     * `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the
+     * `table_prefix` is `MyTable`.
      * </pre>
      *
-     * <code>string table_prefix = 2;</code>
+     * <code>string table_prefix = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
      */
     public java.lang.String getTablePrefix() {
       java.lang.Object ref = tablePrefix_;
@@ -727,11 +730,12 @@ public java.lang.String getTablePrefix() {
      *
      * <pre>
      * Output only. The table name prefix of the shards. The name of any given
-     * shard is `[table_prefix]YYYYMMDD`, for example, for shard
-     * `MyTable20180101`, the `table_prefix` is `MyTable`.
+     * shard is
+     * `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the
+     * `table_prefix` is `MyTable`.
      * </pre>
      *
-     * <code>string table_prefix = 2;</code>
+     * <code>string table_prefix = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
      */
     public com.google.protobuf.ByteString getTablePrefixBytes() {
       java.lang.Object ref = tablePrefix_;
@@ -749,11 +753,12 @@ public com.google.protobuf.ByteString getTablePrefixBytes() {
      *
      * <pre>
      * Output only. The table name prefix of the shards. The name of any given
-     * shard is `[table_prefix]YYYYMMDD`, for example, for shard
-     * `MyTable20180101`, the `table_prefix` is `MyTable`.
+     * shard is
+     * `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the
+     * `table_prefix` is `MyTable`.
      * </pre>
      *
-     * <code>string table_prefix = 2;</code>
+     * <code>string table_prefix = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
      */
     public Builder setTablePrefix(java.lang.String value) {
       if (value == null) {
@@ -769,11 +774,12 @@ public Builder setTablePrefix(java.lang.String value) {
      *
      * <pre>
      * Output only. The table name prefix of the shards. The name of any given
-     * shard is `[table_prefix]YYYYMMDD`, for example, for shard
-     * `MyTable20180101`, the `table_prefix` is `MyTable`.
+     * shard is
+     * `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the
+     * `table_prefix` is `MyTable`.
      * </pre>
      *
-     * <code>string table_prefix = 2;</code>
+     * <code>string table_prefix = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
      */
     public Builder clearTablePrefix() {
 
@@ -786,11 +792,12 @@ public Builder clearTablePrefix() {
      *
      * <pre>
      * Output only. The table name prefix of the shards. The name of any given
-     * shard is `[table_prefix]YYYYMMDD`, for example, for shard
-     * `MyTable20180101`, the `table_prefix` is `MyTable`.
+     * shard is
+     * `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the
+     * `table_prefix` is `MyTable`.
      * </pre>
      *
-     * <code>string table_prefix = 2;</code>
+     * <code>string table_prefix = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
      */
     public Builder setTablePrefixBytes(com.google.protobuf.ByteString value) {
       if (value == null) {
@@ -811,7 +818,7 @@ public Builder setTablePrefixBytes(com.google.protobuf.ByteString value) {
      * Output only. Total number of shards.
      * </pre>
      *
-     * <code>int64 shard_count = 3;</code>
+     * <code>int64 shard_count = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
      */
     public long getShardCount() {
       return shardCount_;
@@ -823,7 +830,7 @@ public long getShardCount() {
      * Output only. Total number of shards.
      * </pre>
      *
-     * <code>int64 shard_count = 3;</code>
+     * <code>int64 shard_count = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
      */
     public Builder setShardCount(long value) {
 
@@ -838,7 +845,7 @@ public Builder setShardCount(long value) {
      * Output only. Total number of shards.
      * </pre>
      *
-     * <code>int64 shard_count = 3;</code>
+     * <code>int64 shard_count = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
      */
     public Builder clearShardCount() {
 

proto-google-cloud-datacatalog-v1beta1/src/main/java/com/google/cloud/datacatalog/BigQueryDateShardedSpecOrBuilder.java

@@ -57,23 +57,25 @@ public interface BigQueryDateShardedSpecOrBuilder
    *
    * <pre>
    * Output only. The table name prefix of the shards. The name of any given
-   * shard is `[table_prefix]YYYYMMDD`, for example, for shard
-   * `MyTable20180101`, the `table_prefix` is `MyTable`.
+   * shard is
+   * `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the
+   * `table_prefix` is `MyTable`.
    * </pre>
    *
-   * <code>string table_prefix = 2;</code>
+   * <code>string table_prefix = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
    */
   java.lang.String getTablePrefix();
   /**
    *
    *
    * <pre>
    * Output only. The table name prefix of the shards. The name of any given
-   * shard is `[table_prefix]YYYYMMDD`, for example, for shard
-   * `MyTable20180101`, the `table_prefix` is `MyTable`.
+   * shard is
+   * `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the
+   * `table_prefix` is `MyTable`.
    * </pre>
    *
-   * <code>string table_prefix = 2;</code>
+   * <code>string table_prefix = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
    */
   com.google.protobuf.ByteString getTablePrefixBytes();
 
@@ -84,7 +86,7 @@ public interface BigQueryDateShardedSpecOrBuilder
    * Output only. Total number of shards.
    * </pre>
    *
-   * <code>int64 shard_count = 3;</code>
+   * <code>int64 shard_count = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
    */
   long getShardCount();
 }