docs(regen): regenerate v1p1beta1, v1p2beta1, v1p3beta1, v1p4beta1 clients with annotations (#53)

Author: yoshi-automation

.kokoro/linkage-monitor.sh

@@ -23,7 +23,12 @@ cd github/java-vision/
 java -version
 echo ${JOB_TYPE}
 
-mvn install -DskipTests=true -Dmaven.javadoc.skip=true -Dgcloud.download.skip=true -B -V
+mvn install -B -V \
+ -DskipTests=true \
+ -Dclirr.skip=true \
+ -Denforcer.skip=true \
+ -Dmaven.javadoc.skip=true \
+ -Dgcloud.download.skip=true
 
 # Kokoro job cloud-opensource-java/ubuntu/linkage-monitor-gcs creates this JAR
 JAR=linkage-monitor-latest-all-deps.jar

google-cloud-vision/src/main/java/com/google/cloud/vision/v1p1beta1/ImageAnnotatorClient.java

@@ -160,7 +160,7 @@ public ImageAnnotatorStub getStub() {
  * }
  * </code></pre>
  *
- * @param requests Individual image annotation requests for this batch.
+ * @param requests Required. Individual image annotation requests for this batch.
  * @throws com.google.api.gax.rpc.ApiException if the remote call fails
  */
  public final BatchAnnotateImagesResponse batchAnnotateImages(

google-cloud-vision/src/main/java/com/google/cloud/vision/v1p2beta1/ImageAnnotatorClient.java

@@ -177,7 +177,7 @@ public final OperationsClient getOperationsClient() {
  * }
  * </code></pre>
  *
- * @param requests Individual image annotation requests for this batch.
+ * @param requests Required. Individual image annotation requests for this batch.
  * @throws com.google.api.gax.rpc.ApiException if the remote call fails
  */
  public final BatchAnnotateImagesResponse batchAnnotateImages(
@@ -250,7 +250,7 @@ public final BatchAnnotateImagesResponse batchAnnotateImages(BatchAnnotateImages
  * }
  * </code></pre>
  *
- * @param requests Individual async file annotation requests for this batch.
+ * @param requests Required. Individual async file annotation requests for this batch.
  * @throws com.google.api.gax.rpc.ApiException if the remote call fails
  */
  @BetaApi(

google-cloud-vision/src/main/java/com/google/cloud/vision/v1p3beta1/ImageAnnotatorClient.java

@@ -250,7 +250,7 @@ public final BatchAnnotateImagesResponse batchAnnotateImages(BatchAnnotateImages
  * }
  * </code></pre>
  *
- * @param requests Individual async file annotation requests for this batch.
+ * @param requests Required. Individual async file annotation requests for this batch.
  * @throws com.google.api.gax.rpc.ApiException if the remote call fails
  */
  @BetaApi(

google-cloud-vision/src/main/java/com/google/cloud/vision/v1p3beta1/ProductSearchClient.java

@@ -177,7 +177,7 @@ public final OperationsClient getOperationsClient() {
  * }
  * </code></pre>
  *
- * @param requests Individual image annotation requests for this batch.
+ * @param requests Required. Individual image annotation requests for this batch.
  * @throws com.google.api.gax.rpc.ApiException if the remote call fails
  */
  public final BatchAnnotateImagesResponse batchAnnotateImages(

google-cloud-vision/src/main/java/com/google/cloud/vision/v1p4beta1/ImageAnnotatorClient.java

@@ -502,7 +502,7 @@ public final ListProductSetsPagedResponse listProductSets(ListProductSetsRequest
  * </code></pre>
  *
  * @param name Required. Resource name of the ProductSet to get.
- * <p>Format is: `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
+ * <p>Format is: `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
  * @throws com.google.api.gax.rpc.ApiException if the remote call fails
  */
  public final ProductSet getProductSet(ProductSetName name) {
@@ -529,7 +529,7 @@ public final ProductSet getProductSet(ProductSetName name) {
  * </code></pre>
  *
  * @param name Required. Resource name of the ProductSet to get.
- * <p>Format is: `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
+ * <p>Format is: `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
  * @throws com.google.api.gax.rpc.ApiException if the remote call fails
  */
  public final ProductSet getProductSet(String name) {

google-cloud-vision/src/main/java/com/google/cloud/vision/v1p4beta1/ProductSearchClient.java

@@ -28,17 +28,13 @@
  * <pre>
  * Manages Products and ProductSets of reference images for use in product
  * search. It uses the following resource model:
- * - The API has a collection of
- * [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
+ * - The API has a collection of [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;productSets/&#42;`, which acts as a way to put different
  * products into groups to limit identification.
  * In parallel,
- * - The API has a collection of
- * [Product][google.cloud.vision.v1p3beta1.Product] resources, named
+ * - The API has a collection of [Product][google.cloud.vision.v1p3beta1.Product] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;products/&#42;`
- * - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of
- * [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources,
- * named
+ * - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;products/&#42;&#47;referenceImages/&#42;`
  * </pre>
  */
@@ -1127,17 +1123,13 @@ public static ProductSearchFutureStub newFutureStub(io.grpc.Channel channel) {
  * <pre>
  * Manages Products and ProductSets of reference images for use in product
  * search. It uses the following resource model:
- * - The API has a collection of
- * [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
+ * - The API has a collection of [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;productSets/&#42;`, which acts as a way to put different
  * products into groups to limit identification.
  * In parallel,
- * - The API has a collection of
- * [Product][google.cloud.vision.v1p3beta1.Product] resources, named
+ * - The API has a collection of [Product][google.cloud.vision.v1p3beta1.Product] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;products/&#42;`
- * - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of
- * [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources,
- * named
+ * - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;products/&#42;&#47;referenceImages/&#42;`
  * </pre>
  */
@@ -1602,17 +1594,13 @@ public final io.grpc.ServerServiceDefinition bindService() {
  * <pre>
  * Manages Products and ProductSets of reference images for use in product
  * search. It uses the following resource model:
- * - The API has a collection of
- * [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
+ * - The API has a collection of [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;productSets/&#42;`, which acts as a way to put different
  * products into groups to limit identification.
  * In parallel,
- * - The API has a collection of
- * [Product][google.cloud.vision.v1p3beta1.Product] resources, named
+ * - The API has a collection of [Product][google.cloud.vision.v1p3beta1.Product] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;products/&#42;`
- * - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of
- * [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources,
- * named
+ * - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;products/&#42;&#47;referenceImages/&#42;`
  * </pre>
  */
@@ -2020,17 +2008,13 @@ public void importProductSets(
  * <pre>
  * Manages Products and ProductSets of reference images for use in product
  * search. It uses the following resource model:
- * - The API has a collection of
- * [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
+ * - The API has a collection of [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;productSets/&#42;`, which acts as a way to put different
  * products into groups to limit identification.
  * In parallel,
- * - The API has a collection of
- * [Product][google.cloud.vision.v1p3beta1.Product] resources, named
+ * - The API has a collection of [Product][google.cloud.vision.v1p3beta1.Product] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;products/&#42;`
- * - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of
- * [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources,
- * named
+ * - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;products/&#42;&#47;referenceImages/&#42;`
  * </pre>
  */
@@ -2377,17 +2361,13 @@ public com.google.longrunning.Operation importProductSets(
  * <pre>
  * Manages Products and ProductSets of reference images for use in product
  * search. It uses the following resource model:
- * - The API has a collection of
- * [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
+ * - The API has a collection of [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;productSets/&#42;`, which acts as a way to put different
  * products into groups to limit identification.
  * In parallel,
- * - The API has a collection of
- * [Product][google.cloud.vision.v1p3beta1.Product] resources, named
+ * - The API has a collection of [Product][google.cloud.vision.v1p3beta1.Product] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;products/&#42;`
- * - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of
- * [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources,
- * named
+ * - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources, named
  * `projects/&#42;&#47;locations/&#42;&#47;products/&#42;&#47;referenceImages/&#42;`
  * </pre>
  */