Class DataLabelingServiceGrpc.DataLabelingServiceFutureStub (0.168.0)

public static final class DataLabelingServiceGrpc.DataLabelingServiceFutureStub extends AbstractFutureStub<DataLabelingServiceGrpc.DataLabelingServiceFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service DataLabelingService.

Service for the AI Platform Data Labeling API.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > DataLabelingServiceGrpc.DataLabelingServiceFutureStub

Methods

build(Channel channel, CallOptions callOptions)

protected DataLabelingServiceGrpc.DataLabelingServiceFutureStub build(Channel channel, CallOptions callOptions)
Parameters
Name Description
channel io.grpc.Channel
callOptions io.grpc.CallOptions
Returns
Type Description
DataLabelingServiceGrpc.DataLabelingServiceFutureStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

createAnnotationSpecSet(CreateAnnotationSpecSetRequest request)

public ListenableFuture<AnnotationSpecSet> createAnnotationSpecSet(CreateAnnotationSpecSetRequest request)

Creates an annotation spec set by providing a set of labels.

Parameter
Name Description
request CreateAnnotationSpecSetRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<AnnotationSpecSet>

createDataset(CreateDatasetRequest request)

public ListenableFuture<Dataset> createDataset(CreateDatasetRequest request)

Creates dataset. If success return a Dataset resource.

Parameter
Name Description
request CreateDatasetRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Dataset>

createEvaluationJob(CreateEvaluationJobRequest request)

public ListenableFuture<EvaluationJob> createEvaluationJob(CreateEvaluationJobRequest request)

Creates an evaluation job.

Parameter
Name Description
request CreateEvaluationJobRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<EvaluationJob>

createInstruction(CreateInstructionRequest request)

public ListenableFuture<Operation> createInstruction(CreateInstructionRequest request)

Creates an instruction for how data should be labeled.

Parameter
Name Description
request CreateInstructionRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Operation>

deleteAnnotatedDataset(DeleteAnnotatedDatasetRequest request)

public ListenableFuture<Empty> deleteAnnotatedDataset(DeleteAnnotatedDatasetRequest request)

Deletes an annotated dataset by resource name.

Parameter
Name Description
request DeleteAnnotatedDatasetRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Empty>

deleteAnnotationSpecSet(DeleteAnnotationSpecSetRequest request)

public ListenableFuture<Empty> deleteAnnotationSpecSet(DeleteAnnotationSpecSetRequest request)

Deletes an annotation spec set by resource name.

Parameter
Name Description
request DeleteAnnotationSpecSetRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Empty>

deleteDataset(DeleteDatasetRequest request)

public ListenableFuture<Empty> deleteDataset(DeleteDatasetRequest request)

Deletes a dataset by resource name.

Parameter
Name Description
request DeleteDatasetRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Empty>

deleteEvaluationJob(DeleteEvaluationJobRequest request)

public ListenableFuture<Empty> deleteEvaluationJob(DeleteEvaluationJobRequest request)

Stops and deletes an evaluation job.

Parameter
Name Description
request DeleteEvaluationJobRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Empty>

deleteInstruction(DeleteInstructionRequest request)

public ListenableFuture<Empty> deleteInstruction(DeleteInstructionRequest request)

Deletes an instruction object by resource name.

Parameter
Name Description
request DeleteInstructionRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Empty>

exportData(ExportDataRequest request)

public ListenableFuture<Operation> exportData(ExportDataRequest request)

Exports data and annotations from dataset.

Parameter
Name Description
request ExportDataRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Operation>

getAnnotatedDataset(GetAnnotatedDatasetRequest request)

public ListenableFuture<AnnotatedDataset> getAnnotatedDataset(GetAnnotatedDatasetRequest request)

Gets an annotated dataset by resource name.

Parameter
Name Description
request GetAnnotatedDatasetRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<AnnotatedDataset>

getAnnotationSpecSet(GetAnnotationSpecSetRequest request)

public ListenableFuture<AnnotationSpecSet> getAnnotationSpecSet(GetAnnotationSpecSetRequest request)

Gets an annotation spec set by resource name.

Parameter
Name Description
request GetAnnotationSpecSetRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<AnnotationSpecSet>

getDataItem(GetDataItemRequest request)

public ListenableFuture<DataItem> getDataItem(GetDataItemRequest request)

Gets a data item in a dataset by resource name. This API can be called after data are imported into dataset.

Parameter
Name Description
request GetDataItemRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<DataItem>

getDataset(GetDatasetRequest request)

public ListenableFuture<Dataset> getDataset(GetDatasetRequest request)

Gets dataset by resource name.

Parameter
Name Description
request GetDatasetRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Dataset>

getEvaluation(GetEvaluationRequest request)

public ListenableFuture<Evaluation> getEvaluation(GetEvaluationRequest request)

Gets an evaluation by resource name (to search, use projects.evaluations.search).

Parameter
Name Description
request GetEvaluationRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Evaluation>

getEvaluationJob(GetEvaluationJobRequest request)

public ListenableFuture<EvaluationJob> getEvaluationJob(GetEvaluationJobRequest request)

Gets an evaluation job by resource name.

Parameter
Name Description
request GetEvaluationJobRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<EvaluationJob>

getExample(GetExampleRequest request)

public ListenableFuture<Example> getExample(GetExampleRequest request)

Gets an example by resource name, including both data and annotation.

