Google Cloud Ai Platform V1 Client - Class DataLabelingJob (0.20.0)

Reference documentation and code samples for the Google Cloud Ai Platform V1 Client class DataLabelingJob.

DataLabelingJob is used to trigger a human labeling job on unlabeled data from the following Dataset:

Generated from protobuf message google.cloud.aiplatform.v1.DataLabelingJob

Namespace

Google \ Cloud \ AIPlatform \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ name string

Output only. Resource name of the DataLabelingJob.

↳ display_name string

Required. The user-defined name of the DataLabelingJob. The name can be up to 128 characters long and can consist of any UTF-8 characters. Display name of a DataLabelingJob.

↳ datasets array

Required. Dataset resource names. Right now we only support labeling from a single Dataset. Format: projects/{project}/locations/{location}/datasets/{dataset}

↳ annotation_labels array|Google\Protobuf\Internal\MapField

Labels to assign to annotations generated by this DataLabelingJob. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable.

↳ labeler_count int

Required. Number of labelers to work on each DataItem.

↳ instruction_uri string

Required. The Google Cloud Storage location of the instruction pdf. This pdf is shared with labelers, and provides detailed description on how to label DataItems in Datasets.

↳ inputs_schema_uri string

Required. Points to a YAML file stored on Google Cloud Storage describing the config for a specific type of DataLabelingJob. The schema files that can be used here are found in the https://storage.googleapis.com/google-cloud-aiplatform bucket in the /schema/datalabelingjob/inputs/ folder.

↳ inputs Google\Protobuf\Value

Required. Input config parameters for the DataLabelingJob.

↳ state int

Output only. The detailed state of the job.

↳ labeling_progress int

Output only. Current labeling job progress percentage scaled in interval [0, 100], indicating the percentage of DataItems that has been finished.

↳ current_spend Google\Type\Money

Output only. Estimated cost(in US dollars) that the DataLabelingJob has incurred to date.

↳ create_time Google\Protobuf\Timestamp

Output only. Timestamp when this DataLabelingJob was created.

↳ update_time Google\Protobuf\Timestamp

Output only. Timestamp when this DataLabelingJob was updated most recently.

↳ error Google\Rpc\Status

Output only. DataLabelingJob errors. It is only populated when job's state is JOB_STATE_FAILED or JOB_STATE_CANCELLED.

↳ labels array|Google\Protobuf\Internal\MapField

The labels with user-defined metadata to organize your DataLabelingJobs. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable. Following system labels exist for each DataLabelingJob: * "aiplatform.googleapis.com/schema": output only, its value is the inputs_schema's title.

↳ specialist_pools array

The SpecialistPools' resource names associated with this job.

↳ encryption_spec Google\Cloud\AIPlatform\V1\EncryptionSpec

Customer-managed encryption key spec for a DataLabelingJob. If set, this DataLabelingJob will be secured by this key. Note: Annotations created in the DataLabelingJob are associated with the EncryptionSpec of the Dataset they are exported to.

↳ active_learning_config Google\Cloud\AIPlatform\V1\ActiveLearningConfig

Parameters that configure the active learning pipeline. Active learning will label the data incrementally via several iterations. For every iteration, it will select a batch of data based on the sampling strategy.

getName

Output only. Resource name of the DataLabelingJob.

Returns
TypeDescription
string

setName

Output only. Resource name of the DataLabelingJob.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDisplayName

Required. The user-defined name of the DataLabelingJob.

The name can be up to 128 characters long and can consist of any UTF-8 characters. Display name of a DataLabelingJob.

Returns
TypeDescription
string

setDisplayName

Required. The user-defined name of the DataLabelingJob.

The name can be up to 128 characters long and can consist of any UTF-8 characters. Display name of a DataLabelingJob.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDatasets

Required. Dataset resource names. Right now we only support labeling from a single Dataset. Format: projects/{project}/locations/{location}/datasets/{dataset}

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setDatasets

Required. Dataset resource names. Right now we only support labeling from a single Dataset. Format: projects/{project}/locations/{location}/datasets/{dataset}

Parameter
NameDescription
var string[]
Returns
TypeDescription
$this

getAnnotationLabels

Labels to assign to annotations generated by this DataLabelingJob.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable.

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setAnnotationLabels

Labels to assign to annotations generated by this DataLabelingJob.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable.

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getLabelerCount

Required. Number of labelers to work on each DataItem.

Returns
TypeDescription
int

setLabelerCount

Required. Number of labelers to work on each DataItem.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getInstructionUri

Required. The Google Cloud Storage location of the instruction pdf. This pdf is shared with labelers, and provides detailed description on how to label DataItems in Datasets.

Returns
TypeDescription
string

setInstructionUri

