Types for Google Cloud Video Intelligence API Client¶
-
class
google.cloud.videointelligence_v1beta2.types.
AnnotateVideoProgress
¶ Video annotation progress. Included in the
metadata
field of theOperation
returned by theGetOperation
call of thegoogle::longrunning::Operations
service.-
annotation_progress
¶ Progress metadata for all videos specified in
AnnotateVideoRequest
.
-
annotation_progress
Field google.cloud.videointelligence.v1beta2.AnnotateVideoProgress.annotation_progress
-
-
class
google.cloud.videointelligence_v1beta2.types.
AnnotateVideoRequest
¶ Video annotation request.
-
input_uri
¶ Input video location. Currently, only Google Cloud Storage URIs are supported, which 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. A video URI may include wildcards inobject-id
, and thus identify multiple videos. Supported wildcards: ‘*’ to match 0 or more characters; ‘?’ to match 1 character. If unset, the input video should be embedded in the request asinput_content
. If set,input_content
should be unset.
-
input_content
¶ The video data bytes. If unset, the input video(s) should be specified via
input_uri
. If set,input_uri
should be unset.
-
features
¶ Requested video annotation features.
-
video_context
¶ Additional video context and/or feature-specific parameters.
-
output_uri
¶ Optional location where the output (in JSON format) should be stored. Currently, only Google Cloud Storage URIs are supported, which 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.
-
location_id
¶ 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.
-
features
Field google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.features
-
input_content
Field google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.input_content
-
input_uri
Field google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.input_uri
-
location_id
Field google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.location_id
-
output_uri
Field google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.output_uri
-
video_context
Field google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.video_context
-
-
class
google.cloud.videointelligence_v1beta2.types.
AnnotateVideoResponse
¶ Video annotation response. Included in the
response
field of theOperation
returned by theGetOperation
call of thegoogle::longrunning::Operations
service.-
annotation_results
¶ Annotation results for all videos specified in
AnnotateVideoRequest
.
-
annotation_results
Field google.cloud.videointelligence.v1beta2.AnnotateVideoResponse.annotation_results
-
-
class
google.cloud.videointelligence_v1beta2.types.
Any
¶ -
type_url
¶ Field google.protobuf.Any.type_url
-
value
¶ Field google.protobuf.Any.value
-
-
class
google.cloud.videointelligence_v1beta2.types.
CancelOperationRequest
¶ -
name
¶ Field google.longrunning.CancelOperationRequest.name
-
-
class
google.cloud.videointelligence_v1beta2.types.
DeleteOperationRequest
¶ -
name
¶ Field google.longrunning.DeleteOperationRequest.name
-
-
class
google.cloud.videointelligence_v1beta2.types.
Duration
¶ -
nanos
¶ Field google.protobuf.Duration.nanos
-
seconds
¶ Field google.protobuf.Duration.seconds
-
-
class
google.cloud.videointelligence_v1beta2.types.
Entity
¶ Detected entity from video analysis.
-
entity_id
¶ Opaque entity ID. Some IDs may be available in Google Knowledge Graph Search API.
-
description
¶ Textual description, e.g.
Fixed-gear bicycle
.
-
language_code
¶ Language code for
description
in BCP-47 format.
-
description
Field google.cloud.videointelligence.v1beta2.Entity.description
-
entity_id
Field google.cloud.videointelligence.v1beta2.Entity.entity_id
-
language_code
Field google.cloud.videointelligence.v1beta2.Entity.language_code
-
-
class
google.cloud.videointelligence_v1beta2.types.
ExplicitContentAnnotation
¶ Explicit content annotation (based on per-frame visual signals only). If no explicit content has been detected in a frame, no annotations are present for that frame.
-
frames
¶ All video frames where explicit content was detected.
-
frames
Field google.cloud.videointelligence.v1beta2.ExplicitContentAnnotation.frames
-
-
class
google.cloud.videointelligence_v1beta2.types.
ExplicitContentDetectionConfig
¶ Config for EXPLICIT_CONTENT_DETECTION.
-
model
¶ Model to use for explicit content detection. Supported values: “builtin/stable” (the default if unset) and “builtin/latest”.
-
model
Field google.cloud.videointelligence.v1beta2.ExplicitContentDetectionConfig.model
-
-
class
google.cloud.videointelligence_v1beta2.types.
ExplicitContentFrame
¶ Video frame level annotation results for explicit content.
-
time_offset
¶ Time-offset, relative to the beginning of the video, corresponding to the video frame for this location.
-
pornography_likelihood
¶ Likelihood of the pornography content..
-
pornography_likelihood
Field google.cloud.videointelligence.v1beta2.ExplicitContentFrame.pornography_likelihood
-
time_offset
Field google.cloud.videointelligence.v1beta2.ExplicitContentFrame.time_offset
-
-
class
google.cloud.videointelligence_v1beta2.types.
FaceAnnotation
¶ Face annotation.
-
thumbnail
¶ Thumbnail of a representative face view (in JPEG format).
-
segments
¶ All video segments where a face was detected.
-
frames
¶ All video frames where a face was detected.
-
frames
Field google.cloud.videointelligence.v1beta2.FaceAnnotation.frames
-
segments
Field google.cloud.videointelligence.v1beta2.FaceAnnotation.segments
-
thumbnail
Field google.cloud.videointelligence.v1beta2.FaceAnnotation.thumbnail
-
-
class
google.cloud.videointelligence_v1beta2.types.
FaceDetectionConfig
¶ Config for FACE_DETECTION.
-
model
¶ Model to use for face detection. Supported values: “builtin/stable” (the default if unset) and “builtin/latest”.
-
include_bounding_boxes
¶ Whether bounding boxes be included in the face annotation output.
-
include_bounding_boxes
Field google.cloud.videointelligence.v1beta2.FaceDetectionConfig.include_bounding_boxes
-
model
Field google.cloud.videointelligence.v1beta2.FaceDetectionConfig.model
-
-
class
google.cloud.videointelligence_v1beta2.types.
FaceFrame
¶ Video frame level annotation results for face detection.
-
normalized_bounding_boxes
¶ Normalized Bounding boxes in a frame. There can be more than one boxes if the same face is detected in multiple locations within the current frame.
-
time_offset
¶ Time-offset, relative to the beginning of the video, corresponding to the video frame for this location.
-
normalized_bounding_boxes
Field google.cloud.videointelligence.v1beta2.FaceFrame.normalized_bounding_boxes
-
time_offset
Field google.cloud.videointelligence.v1beta2.FaceFrame.time_offset
-
-
class
google.cloud.videointelligence_v1beta2.types.
FaceSegment
¶ Video segment level annotation results for face detection.
-
segment
¶ Video segment where a face was detected.
-
segment
Field google.cloud.videointelligence.v1beta2.FaceSegment.segment
-
-
class
google.cloud.videointelligence_v1beta2.types.
GetOperationRequest
¶ -
name
¶ Field google.longrunning.GetOperationRequest.name
-
-
class
google.cloud.videointelligence_v1beta2.types.
LabelAnnotation
¶ Label annotation.
-
entity
¶ Detected entity.
-
category_entities
¶ Common categories for the detected entity. E.g. when the label is
Terrier
the category is likelydog
. And in some cases there might be more than one categories e.g.Terrier
could also be apet
.
-
segments
¶ All video segments where a label was detected.
-
frames
¶ All video frames where a label was detected.
-
category_entities
Field google.cloud.videointelligence.v1beta2.LabelAnnotation.category_entities
-
entity
Field google.cloud.videointelligence.v1beta2.LabelAnnotation.entity
-
frames
Field google.cloud.videointelligence.v1beta2.LabelAnnotation.frames
-
segments
Field google.cloud.videointelligence.v1beta2.LabelAnnotation.segments
-
-
class
google.cloud.videointelligence_v1beta2.types.
LabelDetectionConfig
¶ Config for LABEL_DETECTION.
-
label_detection_mode
¶ What labels should be detected with LABEL_DETECTION, in addition to video-level labels or segment-level labels. If unspecified, defaults to
SHOT_MODE
.
-
stationary_camera
¶ Whether the video has been shot from a stationary (i.e. non- moving) camera. When set to true, might improve detection accuracy for moving objects. Should be used with
SHOT_AND_FRAME_MODE
enabled.
-
model
¶ Model to use for label detection. Supported values: “builtin/stable” (the default if unset) and “builtin/latest”.
-
label_detection_mode
Field google.cloud.videointelligence.v1beta2.LabelDetectionConfig.label_detection_mode
-
model
Field google.cloud.videointelligence.v1beta2.LabelDetectionConfig.model
-
stationary_camera
Field google.cloud.videointelligence.v1beta2.LabelDetectionConfig.stationary_camera
-
-
class
google.cloud.videointelligence_v1beta2.types.
LabelFrame
¶ Video frame level annotation results for label detection.
-
time_offset
¶ Time-offset, relative to the beginning of the video, corresponding to the video frame for this location.
-
confidence
¶ Confidence that the label is accurate. Range: [0, 1].
-
confidence
Field google.cloud.videointelligence.v1beta2.LabelFrame.confidence
-
time_offset
Field google.cloud.videointelligence.v1beta2.LabelFrame.time_offset
-
-
class
google.cloud.videointelligence_v1beta2.types.
LabelSegment
¶ Video segment level annotation results for label detection.
-
segment
¶ Video segment where a label was detected.
-
confidence
¶ Confidence that the label is accurate. Range: [0, 1].
-
confidence
Field google.cloud.videointelligence.v1beta2.LabelSegment.confidence
-
segment
Field google.cloud.videointelligence.v1beta2.LabelSegment.segment
-
-
class
google.cloud.videointelligence_v1beta2.types.
ListOperationsRequest
¶ -
filter
¶ Field google.longrunning.ListOperationsRequest.filter
-
name
¶ Field google.longrunning.ListOperationsRequest.name
-
page_size
¶ Field google.longrunning.ListOperationsRequest.page_size
-
page_token
¶ Field google.longrunning.ListOperationsRequest.page_token
-
-
class
google.cloud.videointelligence_v1beta2.types.
ListOperationsResponse
¶ -
next_page_token
¶ Field google.longrunning.ListOperationsResponse.next_page_token
-
operations
¶ Field google.longrunning.ListOperationsResponse.operations
-
-
class
google.cloud.videointelligence_v1beta2.types.
NormalizedBoundingBox
¶ Normalized bounding box. The normalized vertex coordinates are relative to the original image. Range: [0, 1].
-
left
¶ Left X coordinate.
-
top
¶ Top Y coordinate.
-
right
¶ Right X coordinate.
-
bottom
¶ Bottom Y coordinate.
-
bottom
Field google.cloud.videointelligence.v1beta2.NormalizedBoundingBox.bottom
-
left
Field google.cloud.videointelligence.v1beta2.NormalizedBoundingBox.left
-
right
Field google.cloud.videointelligence.v1beta2.NormalizedBoundingBox.right
-
top
Field google.cloud.videointelligence.v1beta2.NormalizedBoundingBox.top
-
-
class
google.cloud.videointelligence_v1beta2.types.
Operation
¶ -
deserialize
()¶ Creates new method instance from given serialized data.
-
done
¶ Field google.longrunning.Operation.done
-
error
¶ Field google.longrunning.Operation.error
-
metadata
¶ Field google.longrunning.Operation.metadata
-
name
¶ Field google.longrunning.Operation.name
-
response
¶ Field google.longrunning.Operation.response
-
-
class
google.cloud.videointelligence_v1beta2.types.
OperationInfo
¶ -
metadata_type
¶ Field google.longrunning.OperationInfo.metadata_type
-
response_type
¶ Field google.longrunning.OperationInfo.response_type
-
-
class
google.cloud.videointelligence_v1beta2.types.
ShotChangeDetectionConfig
¶ Config for SHOT_CHANGE_DETECTION.
-
model
¶ Model to use for shot change detection. Supported values: “builtin/stable” (the default if unset) and “builtin/latest”.
-
model
Field google.cloud.videointelligence.v1beta2.ShotChangeDetectionConfig.model
-
-
class
google.cloud.videointelligence_v1beta2.types.
Status
¶ -
code
¶ Field google.rpc.Status.code
-
details
¶ Field google.rpc.Status.details
-
message
¶ Field google.rpc.Status.message
-
-
class
google.cloud.videointelligence_v1beta2.types.
Timestamp
¶ -
nanos
¶ Field google.protobuf.Timestamp.nanos
-
seconds
¶ Field google.protobuf.Timestamp.seconds
-
-
class
google.cloud.videointelligence_v1beta2.types.
VideoAnnotationProgress
¶ Annotation progress for a single video.
-
input_uri
¶ Video file location in Google Cloud Storage.
-
progress_percent
¶ Approximate percentage processed thus far. Guaranteed to be 100 when fully processed.
-
start_time
¶ Time when the request was received.
-
update_time
¶ Time of the most recent update.
-
input_uri
Field google.cloud.videointelligence.v1beta2.VideoAnnotationProgress.input_uri
-
progress_percent
Field google.cloud.videointelligence.v1beta2.VideoAnnotationProgress.progress_percent
-
start_time
Field google.cloud.videointelligence.v1beta2.VideoAnnotationProgress.start_time
-
update_time
Field google.cloud.videointelligence.v1beta2.VideoAnnotationProgress.update_time
-
-
class
google.cloud.videointelligence_v1beta2.types.
VideoAnnotationResults
¶ Annotation results for a single video.
-
input_uri
¶ Video file location in Google Cloud Storage.
-
segment_label_annotations
¶ Label annotations on video level or user specified segment level. There is exactly one element for each unique label.
-
shot_label_annotations
¶ Label annotations on shot level. There is exactly one element for each unique label.
-
frame_label_annotations
¶ Label annotations on frame level. There is exactly one element for each unique label.
-
face_annotations
¶ Face annotations. There is exactly one element for each unique face.
-
shot_annotations
¶ Shot annotations. Each shot is represented as a video segment.
-
explicit_annotation
¶ Explicit content annotation.
-
error
¶ If set, indicates an error. Note that for a single
AnnotateVideoRequest
some videos may succeed and some may fail.
-
error
Field google.cloud.videointelligence.v1beta2.VideoAnnotationResults.error
-
explicit_annotation
Field google.cloud.videointelligence.v1beta2.VideoAnnotationResults.explicit_annotation
-
face_annotations
Field google.cloud.videointelligence.v1beta2.VideoAnnotationResults.face_annotations
-
frame_label_annotations
Field google.cloud.videointelligence.v1beta2.VideoAnnotationResults.frame_label_annotations
-
input_uri
Field google.cloud.videointelligence.v1beta2.VideoAnnotationResults.input_uri
-
segment_label_annotations
Field google.cloud.videointelligence.v1beta2.VideoAnnotationResults.segment_label_annotations
-
shot_annotations
Field google.cloud.videointelligence.v1beta2.VideoAnnotationResults.shot_annotations
-
shot_label_annotations
Field google.cloud.videointelligence.v1beta2.VideoAnnotationResults.shot_label_annotations
-
-
class
google.cloud.videointelligence_v1beta2.types.
VideoContext
¶ Video context and/or feature-specific parameters.
-
segments
¶ Video segments to annotate. The segments may overlap and are not required to be contiguous or span the whole video. If unspecified, each video is treated as a single segment.
-
label_detection_config
¶ Config for LABEL_DETECTION.
-
shot_change_detection_config
¶ Config for SHOT_CHANGE_DETECTION.
-
explicit_content_detection_config
¶ Config for EXPLICIT_CONTENT_DETECTION.
-
face_detection_config
¶ Config for FACE_DETECTION.
-
explicit_content_detection_config
Field google.cloud.videointelligence.v1beta2.VideoContext.explicit_content_detection_config
-
face_detection_config
Field google.cloud.videointelligence.v1beta2.VideoContext.face_detection_config
-
label_detection_config
Field google.cloud.videointelligence.v1beta2.VideoContext.label_detection_config
-
segments
Field google.cloud.videointelligence.v1beta2.VideoContext.segments
-
shot_change_detection_config
Field google.cloud.videointelligence.v1beta2.VideoContext.shot_change_detection_config
-
-
class
google.cloud.videointelligence_v1beta2.types.
VideoSegment
¶ Video segment.
-
start_time_offset
¶ Time-offset, relative to the beginning of the video, corresponding to the start of the segment (inclusive).
-
end_time_offset
¶ Time-offset, relative to the beginning of the video, corresponding to the end of the segment (inclusive).
-
end_time_offset
Field google.cloud.videointelligence.v1beta2.VideoSegment.end_time_offset
-
start_time_offset
Field google.cloud.videointelligence.v1beta2.VideoSegment.start_time_offset
-