Stay organized with collections Save and categorize content based on your preferences.
Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified.
HTTP requestPOST https://www.googleapis.com/drive/v3/files/{fileId}/modifyLabels
The URL uses gRPC Transcoding syntax.
Path parameters ParametersfileId
string
The ID of the file to which the labels belong.
Request bodyThe request body contains an instance of ModifyLabelsRequest
.
Response to a files.modifyLabels request. This contains only those labels which were added or updated by the request.
If successful, the response body contains data with the following structure:
JSON representation{
"modifiedLabels": [
{
object (Label
)
}
],
"kind": string
}
Fields modifiedLabels[]
object (
Label
)
The list of labels which were added or updated by the request.
kind
string
This is always drive#modifyLabelsResponse
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
Some scopes are restricted and require a security assessment for your app to use them. For more information, see the Authorization guide.
ModifyLabelsRequestA request to modify the set of labels on a file. This request may contain many modifications that will either all succeed or all fail atomically.
JSON representation{
"labelModifications": [
{
object (LabelModification
)
}
],
"kind": string
}
Fields labelModifications[]
object (
LabelModification
)
The list of modifications to apply to the labels on the file.
kind
string
This is always drive#modifyLabelsRequest.
LabelModificationA modification to a label on a file. A LabelModification can be used to apply a label to a file, update an existing label on a file, or remove a label from a file.
JSON representation{
"fieldModifications": [
{
object (FieldModification
)
}
],
"labelId": string,
"removeLabel": boolean,
"kind": string
}
Fields fieldModifications[]
object (
FieldModification
)
The list of modifications to this label's fields.
labelId
string
The ID of the label to modify.
removeLabel
boolean
If true, the label will be removed from the file.
kind
string
This is always drive#labelModification.
FieldModificationA modification to a label's field.
JSON representation{ "setDateValues": [ string ], "setTextValues": [ string ], "setSelectionValues": [ string ], "setIntegerValues": [ string ], "setUserValues": [ string ], "fieldId": string, "kind": string, "unsetValues": boolean }Fields
setDateValues[]
string
Replaces the value of a date
field with these new values. The string must be in the RFC 3339 full-date format: YYYY-MM-DD.
setTextValues[]
string
Sets the value of a text
field.
setSelectionValues[]
string
Replaces a selection
field with these new values.
setIntegerValues[]
string (int64 format)
Replaces the value of an integer
field with these new values.
setUserValues[]
string
Replaces a user
field with these new values. The values must be valid email addresses.
fieldId
string
The ID of the field to be modified.
kind
string
This is always drive#labelFieldModification.
unsetValues
boolean
Unsets the values for this field.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-23 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-23 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4