How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Google Labels API

Operations related to Labels

Google Labels API is one of 125 APIs that Google publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Labels. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and an API reference.

This API exposes 20 operations across 13 paths, and defines 87 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://www.googleapis.com/books/v1.

20 operations 13 paths 87 schemas 2 DELETE5 GET2 PATCH10 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.example.com
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Google Labels API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 1 scope.

  • OAuth2 — OAuth 2.0 authentication for Google Books API

Paths & Operations 20

Across 13 paths, the API surfaces 20 operations — 2 DELETE, 5 GET, 2 PATCH, 10 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Labels 20

Operations related to Labels

GET
/v2/labels
Google Retrieve Labels
googleDrivelabelsLabelsList 20 params → 200
POST
/v2/labels
Google Create Labels
googleDrivelabelsLabelsCreate 14 params body → 200
DELETE
/v2/{name}
Google Delete Name
googleDrivelabelsLabelsRevisionsPermissionsDelete 15 params → 200
POST
/v2/{name}:delta
Google Create Name:delta
googleDrivelabelsLabelsDelta 13 params body → 200
POST
/v2/{name}:disable
Google Create Name:disable
googleDrivelabelsLabelsDisable 13 params body → 200
POST
/v2/{name}:enable
Google Create Name:enable
googleDrivelabelsLabelsEnable 13 params body → 200
POST
/v2/{name}:publish
Google Create Name:publish
googleDrivelabelsLabelsPublish 13 params body → 200
POST
/v2/{name}:updateLabelCopyMode
Google Create Name:updatelabelcopymode
googleDrivelabelsLabelsUpdatelabelcopymode 13 params body → 200
GET
/v2/{parent}/locks
Google Retrieve Parent Locks
googleDrivelabelsLabelsRevisionsLocksList 15 params → 200
GET
/v2/{parent}/permissions
Google Retrieve Parent Permissions
googleDrivelabelsLabelsRevisionsPermissionsList 16 params → 200
POST
/v2/{parent}/permissions
Google Create Parent Permissions
googleDrivelabelsLabelsRevisionsPermissionsCreate 14 params body → 200
PATCH
/v2/{parent}/permissions
Google Patch Parent Permissions
googleDrivelabelsLabelsRevisionsUpdatepermissions 14 params body → 200
POST
/v2/{parent}/permissions:batchDelete
Google Create Parent Permissions:batchdelete
googleDrivelabelsLabelsRevisionsPermissionsBatchdelete 13 params body → 200
POST
/v2/{parent}/permissions:batchUpdate
Google Create Parent Permissions:batchupdate
googleDrivelabelsLabelsRevisionsPermissionsBatchupdate 13 params body → 200
GET
/gmail/v1/users/{userId}/labels
Google List Labels
2 params → 200
POST
/gmail/v1/users/{userId}/labels
Google Create Labels
3 params body → 200
GET
/gmail/v1/users/{userId}/labels/{id}
Google Get Labels
3 params → 200
PUT
/gmail/v1/users/{userId}/labels/{id}
Google Update Labels
4 params body → 200
PATCH
/gmail/v1/users/{userId}/labels/{id}
Google Patch Labels
4 params body → 200
DELETE
/gmail/v1/users/{userId}/labels/{id}
Google Delete Labels
2 params → 204

Schemas 87

The contract defines 87 schemas that model the data the API accepts and returns. The most detailed are GoogleAppsDriveLabelsV2Label (22 properties), GoogleAppsDriveLabelsV2Field (20 properties), GoogleAppsDriveLabelsV2FieldSelectionOptionsChoice (15 properties), GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseResponse (12 properties). Each schema is shown below with its type and property counts.

