API documentation for datalabeling_v1beta1.types package.
Classes
AnnotatedDataset
AnnotatedDataset is a set holding annotations for data in a Dataset. Each labeling task will generate an AnnotatedDataset under the Dataset that the task is requested for.
AnnotatedDatasetMetadata
Metadata on AnnotatedDataset.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
Annotation
Annotation for Example. Each example may have one or more annotations. For example in image classification problem, each image might have one or more labels. We call labels binded with this image an Annotation.
AnnotationMetadata
Additional information associated with the annotation.
AnnotationSentiment
Values: ANNOTATION_SENTIMENT_UNSPECIFIED (0): No description available. NEGATIVE (1): This annotation describes negatively about the data. POSITIVE (2): This label describes positively about the data.
AnnotationSource
Specifies where the annotation comes from (whether it was provided by a human labeler or a different source).
Values: ANNOTATION_SOURCE_UNSPECIFIED (0): No description available. OPERATOR (3): Answer is provided by a human contributor.
AnnotationSpec
Container of information related to one possible annotation that can
be used in a labeling task. For example, an image classification
task where images are labeled as dog or cat must reference
an AnnotationSpec for dog and an AnnotationSpec for cat.
AnnotationSpecSet
An AnnotationSpecSet is a collection of label definitions. For example, in image classification tasks, you define a set of possible labels for images as an AnnotationSpecSet. An AnnotationSpecSet is immutable upon creation.
AnnotationType
Values: ANNOTATION_TYPE_UNSPECIFIED (0): No description available. IMAGE_CLASSIFICATION_ANNOTATION (1): Classification annotations in an image. Allowed for continuous evaluation. IMAGE_BOUNDING_BOX_ANNOTATION (2): Bounding box annotations in an image. A form of image object detection. Allowed for continuous evaluation. IMAGE_ORIENTED_BOUNDING_BOX_ANNOTATION (13): Oriented bounding box. The box does not have to be parallel to horizontal line. IMAGE_BOUNDING_POLY_ANNOTATION (10): Bounding poly annotations in an image. IMAGE_POLYLINE_ANNOTATION (11): Polyline annotations in an image. IMAGE_SEGMENTATION_ANNOTATION (12): Segmentation annotations in an image. VIDEO_SHOTS_CLASSIFICATION_ANNOTATION (3): Classification annotations in video shots. VIDEO_OBJECT_TRACKING_ANNOTATION (4): Video object tracking annotation. VIDEO_OBJECT_DETECTION_ANNOTATION (5): Video object detection annotation. VIDEO_EVENT_ANNOTATION (6): Video event annotation. TEXT_CLASSIFICATION_ANNOTATION (8): Classification for text. Allowed for continuous evaluation. TEXT_ENTITY_EXTRACTION_ANNOTATION (9): Entity extraction for text. GENERAL_CLASSIFICATION_ANNOTATION (14): General classification. Allowed for continuous evaluation.
AnnotationValue
Annotation value for an example.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
Attempt
Records a failed evaluation job run.
BigQuerySource
The BigQuery location for input data. If used in an EvaluationJob, this is where the service saves the prediction input and output sampled from the model version.
BoundingBoxEvaluationOptions
Options regarding evaluation between bounding boxes.
BoundingPoly
A bounding polygon in the image.
BoundingPolyConfig
Config for image bounding poly (and bounding box) human labeling task.
ClassificationMetadata
Metadata for classification annotations.
ClassificationMetrics
Metrics calculated for a classification model.
ConfusionMatrix
Confusion matrix of the model running the classification. Only applicable when the metrics entry aggregates multiple labels. Not applicable when the entry is for a single label.
CreateAnnotationSpecSetRequest
Request message for CreateAnnotationSpecSet.
CreateDatasetRequest
Request message for CreateDataset.
CreateEvaluationJobRequest
Request message for CreateEvaluationJob.
CreateInstructionMetadata
Metadata of a CreateInstruction operation.
CreateInstructionRequest
Request message for CreateInstruction.
CsvInstruction
Deprecated: this instruction format is not supported any more. Instruction from a CSV file.
DataItem
DataItem is a piece of data, without annotation. For example, an image.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
DataType
Values: DATA_TYPE_UNSPECIFIED (0): No description available. IMAGE (1): Allowed for continuous evaluation. VIDEO (2): No description available. TEXT (4): Allowed for continuous evaluation. GENERAL_DATA (6): Allowed for continuous evaluation.
Dataset
Dataset is the resource to hold your data. You can request multiple labeling tasks for a dataset while each one will generate an AnnotatedDataset.
DeleteAnnotatedDatasetRequest
Request message for DeleteAnnotatedDataset.
DeleteAnnotationSpecSetRequest
Request message for DeleteAnnotationSpecSet.
DeleteDatasetRequest
Request message for DeleteDataset.
DeleteEvaluationJobRequest
Request message DeleteEvaluationJob.
DeleteInstructionRequest
Request message for DeleteInstruction.
Evaluation
Describes an evaluation between a machine learning model's predictions and ground truth labels. Created when an EvaluationJob runs successfully.
EvaluationConfig
Configuration details used for calculating evaluation metrics and creating an Evaluation.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
EvaluationJob
Defines an evaluation job that runs periodically to generate
Evaluations.
Creating an evaluation
job </ml-engine/docs/continuous-evaluation/create-job>__ is the
starting point for using continuous evaluation.
EvaluationJobAlertConfig
Provides details for how an evaluation job sends email alerts based on the results of a run.
EvaluationJobConfig
Configures specific details of how a continuous evaluation job works. Provide this configuration when you create an EvaluationJob.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
EvaluationMetrics
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
EventConfig
Config for video event human labeling task.
Example
An Example is a piece of data and its annotation. For example, an image with label "house".
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
ExportDataOperationMetadata
Metadata of an ExportData operation.
ExportDataOperationResponse
Response used for ExportDataset longrunning operation.
ExportDataRequest
Request message for ExportData API.
GcsDestination
Export destination of the data.Only gcs path is allowed in output_uri.
GcsFolderDestination
Export folder destination of the data.
GcsSource
Source of the Cloud Storage file to be imported.
GetAnnotatedDatasetRequest
Request message for GetAnnotatedDataset.
GetAnnotationSpecSetRequest
Request message for GetAnnotationSpecSet.
GetDataItemRequest
Request message for GetDataItem.
GetDatasetRequest
Request message for GetDataSet.
GetEvaluationJobRequest
Request message for GetEvaluationJob.
GetEvaluationRequest
Request message for GetEvaluation.
GetExampleRequest
Request message for GetExample
GetInstructionRequest
Request message for GetInstruction.
HumanAnnotationConfig
Configuration for how human labeling task should be done.
ImageBoundingPolyAnnotation
Image bounding poly annotation. It represents a polygon including bounding box in the image.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
ImageClassificationAnnotation
Image classification annotation definition.
ImageClassificationConfig
Config for image classification human labeling task.
ImagePayload
Container of information about an image.
ImagePolylineAnnotation
A polyline for the image annotation.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
ImageSegmentationAnnotation
Image segmentation annotation.
ImportDataOperationMetadata
Metadata of an ImportData operation.
ImportDataOperationResponse
Response used for ImportData longrunning operation.
ImportDataRequest
Request message for ImportData API.
InputConfig
The configuration of input data, including data type, location, etc.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
Instruction
Instruction of how to perform the labeling task for human operators. Currently only PDF instruction is supported.
LabelImageBoundingBoxOperationMetadata
Details of a LabelImageBoundingBox operation metadata.
LabelImageBoundingPolyOperationMetadata
Details of LabelImageBoundingPoly operation metadata.
LabelImageClassificationOperationMetadata
Metadata of a LabelImageClassification operation.
LabelImageOrientedBoundingBoxOperationMetadata
Details of a LabelImageOrientedBoundingBox operation metadata.
LabelImagePolylineOperationMetadata
Details of LabelImagePolyline operation metadata.
LabelImageRequest
Request message for starting an image labeling task.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
LabelImageSegmentationOperationMetadata
Details of a LabelImageSegmentation operation metadata.
LabelOperationMetadata
Metadata of a labeling operation, such as LabelImage or LabelVideo. Next tag: 20
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
LabelStats
Statistics about annotation specs.
LabelTextClassificationOperationMetadata
Details of a LabelTextClassification operation metadata.
LabelTextEntityExtractionOperationMetadata
Details of a LabelTextEntityExtraction operation metadata.
LabelTextRequest
Request message for LabelText.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
LabelVideoClassificationOperationMetadata
Details of a LabelVideoClassification operation metadata.
LabelVideoEventOperationMetadata
Details of a LabelVideoEvent operation metadata.
LabelVideoObjectDetectionOperationMetadata
Details of a LabelVideoObjectDetection operation metadata.
LabelVideoObjectTrackingOperationMetadata
Details of a LabelVideoObjectTracking operation metadata.
LabelVideoRequest
Request message for LabelVideo.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
ListAnnotatedDatasetsRequest
Request message for ListAnnotatedDatasets.
ListAnnotatedDatasetsResponse
Results of listing annotated datasets for a dataset.
ListAnnotationSpecSetsRequest
Request message for ListAnnotationSpecSets.
ListAnnotationSpecSetsResponse
Results of listing annotation spec set under a project.
ListDataItemsRequest
Request message for ListDataItems.
ListDataItemsResponse
Results of listing data items in a dataset.
ListDatasetsRequest
Request message for ListDataset.
ListDatasetsResponse
Results of listing datasets within a project.
ListEvaluationJobsRequest
Request message for ListEvaluationJobs.
ListEvaluationJobsResponse
Results for listing evaluation jobs.
ListExamplesRequest
Request message for ListExamples.
ListExamplesResponse
Results of listing Examples in and annotated dataset.
ListInstructionsRequest
Request message for ListInstructions.
ListInstructionsResponse
Results of listing instructions under a project.
NormalizedBoundingPoly
Normalized bounding polygon.
NormalizedPolyline
Normalized polyline.
NormalizedVertex
A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.
ObjectDetectionConfig
Config for video object detection human labeling task. Object detection will be conducted on the images extracted from the video, and those objects will be labeled with bounding boxes. User need to specify the number of images to be extracted per second as the extraction frame rate.
ObjectDetectionMetrics
Metrics calculated for an image object detection (bounding box) model.
ObjectTrackingConfig
Config for video object tracking human labeling task.
ObjectTrackingFrame
Video frame level annotation for object detection and tracking.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
OperatorMetadata
General information useful for labels coming from contributors.
OutputConfig
The configuration of output data.
This message has oneof_ fields (mutually exclusive fields).
For each oneof, at most one member field can be set at the same time.
Setting any member of the oneof automatically clears all other
members.
.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields
PauseEvaluationJobRequest
Request message for PauseEvaluationJob.
PdfInstruction
Instruction from a PDF file.
Polyline
A line with multiple line segments.
PolylineConfig
Config for image polyline human labeling task.
PrCurve
ResumeEvaluationJobRequest
Request message ResumeEvaluationJob.
SearchEvaluationsRequest
Request message for SearchEvaluation.
SearchEvaluationsResponse
Results of searching evaluations.
SearchExampleComparisonsRequest
Request message of SearchExampleComparisons.
SearchExampleComparisonsResponse
Results of searching example comparisons.
SegmentationConfig
Config for image segmentation
SentimentConfig
Config for setting up sentiments.
SequentialSegment
Start and end position in a sequence (e.g. text segment).
StringAggregationType
Values: STRING_AGGREGATION_TYPE_UNSPECIFIED (0): No description available. MAJORITY_VOTE (1): Majority vote to aggregate answers. UNANIMOUS_VOTE (2): Unanimous answers will be adopted. NO_AGGREGATION (3): Preserve all answers by crowd compute.
TextClassificationAnnotation
Text classification annotation.
TextClassificationConfig
Config for text classification human labeling task.
TextEntityExtractionAnnotation
Text entity extraction annotation.
TextEntityExtractionConfig
Config for text entity extraction human labeling task.
TextMetadata
Metadata for the text.
TextPayload
Container of information about a piece of text.
TimeSegment
A time period inside of an example that has a time dimension (e.g. video).
UpdateEvaluationJobRequest
Request message for UpdateEvaluationJob.
Vertex
A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.
VideoClassificationAnnotation
Video classification annotation.
VideoClassificationConfig
Config for video classification human labeling task. Currently two types of video classification are supported:
- Assign labels on the entire video.
- Split the video into multiple video clips based on camera shot, and assign labels on each video clip.
VideoEventAnnotation
Video event annotation.
VideoObjectTrackingAnnotation
Video object tracking annotation.
VideoPayload
Container of information of a video.
VideoThumbnail
Container of information of a video thumbnail.