Method: files.modifyLabels

Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified.

HTTP request

POST https://www.googleapis.com/drive/v3/files/{fileId}/modifyLabels

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
fileId

string

The ID of the file to which the labels belong.

Request body

The request body contains an instance of ModifyLabelsRequest.

Response body

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

Authorization scopes

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.

ModifyLabelsRequest

A 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.

LabelModification

A 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
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
Fields
labelId

string

The ID of the label to modify.

fieldModifications[]

object (FieldModification)

The list of modifications to this label's fields.

removeLabel

boolean

If true, the label will be removed from the file.

kind

string

This is always drive#labelModification.

FieldModification

A modification to a label's field.

JSON representation
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
Fields
fieldId

string

The ID of the field to be modified.

kind

string

This is always drive#labelFieldModification.

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.

unsetValues

boolean

Unsets the values for this field.