GoogleAppsDriveLabelsV2FieldAppliedCapabilities
object
The capabilities related to this field on applied metadata.
3 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateFieldPropertiesRequest
object
Request to update Field properties.
3 properties
GoogleAppsDriveLabelsV2UpdateLabelCopyModeRequest
object
Request to update the CopyMode of the given Label. Changes to this policy are not revisioned, do not require publishing, and take effect immediately. \
4 properties
GoogleAppsDriveLabelsV2BadgeConfig
object
Badge status of the label.
2 properties
GoogleAppsDriveLabelsV2Label
object
A label defines a taxonomy that can be applied to Drive items in order to organize and search across items. Labels can be simple strings, or can contain fields…
22 properties
GoogleAppsDriveLabelsV2UserInfo
object
Information about a user.
1 property
GoogleAppsDriveLabelsV2UpdateLabelPermissionRequest
object
Updates a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
3 properties
GmailUsersLabelsGetResponse1
object
GmailUsersLabelsGetResponse1 schema
10 properties
GoogleAppsDriveLabelsV2LabelAppliedLabelPolicy
object
Behavior of this label when it's applied to Drive items.
1 property
GmailUsersLabelsPatchResponseColor
object
GmailUsersLabelsPatchResponseColor schema
2 properties
GoogleAppsDriveLabelsV2LabelProperties
object
Basic properties of the label.
2 properties
GoogleAppsDriveLabelsV2ListLabelLocksResponse
object
The response to a ListLabelLocksRequest.
2 properties
GmailUsersLabelsPutResponse
object
GmailUsersLabelsPutResponse schema
10 properties
GoogleAppsDriveLabelsV2LabelSchemaCapabilities
object
The capabilities related to this label when editing the label.
4 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequest
object
The set of requests for updating aspects of a Label. If any request is not valid, no requests will be applied.
5 properties
GoogleAppsDriveLabelsV2Lifecycle
object
The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: UNPUBLISHEDDRAFT (starting state) UNPUBLIS…
3 properties
GoogleAppsDriveLabelsV2FieldIntegerOptions
object
Options for the Integer field type.
2 properties
GoogleAppsDriveLabelsV2LabelLockCapabilities
object
A description of a user's capabilities on a LabelLock.
1 property
GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceSchemaCapabilities
object
The capabilities related to this choice when editing the choice.
4 properties
GoogleAppsDriveLabelsV2LabelLock
object
A Lock that can be applied to a Label, Field, or Choice.
8 properties
GoogleAppsDriveLabelsV2LabelPermission
object
The permission that applies to a principal (user, group, audience) on a label.
6 properties
GoogleAppsDriveLabelsV2LabelDisplayHints
object
UI display hints for rendering the label.
4 properties
GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceProperties
object
Basic properties of the choice.
4 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateFieldTypeRequest
object
Request to change the type of a Field.
7 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestCreateFieldRequest
object
Request to create a Field within a Label.
1 property
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestEnableSelectionChoiceRequest
object
Request to enable a Choice.
2 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateLabelPropertiesRequest
object
Updates basic properties of a Label.
2 properties
GmailUsersLabelsPatchResponse
object
GmailUsersLabelsPatchResponse schema
10 properties
GoogleAppsDriveLabelsV2BadgeColors
object
The color derived from BadgeConfig and changed to the closest recommended supported color.
3 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDisableSelectionChoiceRequest
object
Request to disable a Choice.
4 properties
GoogleAppsDriveLabelsV2BatchUpdateLabelPermissionsResponse
object
Response for updating one or more Label Permissions.
1 property
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateFieldPropertiesResponse
object
Response following update to Field properties.
1 property
GoogleAppsDriveLabelsV2PublishLabelRequest
object
Request to publish a label.
3 properties
GoogleAppsDriveLabelsV2DeleteLabelPermissionRequest
object
Deletes a Label Permission. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.
2 properties
GoogleAppsDriveLabelsV2LifecycleDisabledPolicy
object
The policy that governs how to treat a disabled label, field, or selection choice in different contexts.
2 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestEnableFieldRequest
object
Request to enable the Field.
1 property
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestUpdateSelectionChoicePropertiesRequest
object
Request to update a Choice properties.
4 properties
GoogleAppsDriveLabelsV2FieldTextOptions
object
Options for the Text field type.
2 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseCreateFieldResponse
object
Response following Field create.
2 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseCreateSelectionChoiceResponse
object
Response following Selection Choice create.
2 properties
GoogleAppsDriveLabelsV2BatchUpdateLabelPermissionsRequest
object
Updates one or more Label Permissions.
2 properties
GmailUsersLabelsPostRequest
object
GmailUsersLabelsPostRequest schema
GoogleTypeColor
object
Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages…
4 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseResponse
object
A single response from an update.
12 properties
GoogleAppsDriveLabelsV2WriteControl
object
Provides control over how write requests are executed. When not specified, the last write wins.
1 property
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponse
object
Response for Label update.
2 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseEnableFieldResponse
object
Response following Field enable.
GoogleAppsDriveLabelsV2LabelAppliedCapabilities
object
The capabilities a user has on this label's applied metadata.
3 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDisableSelectionChoiceResponse
object
Response following Choice disable.
GmailUsersLabelsPatchRequest
object
GmailUsersLabelsPatchRequest schema
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateLabelPropertiesResponse
object
Response following update to Label properties.
GmailUsersLabelsPutResponseColor
object
GmailUsersLabelsPutResponseColor schema
2 properties
GmailUsersLabelsPostResponseColor
object
GmailUsersLabelsPostResponseColor schema
2 properties
GoogleAppsDriveLabelsV2LockStatus
object
Contains information about whether a label component should be considered locked.
1 property
GoogleAppsDriveLabelsV2FieldDateOptions
object
Options for the date field type.
4 properties
GoogleAppsDriveLabelsV2FieldUserOptions
object
Options for the user field type.
1 property
GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceDisplayHints
object
UI display hints for rendering an option.
6 properties
GoogleAppsDriveLabelsV2DisableLabelRequest
object
Request to deprecate a published Label.
5 properties
GoogleTypeDate
object
Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is…
3 properties
GmailUsersLabelsPutRequest
object
GmailUsersLabelsPutRequest schema
GoogleProtobufEmpty
object
A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the resp…
GoogleAppsDriveLabelsV2FieldSelectionOptions
object
Options for the selection field type.
2 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDeleteSelectionChoiceRequest
object
Request to delete a Choice.
2 properties
GoogleAppsDriveLabelsV2Field
object
Defines a field that has a display name, data type, and other configuration options. This field defines the kind of metadata that may be set on a Drive item.
20 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDeleteFieldResponse
object
Response following Field delete.
GoogleAppsDriveLabelsV2FieldSchemaCapabilities
object
The capabilities related to this field when editing the field.
4 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDeleteFieldRequest
object
Request to delete the Field.
1 property
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDisableFieldResponse
object
Response following Field disable.
GoogleAppsDriveLabelsV2BatchDeleteLabelPermissionsRequest
object
Deletes one of more Label Permissions.
2 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestDisableFieldRequest
object
Request to disable the Field.
3 properties
GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceAppliedCapabilities
object
The capabilities related to this choice on applied metadata.
3 properties
GmailUsersLabelsPostResponse
object
GmailUsersLabelsPostResponse schema
10 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseEnableSelectionChoiceResponse
object
Response following Choice enable.
GoogleAppsDriveLabelsV2EnableLabelRequest
object
Request to enable a label.
3 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestRequest
object
A single kind of update to apply to a Label.
12 properties
GmailUsersLabelsGetResponse
object
GmailUsersLabelsGetResponse schema
1 property
GoogleAppsDriveLabelsV2FieldDisplayHints
object
UI display hints for rendering a field.
4 properties
GoogleAppsDriveLabelsV2ListLabelPermissionsResponse
object
Response for listing the permissions on a Label.
2 properties
GoogleAppsDriveLabelsV2FieldListOptions
object
Options for a multi-valued variant of an associated field type.
1 property
GoogleAppsDriveLabelsV2ListLabelsResponse
object
Response for listing Labels.
2 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateFieldTypeResponse
object
Response following update to Field type.
GoogleAppsDriveLabelsV2DeltaUpdateLabelRequestCreateSelectionChoiceRequest
object
Request to create a Selection Choice.
2 properties
GoogleAppsDriveLabelsV2FieldProperties
object
The basic properties of the field.
3 properties
GmailUsersLabelsGetResponse1Color
object
GmailUsersLabelsGetResponse1Color schema
2 properties
GoogleAppsDriveLabelsV2FieldSelectionOptionsChoice
object
Selection field choice.
15 properties
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseDeleteSelectionChoiceResponse
object
Response following Choice delete.
GoogleAppsDriveLabelsV2DeltaUpdateLabelResponseUpdateSelectionChoicePropertiesResponse
object
Response following update to Selection Choice properties.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

google-labels-api-openapi.yml Raw ↑

Other APIs Google publishes across the network.

Google Cloud API Gateway
Google Maps API
Google Aggregate Places API
Google Places Insights API
Google Street View Imagery API
Google Elevation API
Google Routes API
Google Geocoding API
Google Geolocation API
Google Address Validation API
Google Time Zone API
Google Air Quality API
Where this information came from

This is an independent, third-party profile of Google Labels API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.