chore: regenerate bigtableadmin client (googleapis#23657)

yoshi-code-bot · web-flow · commit f91f3cea87bf · 2024-10-18T01:06:24.000Z
Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-java-client-services/actions/workflows/codegen.yaml
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/README.md b/clients/google-api-services-bigtableadmin/v2/2.0.0/README.md
@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-bigtableadmin</artifactId>
-      <version>v2-rev20240918-2.0.0</version>
+      <version>v2-rev20241008-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-bigtableadmin:v2-rev20240918-2.0.0'
+  implementation 'com.google.apis:google-api-services-bigtableadmin:v2-rev20241008-2.0.0'
 }
 ```
 
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/AutomatedBackupPolicy.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/AutomatedBackupPolicy.java
@@ -31,8 +31,8 @@
 public final class AutomatedBackupPolicy extends com.google.api.client.json.GenericJson {
 
   /**
-   * Required. How frequently automated backups should occur. The only supported value at this time
-   * is 24 hours.
+   * How frequently automated backups should occur. The only supported value at this time is 24
+   * hours. An undefined frequency is treated as 24 hours.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -47,17 +47,17 @@ public final class AutomatedBackupPolicy extends com.google.api.client.json.Gene
   private String retentionPeriod;
 
   /**
-   * Required. How frequently automated backups should occur. The only supported value at this time
-   * is 24 hours.
+   * How frequently automated backups should occur. The only supported value at this time is 24
+   * hours. An undefined frequency is treated as 24 hours.
    * @return value or {@code null} for none
    */
   public String getFrequency() {
     return frequency;
   }
 
   /**
-   * Required. How frequently automated backups should occur. The only supported value at this time
-   * is 24 hours.
+   * How frequently automated backups should occur. The only supported value at this time is 24
+   * hours. An undefined frequency is treated as 24 hours.
    * @param frequency frequency or {@code null} for none
    */
   public AutomatedBackupPolicy setFrequency(String frequency) {
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeAggregate.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeAggregate.java
@@ -18,8 +18,8 @@
 
 /**
  * A value that combines incremental updates into a summarized value. Data is never directly written
- * or read using type `Aggregate`. Writes will provide either the `input_type` or `state_type`, and
- * reads will always return the `state_type` .
+ * or read using type `Aggregate`. Writes provide either the `input_type` or `state_type`, and reads
+ * always return the `state_type` .
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Bigtable Admin API. For a detailed explanation
@@ -40,8 +40,8 @@ public final class GoogleBigtableAdminV2TypeAggregate extends com.google.api.cli
   private GoogleBigtableAdminV2TypeAggregateHyperLogLogPlusPlusUniqueCount hllppUniqueCount;
 
   /**
-   * Type of the inputs that are accumulated by this `Aggregate`, which must specify a full
-   * encoding. Use `AddInput` mutations to accumulate new inputs.
+   * Type of the inputs that are accumulated by this `Aggregate`. Use `AddInput` mutations to
+   * accumulate new inputs.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -63,7 +63,7 @@ public final class GoogleBigtableAdminV2TypeAggregate extends com.google.api.cli
 
   /**
    * Output only. Type that holds the internal accumulator state for the `Aggregate`. This is a
-   * function of the `input_type` and `aggregator` chosen, and will always specify a full encoding.
+   * function of the `input_type` and `aggregator` chosen.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -94,17 +94,17 @@ public GoogleBigtableAdminV2TypeAggregate setHllppUniqueCount(GoogleBigtableAdmi
   }
 
   /**
-   * Type of the inputs that are accumulated by this `Aggregate`, which must specify a full
-   * encoding. Use `AddInput` mutations to accumulate new inputs.
+   * Type of the inputs that are accumulated by this `Aggregate`. Use `AddInput` mutations to
+   * accumulate new inputs.
    * @return value or {@code null} for none
    */
   public Type getInputType() {
     return inputType;
   }
 
   /**
-   * Type of the inputs that are accumulated by this `Aggregate`, which must specify a full
-   * encoding. Use `AddInput` mutations to accumulate new inputs.
+   * Type of the inputs that are accumulated by this `Aggregate`. Use `AddInput` mutations to
+   * accumulate new inputs.
    * @param inputType inputType or {@code null} for none
    */
   public GoogleBigtableAdminV2TypeAggregate setInputType(Type inputType) {
@@ -148,7 +148,7 @@ public GoogleBigtableAdminV2TypeAggregate setMin(GoogleBigtableAdminV2TypeAggreg
 
   /**
    * Output only. Type that holds the internal accumulator state for the `Aggregate`. This is a
-   * function of the `input_type` and `aggregator` chosen, and will always specify a full encoding.
+   * function of the `input_type` and `aggregator` chosen.
    * @return value or {@code null} for none
    */
   public Type getStateType() {
@@ -157,7 +157,7 @@ public Type getStateType() {
 
   /**
    * Output only. Type that holds the internal accumulator state for the `Aggregate`. This is a
-   * function of the `input_type` and `aggregator` chosen, and will always specify a full encoding.
+   * function of the `input_type` and `aggregator` chosen.
    * @param stateType stateType or {@code null} for none
    */
   public GoogleBigtableAdminV2TypeAggregate setStateType(Type stateType) {
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeBytes.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeBytes.java
@@ -31,22 +31,22 @@
 public final class GoogleBigtableAdminV2TypeBytes extends com.google.api.client.json.GenericJson {
 
   /**
-   * The encoding to use when converting to/from lower level types.
+   * The encoding to use when converting to or from lower level types.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private GoogleBigtableAdminV2TypeBytesEncoding encoding;
 
   /**
-   * The encoding to use when converting to/from lower level types.
+   * The encoding to use when converting to or from lower level types.
    * @return value or {@code null} for none
    */
   public GoogleBigtableAdminV2TypeBytesEncoding getEncoding() {
     return encoding;
   }
 
   /**
-   * The encoding to use when converting to/from lower level types.
+   * The encoding to use when converting to or from lower level types.
    * @param encoding encoding or {@code null} for none
    */
   public GoogleBigtableAdminV2TypeBytes setEncoding(GoogleBigtableAdminV2TypeBytesEncoding encoding) {
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeBytesEncoding.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeBytesEncoding.java
@@ -17,7 +17,7 @@
 package com.google.api.services.bigtableadmin.v2.model;
 
 /**
- * Rules used to convert to/from lower level types.
+ * Rules used to convert to or from lower level types.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Bigtable Admin API. For a detailed explanation
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeBytesEncodingRaw.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeBytesEncodingRaw.java
@@ -17,7 +17,8 @@
 package com.google.api.services.bigtableadmin.v2.model;
 
 /**
- * Leaves the value "as-is" * Order-preserving? Yes * Self-delimiting? No * Compatibility? N/A
+ * Leaves the value as-is. Sorted mode: all values are supported. Distinct mode: all values are
+ * supported.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Bigtable Admin API. For a detailed explanation
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeInt64.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeInt64.java
@@ -31,22 +31,22 @@
 public final class GoogleBigtableAdminV2TypeInt64 extends com.google.api.client.json.GenericJson {
 
   /**
-   * The encoding to use when converting to/from lower level types.
+   * The encoding to use when converting to or from lower level types.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private GoogleBigtableAdminV2TypeInt64Encoding encoding;
 
   /**
-   * The encoding to use when converting to/from lower level types.
+   * The encoding to use when converting to or from lower level types.
    * @return value or {@code null} for none
    */
   public GoogleBigtableAdminV2TypeInt64Encoding getEncoding() {
     return encoding;
   }
 
   /**
-   * The encoding to use when converting to/from lower level types.
+   * The encoding to use when converting to or from lower level types.
    * @param encoding encoding or {@code null} for none
    */
   public GoogleBigtableAdminV2TypeInt64 setEncoding(GoogleBigtableAdminV2TypeInt64Encoding encoding) {
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeInt64Encoding.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeInt64Encoding.java
@@ -17,7 +17,7 @@
 package com.google.api.services.bigtableadmin.v2.model;
 
 /**
- * Rules used to convert to/from lower level types.
+ * Rules used to convert to or from lower level types.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Bigtable Admin API. For a detailed explanation
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeInt64EncodingBigEndianBytes.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeInt64EncodingBigEndianBytes.java
@@ -17,9 +17,10 @@
 package com.google.api.services.bigtableadmin.v2.model;
 
 /**
- * Encodes the value as an 8-byte big endian twos complement `Bytes` value. * Order-preserving? No
- * (positive values only) * Self-delimiting? Yes * Compatibility? - BigQuery Federation `BINARY`
- * encoding - HBase `Bytes.toBytes` - Java `ByteBuffer.putLong()` with `ByteOrder.BIG_ENDIAN`
+ * Encodes the value as an 8-byte big-endian two's complement value. Sorted mode: non-negative
+ * values are supported. Distinct mode: all values are supported. Compatible with: - BigQuery
+ * `BINARY` encoding - HBase `Bytes.toBytes` - Java `ByteBuffer.putLong()` with
+ * `ByteOrder.BIG_ENDIAN`
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Bigtable Admin API. For a detailed explanation
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeString.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeString.java
@@ -31,22 +31,22 @@
 public final class GoogleBigtableAdminV2TypeString extends com.google.api.client.json.GenericJson {
 
   /**
-   * The encoding to use when converting to/from lower level types.
+   * The encoding to use when converting to or from lower level types.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private GoogleBigtableAdminV2TypeStringEncoding encoding;
 
   /**
-   * The encoding to use when converting to/from lower level types.
+   * The encoding to use when converting to or from lower level types.
    * @return value or {@code null} for none
    */
   public GoogleBigtableAdminV2TypeStringEncoding getEncoding() {
     return encoding;
   }
 
   /**
-   * The encoding to use when converting to/from lower level types.
+   * The encoding to use when converting to or from lower level types.
    * @param encoding encoding or {@code null} for none
    */
   public GoogleBigtableAdminV2TypeString setEncoding(GoogleBigtableAdminV2TypeStringEncoding encoding) {
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeStringEncoding.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeStringEncoding.java
@@ -17,7 +17,7 @@
 package com.google.api.services.bigtableadmin.v2.model;
 
 /**
- * Rules used to convert to/from lower level types.
+ * Rules used to convert to or from lower level types.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Bigtable Admin API. For a detailed explanation
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeStringEncodingUtf8Bytes.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/GoogleBigtableAdminV2TypeStringEncodingUtf8Bytes.java
@@ -17,9 +17,9 @@
 package com.google.api.services.bigtableadmin.v2.model;
 
 /**
- * UTF-8 encoding * Order-preserving? Yes (code point order) * Self-delimiting? No * Compatibility?
- * - BigQuery Federation `TEXT` encoding - HBase `Bytes.toBytes` - Java
- * `String#getBytes(StandardCharsets.UTF_8)`
+ * UTF-8 encoding. Sorted mode: - All values are supported. - Code point order is preserved.
+ * Distinct mode: all values are supported. Compatible with: - BigQuery `TEXT` encoding - HBase
+ * `Bytes.toBytes` - Java `String#getBytes(StandardCharsets.UTF_8)`
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Bigtable Admin API. For a detailed explanation
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/Type.java b/clients/google-api-services-bigtableadmin/v2/2.0.0/com/google/api/services/bigtableadmin/v2/model/Type.java
@@ -20,18 +20,16 @@
  * `Type` represents the type of data that is written to, read from, or stored in Bigtable. It is
  * heavily based on the GoogleSQL standard to help maintain familiarity and consistency across
  * products and features. For compatibility with Bigtable's existing untyped APIs, each `Type`