Parameter
Name Description
request GetExampleRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Example>

getInstruction(GetInstructionRequest request)

public ListenableFuture<Instruction> getInstruction(GetInstructionRequest request)

Gets an instruction by resource name.

Parameter
Name Description
request GetInstructionRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Instruction>

importData(ImportDataRequest request)

public ListenableFuture<Operation> importData(ImportDataRequest request)

Imports data into dataset based on source locations defined in request. It can be called multiple times for the same dataset. Each dataset can only have one long running operation running on it. For example, no labeling task (also long running operation) can be started while importing is still ongoing. Vice versa.

Parameter
Name Description
request ImportDataRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Operation>

labelImage(LabelImageRequest request)

public ListenableFuture<Operation> labelImage(LabelImageRequest request)

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

Parameter
Name Description
request LabelImageRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Operation>

labelText(LabelTextRequest request)

public ListenableFuture<Operation> labelText(LabelTextRequest request)

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

Parameter
Name Description
request LabelTextRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Operation>

labelVideo(LabelVideoRequest request)

public ListenableFuture<Operation> labelVideo(LabelVideoRequest request)

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

Parameter
Name Description
request LabelVideoRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Operation>

listAnnotatedDatasets(ListAnnotatedDatasetsRequest request)

public ListenableFuture<ListAnnotatedDatasetsResponse> listAnnotatedDatasets(ListAnnotatedDatasetsRequest request)

Lists annotated datasets for a dataset. Pagination is supported.

Parameter
Name Description
request ListAnnotatedDatasetsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListAnnotatedDatasetsResponse>

listAnnotationSpecSets(ListAnnotationSpecSetsRequest request)

public ListenableFuture<ListAnnotationSpecSetsResponse> listAnnotationSpecSets(ListAnnotationSpecSetsRequest request)

Lists annotation spec sets for a project. Pagination is supported.

Parameter
Name Description
request ListAnnotationSpecSetsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListAnnotationSpecSetsResponse>

listDataItems(ListDataItemsRequest request)

public ListenableFuture<ListDataItemsResponse> listDataItems(ListDataItemsRequest request)

Lists data items in a dataset. This API can be called after data are imported into dataset. Pagination is supported.

Parameter
Name Description
request ListDataItemsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListDataItemsResponse>

listDatasets(ListDatasetsRequest request)

public ListenableFuture<ListDatasetsResponse> listDatasets(ListDatasetsRequest request)

Lists datasets under a project. Pagination is supported.

Parameter
Name Description
request ListDatasetsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListDatasetsResponse>

listEvaluationJobs(ListEvaluationJobsRequest request)

public ListenableFuture<ListEvaluationJobsResponse> listEvaluationJobs(ListEvaluationJobsRequest request)

Lists all evaluation jobs within a project with possible filters. Pagination is supported.

Parameter
Name Description
request ListEvaluationJobsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListEvaluationJobsResponse>

listExamples(ListExamplesRequest request)

public ListenableFuture<ListExamplesResponse> listExamples(ListExamplesRequest request)

Lists examples in an annotated dataset. Pagination is supported.

Parameter
Name Description
request ListExamplesRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListExamplesResponse>

listInstructions(ListInstructionsRequest request)

public ListenableFuture<ListInstructionsResponse> listInstructions(ListInstructionsRequest request)

Lists instructions for a project. Pagination is supported.

Parameter
Name Description
request ListInstructionsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListInstructionsResponse>

pauseEvaluationJob(PauseEvaluationJobRequest request)

public ListenableFuture<Empty> pauseEvaluationJob(PauseEvaluationJobRequest request)

Pauses an evaluation job. Pausing an evaluation job that is already in a PAUSED state is a no-op.

Parameter
Name Description
request PauseEvaluationJobRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Empty>

resumeEvaluationJob(ResumeEvaluationJobRequest request)

public ListenableFuture<Empty> resumeEvaluationJob(ResumeEvaluationJobRequest request)

Resumes a paused evaluation job. A deleted evaluation job can't be resumed. Resuming a running or scheduled evaluation job is a no-op.

Parameter
Name Description
request ResumeEvaluationJobRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Empty>

searchEvaluations(SearchEvaluationsRequest request)

public ListenableFuture<SearchEvaluationsResponse> searchEvaluations(SearchEvaluationsRequest request)

Searches evaluations within a project.

Parameter
Name Description
request SearchEvaluationsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<SearchEvaluationsResponse>

searchExampleComparisons(SearchExampleComparisonsRequest request)

public ListenableFuture<SearchExampleComparisonsResponse> searchExampleComparisons(SearchExampleComparisonsRequest request)

Searches example comparisons from an evaluation. The return format is a list of example comparisons that show ground truth and prediction(s) for a single input. Search by providing an evaluation ID.

Parameter
Name Description
request SearchExampleComparisonsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<SearchExampleComparisonsResponse>

updateEvaluationJob(UpdateEvaluationJobRequest request)

public ListenableFuture<EvaluationJob> updateEvaluationJob(UpdateEvaluationJobRequest request)

Updates an evaluation job. You can only update certain fields of the job's EvaluationJobConfig: humanAnnotationConfig.instruction, exampleCount, and exampleSamplePercentage. If you want to change any other aspect of the evaluation job, you must delete the job and create a new one.

Parameter
Name Description
request UpdateEvaluationJobRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<EvaluationJob>