Skip to content

Data Labeling API API

by googleapis.com

OAuthHTTPSAnalytics
Open documentation ↗

Overview

Public API for Google Cloud AI Data Labeling Service.

Data Labeling API is an analytics API from googleapis.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 28 endpoints.

At a glance

Authentication
OAuth
HTTPS
Yes
CORS
Unknown
Category
Analytics
Base URL
https://datalabeling.googleapis.com/
Version
v1beta1
Endpoints
28
Spec updated
2023-04-21

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://datalabeling.googleapis.com/v1beta1/NAME" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const response = await fetch("https://datalabeling.googleapis.com/v1beta1/NAME", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://datalabeling.googleapis.com/v1beta1/NAME",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/v1beta1/{name}Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
PATCH/v1beta1/{name}Updates an evaluation job. You can only update certain fields of the job's EvaluationJobConfig: `humanAnnotationConfig.instruction`, `exampleCount`, and `exampl
DELETE/v1beta1/{name}Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If th
GET/v1beta1/{name}/operationsLists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding
GET/v1beta1/{name}:cancelStarts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the serv
POST/v1beta1/{name}:exportDataExports data and annotations from dataset.
POST/v1beta1/{name}:importDataImports 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 lon
POST/v1beta1/{name}:pausePauses an evaluation job. Pausing an evaluation job that is already in a `PAUSED` state is a no-op.
POST/v1beta1/{name}:resumeResumes a paused evaluation job. A deleted evaluation job can't be resumed. Resuming a running or scheduled evaluation job is a no-op.
GET/v1beta1/{parent}/annotatedDatasetsLists annotated datasets for a dataset. Pagination is supported.
GET/v1beta1/{parent}/annotationSpecSetsLists annotation spec sets for a project. Pagination is supported.
POST/v1beta1/{parent}/annotationSpecSetsCreates an annotation spec set by providing a set of labels.
GET/v1beta1/{parent}/dataItemsLists data items in a dataset. This API can be called after data are imported into dataset. Pagination is supported.
GET/v1beta1/{parent}/datasetsLists datasets under a project. Pagination is supported.
POST/v1beta1/{parent}/datasetsCreates dataset. If success return a Dataset resource.
GET/v1beta1/{parent}/evaluationJobsLists all evaluation jobs within a project with possible filters. Pagination is supported.
POST/v1beta1/{parent}/evaluationJobsCreates an evaluation job.
GET/v1beta1/{parent}/evaluations:searchSearches evaluations within a project.
POST/v1beta1/{parent}/exampleComparisons:searchSearches 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.
GET/v1beta1/{parent}/examplesLists examples in an annotated dataset. Pagination is supported.
GET/v1beta1/{parent}/feedbackMessagesList FeedbackMessages with pagination.
POST/v1beta1/{parent}/feedbackMessagesCreate a FeedbackMessage object.
GET/v1beta1/{parent}/feedbackThreadsList FeedbackThreads with pagination.
POST/v1beta1/{parent}/image:labelStarts a labeling task for image. The type of image labeling task is configured by feature in the request.
GET/v1beta1/{parent}/instructionsLists instructions for a project. Pagination is supported.
POST/v1beta1/{parent}/instructionsCreates an instruction for how data should be labeled.
POST/v1beta1/{parent}/text:labelStarts a labeling task for text. The type of text labeling task is configured by feature in the request.
POST/v1beta1/{parent}/video:labelStarts a labeling task for video. The type of video labeling task is configured by feature in the request.

Questions

Does the Data Labeling API API need an API key?

Yes. The Data Labeling API API uses OAuth authentication; the documentation explains how to get credentials.

Does the Data Labeling API API support HTTPS?

Yes, the Data Labeling API API is served over HTTPS.

How many endpoints does the Data Labeling API API have?

Its OpenAPI description lists 28 endpoints in version v1beta1. All of them are shown on this page.

What are alternatives to the Data Labeling API API?

Other Analytics APIs include Google Play Integrity API, versionhistory.googleapis.com API, Doc Converter, Perspective Comment Analyzer API, Safe Browsing API.

Compare alternatives →

Google Play Integrity API

Analytics

The Play Integrity API helps you check that you're interacting with your genuine app on a genuine Android device powered by Google Play services. The Play Integrity API has replaced SafetyNet Attestation and Android Device Verification.

OAuth1 endpoints

versionhistory.googleapis.com API

Analytics

Version History API - Prod

No auth4 endpoints

Doc Converter

Analytics

This api converts file formats of OpenXml and OpenOffice documents formats to vector files (e.g., svg)

No auth1 endpoints

Perspective Comment Analyzer API

Analytics

The Perspective Comment Analyzer API provides information about the potential impact of a comment on a conversation (e.g. it can provide a score for the "toxicity" of a comment). Users can leverage the "SuggestCommentScore" method to submit corrections to improve Perspective over time. Users can set the "doNotStore" flag to ensure that all submitted comments are automatically deleted after scores are returned.

OAuth2 endpoints

Safe Browsing API

Analytics

Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes – meaning “for sale or revenue-generating purposes” – please refer to the Web Risk API.

No auth7 endpoints

Web Fonts Developer API

Analytics

The Google Web Fonts Developer API lets you retrieve information about web fonts served by Google.

No auth1 endpoints

Listed from APIs.guru (CC0).