Module types (1.14.0)

API documentation for videointelligence_v1p3beta1.types module.

Classes

AnnotateVideoProgress

Video annotation progress. Included in the metadata field of the Operation returned by the GetOperation call of the google::longrunning::Operations service.

AnnotateVideoRequest

Video annotation request.

The video data bytes. If unset, the input video(s) should be specified via input_uri. If set, input_uri should be unset.

Additional video context and/or feature-specific parameters.

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.

AnnotateVideoResponse

Video annotation response. Included in the response field of the Operation returned by the GetOperation call of the google::longrunning::Operations service.

Any

API documentation for videointelligence_v1p3beta1.types.Any class.

CancelOperationRequest

API documentation for videointelligence_v1p3beta1.types.CancelOperationRequest class.

Celebrity

Celebrity definition.

The celebrity name.

CelebrityRecognitionAnnotation

Celebrity recognition annotation per video.

CelebrityTrack

The annotation result of a celebrity face track. RecognizedCelebrity field could be empty if the face track does not have any matched celebrities.

A track of a person's face.

DeleteOperationRequest

API documentation for videointelligence_v1p3beta1.types.DeleteOperationRequest class.

DetectedAttribute

A generic detected attribute represented by name in string format.

Detected attribute confidence. Range [0, 1].

DetectedLandmark

A generic detected landmark represented by name in string format and a 2D location.

The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1.

Duration

API documentation for videointelligence_v1p3beta1.types.Duration class.

Entity

Detected entity from video analysis.

Textual description, e.g. Fixed-gear bicycle.

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.

ExplicitContentDetectionConfig

Config for EXPLICIT_CONTENT_DETECTION.

ExplicitContentFrame

Video frame level annotation results for explicit content.

Likelihood of the pornography content..

FaceDetectionAnnotation

Face detection annotation.

The thumbnail of a person's face.

FaceDetectionConfig

Config for FACE_DETECTION.

Whether bounding boxes be included in the face annotation output.

GetOperationRequest

API documentation for videointelligence_v1p3beta1.types.GetOperationRequest class.

LabelAnnotation

Label annotation.

Common categories for the detected entity. E.g. when the label is Terrier the category is likely dog. And in some cases there might be more than one categories e.g. Terrier could also be a pet.

All video frames where a label was detected.

LabelDetectionConfig

Config for LABEL_DETECTION.

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.

The confidence threshold we perform filtering on the labels from frame-level detection. If not set, it is set to 0.4 by default. The valid range for this threshold is [0.1, 0.9]. Any value set outside of this range will be clipped. Note: for best results please follow the default threshold. We will update the default threshold everytime when we release a new model.

LabelFrame

Video frame level annotation results for label detection.

Confidence that the label is accurate. Range: [0, 1].

LabelSegment

Video segment level annotation results for label detection.

Confidence that the label is accurate. Range: [0, 1].

ListOperationsRequest

API documentation for videointelligence_v1p3beta1.types.ListOperationsRequest class.

ListOperationsResponse

API documentation for videointelligence_v1p3beta1.types.ListOperationsResponse class.

LogoRecognitionAnnotation

Annotation corresponding to one detected, tracked and recognized logo class.

All logo tracks where the recognized logo appears. Each track corresponds to one logo instance appearing in consecutive frames.

NormalizedBoundingBox

Normalized bounding box. The normalized vertex coordinates are relative to the original image. Range: [0, 1].

Top Y coordinate.

Bottom Y coordinate.

NormalizedBoundingPoly

Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2

When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0

and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.

NormalizedVertex

X coordinate.

ObjectTrackingAnnotation

Annotations corresponding to one tracked object.

Object category's labeling confidence of this track.

Different representation of tracking info in non-streaming batch and streaming modes.

Streaming mode ONLY. In streaming mode, we do not know the end time of a tracked object before it is completed. Hence, there is no VideoSegment info returned. Instead, we provide a unique identifiable integer track_id so that the customers can correlate the results of the ongoing ObjectTrackAnnotation of the same track_id over time.

ObjectTrackingConfig

Config for OBJECT_TRACKING.

ObjectTrackingFrame

Video frame level annotations for object detection and tracking. This field stores per frame location, time offset, and confidence.

The timestamp of the frame in microseconds.

Operation

API documentation for videointelligence_v1p3beta1.types.Operation class.

OperationInfo

API documentation for videointelligence_v1p3beta1.types.OperationInfo class.

PersonDetectionAnnotation

Person detection annotation per video.

PersonDetectionConfig

Config for PERSON_DETECTION.

Whether to enable pose landmarks detection. Ignored if 'include_bounding_boxes' is false.

ShotChangeDetectionConfig

Config for SHOT_CHANGE_DETECTION.

SpeechContext

Provides "hints" to the speech recognizer to favor specific words and phrases in the results.

SpeechRecognitionAlternative

Alternative hypotheses (a.k.a. n-best list).

Output only. The confidence estimate between 0.0 and 1.0. A higher number indicates an estimated greater likelihood that the recognized words are correct. This field is set only for the top alternative. This field is not guaranteed to be accurate and users should not rely on it to be always provided. The default of 0.0 is a sentinel value indicating confidence was not set.

SpeechTranscription

A speech recognition result corresponding to a portion of the audio.

Output only. The BCP-47 <https://www.rfc- editor.org/rfc/bcp/bcp47.txt>__ language tag of the language in this result. This language code was detected to have the most likelihood of being spoken in the audio.

SpeechTranscriptionConfig

Config for SPEECH_TRANSCRIPTION.

Optional. Maximum number of recognition hypotheses to be returned. Specifically, the maximum number of SpeechRecognitionAlternative messages within each SpeechTranscription. The server may return fewer than max_alternatives. Valid values are 0-30. A value of 0 or 1 will return a maximum of one. If omitted, will return a maximum of one.

