docs: Keep the API doc up-to-date

google-cloud-retail/src/test/java/com/google/cloud/retail/v2/SearchServiceClientTest.java

@@ -140,6 +140,7 @@ public void searchTest() throws Exception {
     Assert.assertEquals(
         request.getVariantRollupKeysList(), actualRequest.getVariantRollupKeysList());
     Assert.assertEquals(request.getPageCategoriesList(), actualRequest.getPageCategoriesList());
+    Assert.assertEquals(request.getSearchMode(), actualRequest.getSearchMode());
     Assert.assertTrue(
         channelProvider.isHeaderSent(
             ApiClientHeaderProvider.getDefaultApiClientHeaderKey(),

proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddFulfillmentPlacesRequest.java

@@ -464,8 +464,8 @@ public com.google.protobuf.TimestampOrBuilder getAddTimeOrBuilder() {
    * If set to true, and the [Product][google.cloud.retail.v2.Product] is not
    * found, the fulfillment information will still be processed and retained for
    * at most 1 day and processed once the
-   * [Product][google.cloud.retail.v2.Product] is created. If set to false, an
-   * INVALID_ARGUMENT error is returned if the
+   * [Product][google.cloud.retail.v2.Product] is created. If set to false, a
+   * NOT_FOUND error is returned if the
    * [Product][google.cloud.retail.v2.Product] is not found.
    * </pre>
    *
@@ -492,10 +492,10 @@ public final boolean isInitialized() {
 
   @java.lang.Override
   public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
-    if (!getProductBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(product_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 1, product_);
     }
-    if (!getTypeBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(type_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 2, type_);
     }
     for (int i = 0; i < placeIds_.size(); i++) {
@@ -516,10 +516,10 @@ public int getSerializedSize() {
     if (size != -1) return size;
 
     size = 0;
-    if (!getProductBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(product_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(1, product_);
     }
-    if (!getTypeBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(type_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(2, type_);
     }
     {
@@ -1690,8 +1690,8 @@ public com.google.protobuf.TimestampOrBuilder getAddTimeOrBuilder() {
      * If set to true, and the [Product][google.cloud.retail.v2.Product] is not
      * found, the fulfillment information will still be processed and retained for
      * at most 1 day and processed once the
-     * [Product][google.cloud.retail.v2.Product] is created. If set to false, an
-     * INVALID_ARGUMENT error is returned if the
+     * [Product][google.cloud.retail.v2.Product] is created. If set to false, a
+     * NOT_FOUND error is returned if the
      * [Product][google.cloud.retail.v2.Product] is not found.
      * </pre>
      *
@@ -1710,8 +1710,8 @@ public boolean getAllowMissing() {
      * If set to true, and the [Product][google.cloud.retail.v2.Product] is not
      * found, the fulfillment information will still be processed and retained for
      * at most 1 day and processed once the
-     * [Product][google.cloud.retail.v2.Product] is created. If set to false, an
-     * INVALID_ARGUMENT error is returned if the
+     * [Product][google.cloud.retail.v2.Product] is created. If set to false, a
+     * NOT_FOUND error is returned if the
      * [Product][google.cloud.retail.v2.Product] is not found.
      * </pre>
      *
@@ -1733,8 +1733,8 @@ public Builder setAllowMissing(boolean value) {
      * If set to true, and the [Product][google.cloud.retail.v2.Product] is not
      * found, the fulfillment information will still be processed and retained for
      * at most 1 day and processed once the
-     * [Product][google.cloud.retail.v2.Product] is created. If set to false, an
-     * INVALID_ARGUMENT error is returned if the
+     * [Product][google.cloud.retail.v2.Product] is created. If set to false, a
+     * NOT_FOUND error is returned if the
      * [Product][google.cloud.retail.v2.Product] is not found.
      * </pre>
      *

proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddFulfillmentPlacesRequestOrBuilder.java

@@ -262,8 +262,8 @@ public interface AddFulfillmentPlacesRequestOrBuilder
    * If set to true, and the [Product][google.cloud.retail.v2.Product] is not
    * found, the fulfillment information will still be processed and retained for
    * at most 1 day and processed once the
-   * [Product][google.cloud.retail.v2.Product] is created. If set to false, an
-   * INVALID_ARGUMENT error is returned if the
+   * [Product][google.cloud.retail.v2.Product] is created. If set to false, a
+   * NOT_FOUND error is returned if the
    * [Product][google.cloud.retail.v2.Product] is not found.
    * </pre>
    *

proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddFulfillmentPlacesResponse.java

@@ -22,7 +22,7 @@
  *
  *
  * <pre>
- * Response of the RemoveFulfillmentPlacesRequest.  Currently empty because
+ * Response of the AddFulfillmentPlacesRequest.  Currently empty because
  * there is no meaningful response populated from the [AddFulfillmentPlaces][]
  * method.
  * </pre>
@@ -259,7 +259,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
-   * Response of the RemoveFulfillmentPlacesRequest.  Currently empty because
+   * Response of the AddFulfillmentPlacesRequest.  Currently empty because
    * there is no meaningful response populated from the [AddFulfillmentPlaces][]
    * method.
    * </pre>

proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/BigQuerySource.java

@@ -554,19 +554,19 @@ public final boolean isInitialized() {
 
   @java.lang.Override
   public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
-    if (!getDatasetIdBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(datasetId_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 1, datasetId_);
     }
-    if (!getTableIdBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(tableId_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 2, tableId_);
     }
-    if (!getGcsStagingDirBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(gcsStagingDir_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 3, gcsStagingDir_);
     }
-    if (!getDataSchemaBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(dataSchema_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 4, dataSchema_);
     }
-    if (!getProjectIdBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(projectId_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 5, projectId_);
     }
     if (partitionCase_ == 6) {
@@ -581,19 +581,19 @@ public int getSerializedSize() {
     if (size != -1) return size;
 
     size = 0;
-    if (!getDatasetIdBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(datasetId_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(1, datasetId_);
     }
-    if (!getTableIdBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(tableId_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(2, tableId_);
     }
-    if (!getGcsStagingDirBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(gcsStagingDir_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(3, gcsStagingDir_);
     }
-    if (!getDataSchemaBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(dataSchema_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(4, dataSchema_);
     }
-    if (!getProjectIdBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(projectId_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(5, projectId_);
     }
     if (partitionCase_ == 6) {

proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Catalog.java

@@ -313,10 +313,10 @@ public final boolean isInitialized() {
 
   @java.lang.Override
   public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
-    if (!getNameBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(name_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 1, name_);
     }
-    if (!getDisplayNameBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(displayName_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 2, displayName_);
     }
     if (productLevelConfig_ != null) {
@@ -331,10 +331,10 @@ public int getSerializedSize() {
     if (size != -1) return size;
 
     size = 0;
-    if (!getNameBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(name_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(1, name_);
     }
-    if (!getDisplayNameBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(displayName_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(2, displayName_);
     }
     if (productLevelConfig_ != null) {

proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CollectUserEventRequest.java

@@ -323,13 +323,13 @@ public final boolean isInitialized() {
 
   @java.lang.Override
   public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
-    if (!getParentBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(parent_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 1, parent_);
     }
-    if (!getUserEventBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(userEvent_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 2, userEvent_);
     }
-    if (!getUriBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(uri_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 3, uri_);
     }
     if (ets_ != 0L) {
@@ -344,13 +344,13 @@ public int getSerializedSize() {
     if (size != -1) return size;
 
     size = 0;
-    if (!getParentBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(parent_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(1, parent_);
     }
-    if (!getUserEventBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(userEvent_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(2, userEvent_);
     }
-    if (!getUriBytes().isEmpty()) {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(uri_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(3, uri_);
     }
     if (ets_ != 0L) {

proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ColorInfo.java

@@ -243,7 +243,7 @@ public com.google.protobuf.ByteString getColorFamiliesBytes(int index) {
    * names, such as the color aliases used in the website frontend. Normally
    * it is expected to have only 1 color. May consider using single "Mixed"
    * instead of multiple values.
-   * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+   * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
    * string with a length limit of 128 characters. Otherwise, an
    * INVALID_ARGUMENT error is returned.
    * Google Merchant Center property
@@ -266,7 +266,7 @@ public com.google.protobuf.ProtocolStringList getColorsList() {
    * names, such as the color aliases used in the website frontend. Normally
    * it is expected to have only 1 color. May consider using single "Mixed"
    * instead of multiple values.
-   * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+   * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
    * string with a length limit of 128 characters. Otherwise, an
    * INVALID_ARGUMENT error is returned.
    * Google Merchant Center property
@@ -289,7 +289,7 @@ public int getColorsCount() {
    * names, such as the color aliases used in the website frontend. Normally
    * it is expected to have only 1 color. May consider using single "Mixed"
    * instead of multiple values.
-   * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+   * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
    * string with a length limit of 128 characters. Otherwise, an
    * INVALID_ARGUMENT error is returned.
    * Google Merchant Center property
@@ -313,7 +313,7 @@ public java.lang.String getColors(int index) {
    * names, such as the color aliases used in the website frontend. Normally
    * it is expected to have only 1 color. May consider using single "Mixed"
    * instead of multiple values.
-   * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+   * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
    * string with a length limit of 128 characters. Otherwise, an
    * INVALID_ARGUMENT error is returned.
    * Google Merchant Center property
@@ -971,7 +971,7 @@ private void ensureColorsIsMutable() {
      * names, such as the color aliases used in the website frontend. Normally
      * it is expected to have only 1 color. May consider using single "Mixed"
      * instead of multiple values.
-     * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+     * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
      * string with a length limit of 128 characters. Otherwise, an
      * INVALID_ARGUMENT error is returned.
      * Google Merchant Center property
@@ -994,7 +994,7 @@ public com.google.protobuf.ProtocolStringList getColorsList() {
      * names, such as the color aliases used in the website frontend. Normally
      * it is expected to have only 1 color. May consider using single "Mixed"
      * instead of multiple values.
-     * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+     * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
      * string with a length limit of 128 characters. Otherwise, an
      * INVALID_ARGUMENT error is returned.
      * Google Merchant Center property
@@ -1017,7 +1017,7 @@ public int getColorsCount() {
      * names, such as the color aliases used in the website frontend. Normally
      * it is expected to have only 1 color. May consider using single "Mixed"
      * instead of multiple values.
-     * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+     * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
      * string with a length limit of 128 characters. Otherwise, an
      * INVALID_ARGUMENT error is returned.
      * Google Merchant Center property
@@ -1041,7 +1041,7 @@ public java.lang.String getColors(int index) {
      * names, such as the color aliases used in the website frontend. Normally
      * it is expected to have only 1 color. May consider using single "Mixed"
      * instead of multiple values.
-     * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+     * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
      * string with a length limit of 128 characters. Otherwise, an
      * INVALID_ARGUMENT error is returned.
      * Google Merchant Center property
@@ -1065,7 +1065,7 @@ public com.google.protobuf.ByteString getColorsBytes(int index) {
      * names, such as the color aliases used in the website frontend. Normally
      * it is expected to have only 1 color. May consider using single "Mixed"
      * instead of multiple values.
-     * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+     * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
      * string with a length limit of 128 characters. Otherwise, an
      * INVALID_ARGUMENT error is returned.
      * Google Merchant Center property
@@ -1096,7 +1096,7 @@ public Builder setColors(int index, java.lang.String value) {
      * names, such as the color aliases used in the website frontend. Normally
      * it is expected to have only 1 color. May consider using single "Mixed"
      * instead of multiple values.
-     * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+     * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
      * string with a length limit of 128 characters. Otherwise, an
      * INVALID_ARGUMENT error is returned.
      * Google Merchant Center property
@@ -1126,7 +1126,7 @@ public Builder addColors(java.lang.String value) {
      * names, such as the color aliases used in the website frontend. Normally
      * it is expected to have only 1 color. May consider using single "Mixed"
      * instead of multiple values.
-     * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+     * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
      * string with a length limit of 128 characters. Otherwise, an
      * INVALID_ARGUMENT error is returned.
      * Google Merchant Center property
@@ -1153,7 +1153,7 @@ public Builder addAllColors(java.lang.Iterable<java.lang.String> values) {
      * names, such as the color aliases used in the website frontend. Normally
      * it is expected to have only 1 color. May consider using single "Mixed"
      * instead of multiple values.
-     * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+     * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
      * string with a length limit of 128 characters. Otherwise, an
      * INVALID_ARGUMENT error is returned.
      * Google Merchant Center property
@@ -1179,7 +1179,7 @@ public Builder clearColors() {
      * names, such as the color aliases used in the website frontend. Normally
      * it is expected to have only 1 color. May consider using single "Mixed"
      * instead of multiple values.
-     * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+     * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
      * string with a length limit of 128 characters. Otherwise, an
      * INVALID_ARGUMENT error is returned.
      * Google Merchant Center property

proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ColorInfoOrBuilder.java

@@ -122,7 +122,7 @@ public interface ColorInfoOrBuilder
    * names, such as the color aliases used in the website frontend. Normally
    * it is expected to have only 1 color. May consider using single "Mixed"
    * instead of multiple values.
-   * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+   * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
    * string with a length limit of 128 characters. Otherwise, an
    * INVALID_ARGUMENT error is returned.
    * Google Merchant Center property
@@ -143,7 +143,7 @@ public interface ColorInfoOrBuilder
    * names, such as the color aliases used in the website frontend. Normally
    * it is expected to have only 1 color. May consider using single "Mixed"
    * instead of multiple values.
-   * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+   * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
    * string with a length limit of 128 characters. Otherwise, an
    * INVALID_ARGUMENT error is returned.
    * Google Merchant Center property
@@ -164,7 +164,7 @@ public interface ColorInfoOrBuilder
    * names, such as the color aliases used in the website frontend. Normally
    * it is expected to have only 1 color. May consider using single "Mixed"
    * instead of multiple values.
-   * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+   * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
    * string with a length limit of 128 characters. Otherwise, an
    * INVALID_ARGUMENT error is returned.
    * Google Merchant Center property
@@ -186,7 +186,7 @@ public interface ColorInfoOrBuilder
    * names, such as the color aliases used in the website frontend. Normally
    * it is expected to have only 1 color. May consider using single "Mixed"
    * instead of multiple values.
-   * A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+   * A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
    * string with a length limit of 128 characters. Otherwise, an
    * INVALID_ARGUMENT error is returned.
    * Google Merchant Center property