feat(v1): add PersonDetection and FaceDetection (#263)

PiperOrigin-RevId: 334093713 Source-Author: Google APIs <noreply@google.com> Source-Date: Sun Sep 27 23:41:00 2020 -0700 Source-Repo: googleapis/googleapis Source-Sha: e7375a91e7942c562c61495a908f4f6d50b4ea3f Source-Link: googleapis/googleapis@e7375a9
googleapis · Sep 30, 2020 · 4942fe4 · 4942fe4
1 parent 8eb40c3
commit 4942fe4
Show file tree

Hide file tree

Showing 49 changed files with 7,339 additions and 1,793 deletions.
diff --git a/...e/src/main/java/com/google/cloud/videointelligence/v1/VideoIntelligenceServiceClient.java b/...e/src/main/java/com/google/cloud/videointelligence/v1/VideoIntelligenceServiceClient.java
@@ -31,7 +31,7 @@
 
 // AUTO-GENERATED DOCUMENTATION AND SERVICE
 /**
- * Service Description: Service that implements Google Cloud Video Intelligence API.
+ * Service Description: Service that implements the Video Intelligence API.
  *
  * <p>This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
@@ -185,15 +185,15 @@ public final OperationsClient getOperationsClient() {
    * }
    * </code></pre>
    *
-   * @param inputUri Input video location. Currently, only [Google Cloud
-   *     Storage](https://cloud.google.com/storage/) URIs are supported, which must be specified in
+   * @param inputUri Input video location. Currently, only [Cloud
+   *     Storage](https://cloud.google.com/storage/) URIs are supported. URIs must be specified in
    *     the following format: `gs://bucket-id/object-id` (other URI formats return
    *     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more
-   *     information, see [Request URIs](https://cloud.google.com/storage/docs/request-endpoints). A
-   *     video URI may include wildcards in `object-id`, and thus identify multiple videos.
+   *     information, see [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+   *     To identify multiple videos, a video URI may include wildcards in the `object-id`.
    *     Supported wildcards: '&#42;' to match 0 or more characters; '?' to match 1 character. If
    *     unset, the input video should be embedded in the request as `input_content`. If set,
-   *     `input_content` should be unset.
+   *     `input_content` must be unset.
    * @param features Required. Requested video annotation features.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */

diff --git a/...-video-intelligence/src/main/java/com/google/cloud/videointelligence/v1/package-info.java b/...-video-intelligence/src/main/java/com/google/cloud/videointelligence/v1/package-info.java
@@ -21,7 +21,7 @@
  *
  * <p>============================== VideoIntelligenceServiceClient ==============================
  *
- * <p>Service Description: Service that implements Google Cloud Video Intelligence API.
+ * <p>Service Description: Service that implements the Video Intelligence API.
  *
  * <p>Sample for VideoIntelligenceServiceClient:
  *

diff --git a/...-v1/src/main/java/com/google/cloud/videointelligence/v1/VideoIntelligenceServiceGrpc.java b/...-v1/src/main/java/com/google/cloud/videointelligence/v1/VideoIntelligenceServiceGrpc.java
@@ -26,7 +26,7 @@
  *
  *
  * <pre>
- * Service that implements Google Cloud Video Intelligence API.
+ * Service that implements the Video Intelligence API.
  * </pre>
  */
 @javax.annotation.Generated(
@@ -132,7 +132,7 @@ public VideoIntelligenceServiceFutureStub newStub(
    *
    *
    * <pre>
-   * Service that implements Google Cloud Video Intelligence API.
+   * Service that implements the Video Intelligence API.
    * </pre>
    */
   public abstract static class VideoIntelligenceServiceImplBase implements io.grpc.BindableService {
@@ -170,7 +170,7 @@ public final io.grpc.ServerServiceDefinition bindService() {
    *
    *
    * <pre>
-   * Service that implements Google Cloud Video Intelligence API.
+   * Service that implements the Video Intelligence API.
    * </pre>
    */
   public static final class VideoIntelligenceServiceStub
@@ -209,7 +209,7 @@ public void annotateVideo(
    *
    *
    * <pre>
-   * Service that implements Google Cloud Video Intelligence API.
+   * Service that implements the Video Intelligence API.
    * </pre>
    */
   public static final class VideoIntelligenceServiceBlockingStub
@@ -245,7 +245,7 @@ public com.google.longrunning.Operation annotateVideo(
    *
    *
    * <pre>
-   * Service that implements Google Cloud Video Intelligence API.
+   * Service that implements the Video Intelligence API.
    * </pre>
    */
   public static final class VideoIntelligenceServiceFutureStub

diff --git a/...lligence-v1/src/main/java/com/google/cloud/videointelligence/v1/AnnotateVideoRequest.java b/...lligence-v1/src/main/java/com/google/cloud/videointelligence/v1/AnnotateVideoRequest.java
diff --git a/...v1/src/main/java/com/google/cloud/videointelligence/v1/AnnotateVideoRequestOrBuilder.java b/...v1/src/main/java/com/google/cloud/videointelligence/v1/AnnotateVideoRequestOrBuilder.java
@@ -28,15 +28,16 @@ public interface AnnotateVideoRequestOrBuilder
    *
    * <pre>
    * Input video location. Currently, only
-   * [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
-   * supported, which must be specified in the following format:
+   * [Cloud Storage](https://cloud.google.com/storage/) URIs are
+   * supported. URIs must be specified in the following format:
    * `gs://bucket-id/object-id` (other URI formats return
-   * [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
-   * [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
-   * A video URI may include wildcards in `object-id`, and thus identify
-   * multiple videos. Supported wildcards: '*' to match 0 or more characters;
+   * [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
+   * more information, see [Request
+   * URIs](https://cloud.google.com/storage/docs/request-endpoints). To identify
+   * multiple videos, a video URI may include wildcards in the `object-id`.
+   * Supported wildcards: '*' to match 0 or more characters;
    * '?' to match 1 character. If unset, the input video should be embedded
-   * in the request as `input_content`. If set, `input_content` should be unset.
+   * in the request as `input_content`. If set, `input_content` must be unset.
    * </pre>
    *
    * <code>string input_uri = 1;</code>
@@ -49,15 +50,16 @@ public interface AnnotateVideoRequestOrBuilder
    *
    * <pre>
    * Input video location. Currently, only
-   * [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
-   * supported, which must be specified in the following format:
+   * [Cloud Storage](https://cloud.google.com/storage/) URIs are
+   * supported. URIs must be specified in the following format:
    * `gs://bucket-id/object-id` (other URI formats return
-   * [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
-   * [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
-   * A video URI may include wildcards in `object-id`, and thus identify
-   * multiple videos. Supported wildcards: '*' to match 0 or more characters;
+   * [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
+   * more information, see [Request
+   * URIs](https://cloud.google.com/storage/docs/request-endpoints). To identify
+   * multiple videos, a video URI may include wildcards in the `object-id`.
+   * Supported wildcards: '*' to match 0 or more characters;
    * '?' to match 1 character. If unset, the input video should be embedded
-   * in the request as `input_content`. If set, `input_content` should be unset.
+   * in the request as `input_content`. If set, `input_content` must be unset.
    * </pre>
    *
    * <code>string input_uri = 1;</code>
@@ -71,8 +73,8 @@ public interface AnnotateVideoRequestOrBuilder
    *
    * <pre>
    * The video data bytes.
-   * If unset, the input video(s) should be specified via `input_uri`.
-   * If set, `input_uri` should be unset.
+   * If unset, the input video(s) should be specified via the `input_uri`.
+   * If set, `input_uri` must be unset.
    * </pre>
    *
    * <code>bytes input_content = 6;</code>
@@ -194,11 +196,12 @@ public interface AnnotateVideoRequestOrBuilder
    *
    * <pre>
    * Optional. Location where the output (in JSON format) should be stored.
-   * Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
-   * URIs are supported, which must be specified in the following format:
+   * Currently, only [Cloud Storage](https://cloud.google.com/storage/)
+   * URIs are supported. These must be specified in the following format:
    * `gs://bucket-id/object-id` (other URI formats return
-   * [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
-   * [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+   * [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
+   * more information, see [Request
+   * URIs](https://cloud.google.com/storage/docs/request-endpoints).
    * </pre>
    *
    * <code>string output_uri = 4 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -211,11 +214,12 @@ public interface AnnotateVideoRequestOrBuilder
    *
    * <pre>
    * Optional. Location where the output (in JSON format) should be stored.
-   * Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
-   * URIs are supported, which must be specified in the following format:
+   * Currently, only [Cloud Storage](https://cloud.google.com/storage/)
+   * URIs are supported. These must be specified in the following format:
    * `gs://bucket-id/object-id` (other URI formats return
-   * [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
-   * [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+   * [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
+   * more information, see [Request
+   * URIs](https://cloud.google.com/storage/docs/request-endpoints).
    * </pre>
    *
    * <code>string output_uri = 4 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -229,8 +233,9 @@ public interface AnnotateVideoRequestOrBuilder
    *
    * <pre>
    * Optional. Cloud region where annotation should take place. Supported cloud
-   * regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
-   * is specified, a region will be determined based on video file location.
+   * regions are: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no
+   * region is specified, the region will be determined based on video file
+   * location.
    * </pre>
    *
    * <code>string location_id = 5 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -243,8 +248,9 @@ public interface AnnotateVideoRequestOrBuilder
    *
    * <pre>
    * Optional. Cloud region where annotation should take place. Supported cloud
-   * regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
-   * is specified, a region will be determined based on video file location.
+   * regions are: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no
+   * region is specified, the region will be determined based on video file
+   * location.
    * </pre>
    *
    * <code>string location_id = 5 [(.google.api.field_behavior) = OPTIONAL];</code>

diff --git a/...ntelligence-v1/src/main/java/com/google/cloud/videointelligence/v1/DetectedAttribute.java b/...ntelligence-v1/src/main/java/com/google/cloud/videointelligence/v1/DetectedAttribute.java
@@ -130,7 +130,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * <pre>
-   * The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+   * The name of the attribute, for example, glasses, dark_glasses, mouth_open.
    * A full list of supported type names will be provided in the document.
    * </pre>
    *
@@ -154,7 +154,7 @@ public java.lang.String getName() {
    *
    *
    * <pre>
-   * The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+   * The name of the attribute, for example, glasses, dark_glasses, mouth_open.
    * A full list of supported type names will be provided in the document.
    * </pre>
    *
@@ -600,7 +600,7 @@ public Builder mergeFrom(
      *
      *
      * <pre>
-     * The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+     * The name of the attribute, for example, glasses, dark_glasses, mouth_open.
      * A full list of supported type names will be provided in the document.
      * </pre>
      *
@@ -623,7 +623,7 @@ public java.lang.String getName() {
      *
      *
      * <pre>
-     * The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+     * The name of the attribute, for example, glasses, dark_glasses, mouth_open.
      * A full list of supported type names will be provided in the document.
      * </pre>
      *
@@ -646,7 +646,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      *
      * <pre>
-     * The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+     * The name of the attribute, for example, glasses, dark_glasses, mouth_open.
      * A full list of supported type names will be provided in the document.
      * </pre>
      *
@@ -668,7 +668,7 @@ public Builder setName(java.lang.String value) {
      *
      *
      * <pre>
-     * The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+     * The name of the attribute, for example, glasses, dark_glasses, mouth_open.
      * A full list of supported type names will be provided in the document.
      * </pre>
      *
@@ -686,7 +686,7 @@ public Builder clearName() {
      *
      *
      * <pre>
-     * The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+     * The name of the attribute, for example, glasses, dark_glasses, mouth_open.
      * A full list of supported type names will be provided in the document.
      * </pre>
      *

diff --git a/...ce-v1/src/main/java/com/google/cloud/videointelligence/v1/DetectedAttributeOrBuilder.java b/...ce-v1/src/main/java/com/google/cloud/videointelligence/v1/DetectedAttributeOrBuilder.java
@@ -27,7 +27,7 @@ public interface DetectedAttributeOrBuilder
    *
    *
    * <pre>
-   * The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+   * The name of the attribute, for example, glasses, dark_glasses, mouth_open.
    * A full list of supported type names will be provided in the document.
    * </pre>
    *
@@ -40,7 +40,7 @@ public interface DetectedAttributeOrBuilder
    *
    *
    * <pre>
-   * The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+   * The name of the attribute, for example, glasses, dark_glasses, mouth_open.
    * A full list of supported type names will be provided in the document.
    * </pre>
    *

diff --git a/...intelligence-v1/src/main/java/com/google/cloud/videointelligence/v1/DetectedLandmark.java b/...intelligence-v1/src/main/java/com/google/cloud/videointelligence/v1/DetectedLandmark.java
@@ -140,7 +140,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * <pre>
-   * The name of this landmark, i.e. left_hand, right_shoulder.
+   * The name of this landmark, for example, left_hand, right_shoulder.
    * </pre>
    *
    * <code>string name = 1;</code>
@@ -163,7 +163,7 @@ public java.lang.String getName() {
    *
    *
    * <pre>
-   * The name of this landmark, i.e. left_hand, right_shoulder.
+   * The name of this landmark, for example, left_hand, right_shoulder.
    * </pre>
    *
    * <code>string name = 1;</code>
@@ -621,7 +621,7 @@ public Builder mergeFrom(
      *
      *
      * <pre>
-     * The name of this landmark, i.e. left_hand, right_shoulder.
+     * The name of this landmark, for example, left_hand, right_shoulder.
      * </pre>
      *
      * <code>string name = 1;</code>
@@ -643,7 +643,7 @@ public java.lang.String getName() {
      *
      *
      * <pre>
-     * The name of this landmark, i.e. left_hand, right_shoulder.
+     * The name of this landmark, for example, left_hand, right_shoulder.
      * </pre>
      *
      * <code>string name = 1;</code>
@@ -665,7 +665,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      *
      * <pre>
-     * The name of this landmark, i.e. left_hand, right_shoulder.
+     * The name of this landmark, for example, left_hand, right_shoulder.
      * </pre>
      *
      * <code>string name = 1;</code>
@@ -686,7 +686,7 @@ public Builder setName(java.lang.String value) {
      *
      *
      * <pre>
-     * The name of this landmark, i.e. left_hand, right_shoulder.
+     * The name of this landmark, for example, left_hand, right_shoulder.
      * </pre>
      *
      * <code>string name = 1;</code>
@@ -703,7 +703,7 @@ public Builder clearName() {
      *
      *
      * <pre>
-     * The name of this landmark, i.e. left_hand, right_shoulder.
+     * The name of this landmark, for example, left_hand, right_shoulder.
      * </pre>
      *
      * <code>string name = 1;</code>

diff --git a/...nce-v1/src/main/java/com/google/cloud/videointelligence/v1/DetectedLandmarkOrBuilder.java b/...nce-v1/src/main/java/com/google/cloud/videointelligence/v1/DetectedLandmarkOrBuilder.java
@@ -27,7 +27,7 @@ public interface DetectedLandmarkOrBuilder
    *
    *
    * <pre>
-   * The name of this landmark, i.e. left_hand, right_shoulder.
+   * The name of this landmark, for example, left_hand, right_shoulder.
    * </pre>
    *
    * <code>string name = 1;</code>
@@ -39,7 +39,7 @@ public interface DetectedLandmarkOrBuilder
    *
    *
    * <pre>
-   * The name of this landmark, i.e. left_hand, right_shoulder.
+   * The name of this landmark, for example, left_hand, right_shoulder.
    * </pre>
    *
    * <code>string name = 1;</code>