- * includes an `Encoding` which describes how to convert to/from the underlying data. Each encoding
- * also defines the following properties: * Order-preserving: Does the encoded value sort
- * consistently with the original typed value? Note that Bigtable will always sort data based on the
- * raw encoded value, *not* the decoded type. - Example: BYTES values sort in the same order as
- * their raw encodings. - Counterexample: Encoding INT64 as a fixed-width decimal string does *not*
- * preserve sort order when dealing with negative numbers. `INT64(1) > INT64(-1)`, but
- * `STRING("-00001") > STRING("00001)`. * Self-delimiting: If we concatenate two encoded values, can
- * we always tell where the first one ends and the second one begins? - Example: If we encode INT64s
- * to fixed-width STRINGs, the first value will always contain exactly N digits, possibly preceded
- * by a sign. - Counterexample: If we concatenate two UTF-8 encoded STRINGs, we have no way to tell
- * where the first one ends. * Compatibility: Which other systems have matching encoding schemes?
- * For example, does this encoding have a GoogleSQL equivalent? HBase? Java?
+ * includes an `Encoding` which describes how to convert to or from the underlying data. Each
+ * encoding can operate in one of two modes: - Sorted: In this mode, Bigtable guarantees that
+ * `Encode(X) <= Encode(Y)` if and only if `X <= Y`. This is useful anywhere sort order is
+ * important, for example when encoding keys. - Distinct: In this mode, Bigtable guarantees that if
+ * `X != Y` then `Encode(X) != Encode(Y)`. However, the converse is not guaranteed. For example,
+ * both "{'foo': '1', 'bar': '2'}" and "{'bar': '2', 'foo': '1'}" are valid encodings of the same
+ * JSON value. The API clearly documents which mode is used wherever an encoding can be configured.
+ * Each encoding also documents which values are supported in which modes. For example, when
+ * encoding INT64 as a numeric STRING, negative numbers cannot be encoded in sorted mode. This is
+ * because `INT64(1) > INT64(-1)`, but `STRING("-00001") > STRING("00001")`.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Cloud Bigtable Admin API. For a detailed explanation
diff --git a/clients/google-api-services-bigtableadmin/v2/2.0.0/pom.xml b/clients/google-api-services-bigtableadmin/v2/2.0.0/pom.xml
@@ -8,8 +8,8 @@
 
   <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-bigtableadmin</artifactId>