Required. The Google Cloud Storage location of the instruction pdf. This pdf is shared with labelers, and provides detailed description on how to label DataItems in Datasets.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getInputsSchemaUri

Required. Points to a YAML file stored on Google Cloud Storage describing the config for a specific type of DataLabelingJob. The schema files that can be used here are found in the https://storage.googleapis.com/google-cloud-aiplatform bucket in the /schema/datalabelingjob/inputs/ folder.

Returns
TypeDescription
string

setInputsSchemaUri

Required. Points to a YAML file stored on Google Cloud Storage describing the config for a specific type of DataLabelingJob. The schema files that can be used here are found in the https://storage.googleapis.com/google-cloud-aiplatform bucket in the /schema/datalabelingjob/inputs/ folder.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getInputs

Required. Input config parameters for the DataLabelingJob.

Returns
TypeDescription
Google\Protobuf\Value|null

hasInputs

clearInputs

setInputs

Required. Input config parameters for the DataLabelingJob.

Parameter
NameDescription
var Google\Protobuf\Value
Returns
TypeDescription
$this

getState

Output only. The detailed state of the job.

Returns
TypeDescription
int

setState

Output only. The detailed state of the job.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getLabelingProgress

Output only. Current labeling job progress percentage scaled in interval [0, 100], indicating the percentage of DataItems that has been finished.

Returns
TypeDescription
int

setLabelingProgress

Output only. Current labeling job progress percentage scaled in interval [0, 100], indicating the percentage of DataItems that has been finished.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getCurrentSpend

Output only. Estimated cost(in US dollars) that the DataLabelingJob has incurred to date.

Returns
TypeDescription
Google\Type\Money|null

hasCurrentSpend

clearCurrentSpend

setCurrentSpend

Output only. Estimated cost(in US dollars) that the DataLabelingJob has incurred to date.

Parameter
NameDescription
var Google\Type\Money
Returns
TypeDescription
$this

getCreateTime

Output only. Timestamp when this DataLabelingJob was created.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. Timestamp when this DataLabelingJob was created.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getUpdateTime

Output only. Timestamp when this DataLabelingJob was updated most recently.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. Timestamp when this DataLabelingJob was updated most recently.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getError

Output only. DataLabelingJob errors. It is only populated when job's state is JOB_STATE_FAILED or JOB_STATE_CANCELLED.

Returns
TypeDescription
Google\Rpc\Status|null

hasError

clearError

setError

Output only. DataLabelingJob errors. It is only populated when job's state is JOB_STATE_FAILED or JOB_STATE_CANCELLED.

Parameter
NameDescription
var Google\Rpc\Status
Returns
TypeDescription
$this

getLabels

The labels with user-defined metadata to organize your DataLabelingJobs.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable. Following system labels exist for each DataLabelingJob:

  • "aiplatform.googleapis.com/schema": output only, its value is the inputs_schema's title.
Returns
TypeDescription
Google\Protobuf\Internal\MapField

setLabels

The labels with user-defined metadata to organize your DataLabelingJobs.

Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable. Following system labels exist for each DataLabelingJob:

  • "aiplatform.googleapis.com/schema": output only, its value is the inputs_schema's title.
Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getSpecialistPools

The SpecialistPools' resource names associated with this job.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setSpecialistPools

The SpecialistPools' resource names associated with this job.

Parameter
NameDescription
var string[]
Returns
TypeDescription
$this

getEncryptionSpec

Customer-managed encryption key spec for a DataLabelingJob. If set, this DataLabelingJob will be secured by this key.

Note: Annotations created in the DataLabelingJob are associated with the EncryptionSpec of the Dataset they are exported to.

Returns
TypeDescription
Google\Cloud\AIPlatform\V1\EncryptionSpec|null

hasEncryptionSpec

clearEncryptionSpec

setEncryptionSpec

Customer-managed encryption key spec for a DataLabelingJob. If set, this DataLabelingJob will be secured by this key.

Note: Annotations created in the DataLabelingJob are associated with the EncryptionSpec of the Dataset they are exported to.

Parameter
NameDescription
var Google\Cloud\AIPlatform\V1\EncryptionSpec
Returns
TypeDescription
$this

getActiveLearningConfig

Parameters that configure the active learning pipeline. Active learning will label the data incrementally via several iterations. For every iteration, it will select a batch of data based on the sampling strategy.

Returns
TypeDescription
Google\Cloud\AIPlatform\V1\ActiveLearningConfig|null

hasActiveLearningConfig

clearActiveLearningConfig

setActiveLearningConfig

Parameters that configure the active learning pipeline. Active learning will label the data incrementally via several iterations. For every iteration, it will select a batch of data based on the sampling strategy.

Parameter
NameDescription
var Google\Cloud\AIPlatform\V1\ActiveLearningConfig
Returns
TypeDescription
$this