Method: projects.datasets.video.label

Starts a labeling task for video. The type of video labeling task is configured by feature in the request.

HTTP request

POST https://datalabeling.googleapis.com/v1beta1/{parent=projects/*/datasets/*}/video:label

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Name of the dataset to request labeling task, format: projects/{project_id}/datasets/{dataset_id}

Authorization requires the following Google IAM permission on the specified resource parent:

  • datalabeling.annotateddatasets.label

Request body

The request body contains data with the following structure:

JSON representation
{
  "basicConfig": {
    object (HumanAnnotationConfig)
  },
  "feature": enum (Feature),

  // Union field request_config can be only one of the following:
  "videoClassificationConfig": {
    object (VideoClassificationConfig)
  },
  "objectDetectionConfig": {
    object (ObjectDetectionConfig)
  },
  "objectTrackingConfig": {
    object (ObjectTrackingConfig)
  },
  "eventConfig": {
    object (EventConfig)
  }
  // End of list of possible types for union field request_config.
}
Fields
basicConfig

object (HumanAnnotationConfig)

Required. Basic human annotation config.

feature

enum (Feature)

Required. The type of video labeling task.

Union field request_config. Required. Config for labeling tasks. The type of request config must match the selected feature. request_config can be only one of the following:
videoClassificationConfig

object (VideoClassificationConfig)

Configuration for video classification task. One of videoClassificationConfig, objectDetectionConfig, objectTrackingConfig and eventConfig is required.

objectDetectionConfig

object (ObjectDetectionConfig)

Configuration for video object detection task. One of videoClassificationConfig, objectDetectionConfig, objectTrackingConfig and eventConfig is required.

objectTrackingConfig

object (ObjectTrackingConfig)

Configuration for video object tracking task. One of videoClassificationConfig, objectDetectionConfig, objectTrackingConfig and eventConfig is required.

eventConfig

object (EventConfig)

Configuration for video event task. One of videoClassificationConfig, objectDetectionConfig, objectTrackingConfig and eventConfig is required.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

Feature

Video labeling task feature.

Enums
FEATURE_UNSPECIFIED
CLASSIFICATION Label whole video or video segment with one or more labels.
OBJECT_DETECTION Label objects with bounding box on image frames extracted from the video.
OBJECT_TRACKING Label and track objects in video.
EVENT Label the range of video for the specified events.