Optional. A means to provide context to assist the speech recognition.

Optional. For file formats, such as MXF or MKV, supporting multiple audio tracks, specify up to two tracks. Default: track 0.

Optional. If set, specifies the estimated number of speakers in the conversation. If not set, defaults to '2'. Ignored unless enable_speaker_diarization is set to true.

Status

API documentation for videointelligence_v1p3beta1.types.Status class.

StreamingAnnotateVideoRequest

The top-level message sent by the client for the StreamingAnnotateVideo method. Multiple StreamingAnnotateVideoRequest messages are sent. The first message must only contain a StreamingVideoConfig message. All subsequent messages must only contain input_content data.

Provides information to the annotator, specifing how to process the request. The first AnnotateStreamingVideoRequest message must only contain a video_config message.

StreamingAnnotateVideoResponse

\ StreamingAnnotateVideoResponse is the only message returned to the client by StreamingAnnotateVideo. A series of zero or more StreamingAnnotateVideoResponse messages are streamed back to the client.

Streaming annotation results.

StreamingAutomlClassificationConfig

Config for STREAMING_AUTOML_CLASSIFICATION.

StreamingAutomlObjectTrackingConfig

Config for STREAMING_AUTOML_OBJECT_TRACKING.

StreamingExplicitContentDetectionConfig

Config for STREAMING_EXPLICIT_CONTENT_DETECTION.

StreamingLabelDetectionConfig

Config for STREAMING_LABEL_DETECTION.

StreamingObjectTrackingConfig

Config for STREAMING_OBJECT_TRACKING.

StreamingShotChangeDetectionConfig

Config for STREAMING_SHOT_CHANGE_DETECTION.

StreamingStorageConfig

Config for streaming storage option.

GCS URI to store all annotation results for one client. Client should specify this field as the top-level storage directory. Annotation results of different sessions will be put into different sub-directories denoted by project_name and session_id. All sub-directories will be auto generated by program and will be made accessible to client in response proto. URIs must be specified in the following format: gs://bucket-id/object-id bucket-id should be a valid GCS bucket created by client and bucket permission shall also be configured properly. object-id can be arbitrary string that make sense to client. Other URI formats will return error and cause GCS write failure.

StreamingVideoAnnotationResults

Streaming annotation results corresponding to a portion of the video that is currently being processed.

Label annotation results.

Object tracking results.

StreamingVideoConfig

Provides information to the annotator that specifies how to process the request.

Config for requested annotation feature.

Config for STREAMING_LABEL_DETECTION.

Config for STREAMING_OBJECT_TRACKING.

Config for STREAMING_AUTOML_OBJECT_TRACKING.

TextAnnotation

Annotations related to one detected OCR text snippet. This will contain the corresponding text, confidence value, and frame level information for each detection.

All video segments where OCR detected text appears.

TextDetectionConfig

Config for TEXT_DETECTION.

Model to use for text detection. Supported values: "builtin/stable" (the default if unset) and "builtin/latest".

TextFrame

Video frame level annotation results for text annotation (OCR). Contains information regarding timestamp and bounding box locations for the frames containing detected OCR text snippets.

Timestamp of this frame.

TextSegment

Video segment level annotation results for text detection.

Confidence for the track of detected text. It is calculated as the highest over all frames where OCR detected text appears.

Timestamp

API documentation for videointelligence_v1p3beta1.types.Timestamp class.

TimestampedObject

For tracking related features. An object at time_offset with attributes, and located with normalized_bounding_box.

Time-offset, relative to the beginning of the video, corresponding to the video frame for this object.

Optional. The detected landmarks.

Track

A track of an object instance.

The object with timestamp and attributes per frame in the track.

Optional. The confidence score of the tracked object.

VideoAnnotationProgress

Annotation progress for a single video.

Approximate percentage processed thus far. Guaranteed to be 100 when fully processed.

Time of the most recent update.

Specifies which segment is being tracked if the request contains more than one segments.

VideoAnnotationResults

Annotation results for a single video.

Video segment on which the annotation is run.

Presence label annotations on video level or user specified segment level. There is exactly one element for each unique label. Compared to the existing topical segment_label_annotations, this field presents more fine- grained, segment-level labels detected in video content and is made available only when the client sets LabelDetectionConfig.model to "builtin/latest" in the request.

Presence label annotations on shot level. There is exactly one element for each unique label. Compared to the existing topical shot_label_annotations, this field presents more fine-grained, shot-level labels detected in video content and is made available only when the client sets LabelDetectionConfig.model to "builtin/latest" in the request.

Face detection annotations.

Explicit content annotation.

OCR text detection and tracking. Annotations for list of detected text snippets. Each will have list of frame information associated with it.

Annotations for list of logos detected, tracked and recognized in video.

Celebrity recognition annotations.

VideoContext

Video context and/or feature-specific parameters.

Config for LABEL_DETECTION.

Config for EXPLICIT_CONTENT_DETECTION.

Config for SPEECH_TRANSCRIPTION.

Config for PERSON_DETECTION.

VideoSegment

Video segment.

Time-offset, relative to the beginning of the video, corresponding to the end of the segment (inclusive).

WaitOperationRequest

API documentation for videointelligence_v1p3beta1.types.WaitOperationRequest class.

WordInfo

Word-specific information for recognized words. Word information is only included in the response when certain request parameters are set, such as enable_word_time_offsets.

Time offset relative to the beginning of the audio, and corresponding to the end of the spoken word. This field is only set if enable_word_time_offsets=true and only in the top hypothesis. This is an experimental feature and the accuracy of the time offset can vary.