-  <version>v2-rev20240918-2.0.0</version>
-  <name>Cloud Bigtable Admin API v2-rev20240918-2.0.0</name>
+  <version>v2-rev20241008-2.0.0</version>
+  <name>Cloud Bigtable Admin API v2-rev20241008-2.0.0</name>
   <packaging>jar</packaging>
 
   <inceptionYear>2011</inceptionYear>
diff --git a/clients/google-api-services-bigtableadmin/v2/README.md b/clients/google-api-services-bigtableadmin/v2/README.md
@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-bigtableadmin</artifactId>
-      <version>v2-rev20240918-2.0.0</version>
+      <version>v2-rev20241008-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-bigtableadmin:v2-rev20240918-2.0.0'
+  implementation 'com.google.apis:google-api-services-bigtableadmin:v2-rev20241008-2.0.0'
 }
 ```
 

Original file line number	Diff line number	Diff line change
`@@ -17,7 +17,7 @@`
`17`	`17`	`package com.google.api.services.bigtableadmin.v2.model;`
`18`	`18`
`19`	`19`	`/**`
`20`		`- * Rules used to convert to/from lower level types.`
	`20`	`+ * Rules used to convert to or from lower level types.`
`21`	`21`	`*`
`22`	`22`	`* <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is`
`23`	`23`	`* transmitted over HTTP when working with the Cloud Bigtable Admin API. For a detailed explanation`
Original file line number	Diff line number	Diff line change
`@@ -17,7 +17,8 @@`
`17`	`17`	`package com.google.api.services.bigtableadmin.v2.model;`
`18`	`18`
`19`	`19`	`/**`
`20`		`- * Leaves the value "as-is" * Order-preserving? Yes * Self-delimiting? No * Compatibility? N/A`
	`20`	`+ * Leaves the value as-is. Sorted mode: all values are supported. Distinct mode: all values are`
	`21`	`+ * supported.`
`21`	`22`	`*`
`22`	`23`	`* <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is`
`23`	`24`	`* transmitted over HTTP when working with the Cloud Bigtable Admin API. For a detailed explanation`