Modify labels applied to a file

POST {{baseUrl}}/files/:fileId/modifyLabels?key={{key}}&oauth_token={{oauthToken}}

Modifies the set of labels on a file.

Request Params

KeyDatatypeRequiredDescription
altstringData format for the response.
fieldsstringSelector specifying which fields to include in a partial response.
keystringAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
oauth_tokenstringOAuth 2.0 token for the current user.
prettyPrintstringReturns response with indentations and line breaks.
quotaUserstringAn opaque string that represents a user for quota purposes. Must not exceed 40 characters.
userIpstringDeprecated. Please use quotaUser instead.

Request Body

{"kind"=>"drive#modifyLabelsRequest", "labelModifications"=>[{"fieldModifications"=>[{"fieldId"=>"<string>", "kind"=>"drive#labelFieldModification", "setDateValues"=>["<date>", "<date>"], "setIntegerValues"=>["<int64>", "<int64>"], "setSelectionValues"=>["<string>", "<string>"], "setTextValues"=>["<string>", "<string>"], "setUserValues"=>["<string>", "<string>"], "unsetValues"=>"<boolean>"}, {"fieldId"=>"<string>", "kind"=>"drive#labelFieldModification", "setDateValues"=>["<date>", "<date>"], "setIntegerValues"=>["<int64>", "<int64>"], "setSelectionValues"=>["<string>", "<string>"], "setTextValues"=>["<string>", "<string>"], "setUserValues"=>["<string>", "<string>"], "unsetValues"=>"<boolean>"}], "kind"=>"drive#labelModification", "labelId"=>"<string>", "removeLabel"=>"<boolean>"}, {"fieldModifications"=>[{"fieldId"=>"<string>", "kind"=>"drive#labelFieldModification", "setDateValues"=>["<date>", "<date>"], "setIntegerValues"=>["<int64>", "<int64>"], "setSelectionValues"=>["<string>", "<string>"], "setTextValues"=>["<string>", "<string>"], "setUserValues"=>["<string>", "<string>"], "unsetValues"=>"<boolean>"}, {"fieldId"=>"<string>", "kind"=>"drive#labelFieldModification", "setDateValues"=>["<date>", "<date>"], "setIntegerValues"=>["<int64>", "<int64>"], "setSelectionValues"=>["<string>", "<string>"], "setTextValues"=>["<string>", "<string>"], "setUserValues"=>["<string>", "<string>"], "unsetValues"=>"<boolean>"}], "kind"=>"drive#labelModification", "labelId"=>"<string>", "removeLabel"=>"<boolean>"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;kind&quot;:&quot;drive#modifyLabelsResponse&quot;,&quot;modifiedLabels&quot;:[{&quot;fields&quot;:{&quot;et_7&quot;:{&quot;dateString&quot;:[&quot;\u003cdate\u003e&quot;,&quot;\u003cdate\u003e&quot;],&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;integer&quot;:[&quot;\u003cint64\u003e&quot;,&quot;\u003cint64\u003e&quot;],&quot;kind&quot;:&quot;drive#labelField&quot;,&quot;selection&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;text&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;user&quot;:[{&quot;displayName&quot;:&quot;\u003cstring\u003e&quot;,&quot;emailAddress&quot;:&quot;\u003cstring\u003e&quot;,&quot;kind&quot;:&quot;drive#user&quot;,&quot;me&quot;:&quot;\u003cboolean\u003e&quot;,&quot;permissionId&quot;:&quot;\u003cstring\u003e&quot;,&quot;photoLink&quot;:&quot;\u003cstring\u003e&quot;},{&quot;displayName&quot;:&quot;\u003cstring\u003e&quot;,&quot;emailAddress&quot;:&quot;\u003cstring\u003e&quot;,&quot;kind&quot;:&quot;drive#user&quot;,&quot;me&quot;:&quot;\u003cboolean\u003e&quot;,&quot;permissionId&quot;:&quot;\u003cstring\u003e&quot;,&quot;photoLink&quot;:&quot;\u003cstring\u003e&quot;}],&quot;valueType&quot;:&quot;\u003cstring\u003e&quot;}},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;kind&quot;:&quot;drive#label&quot;,&quot;revisionId&quot;:&quot;\u003cstring\u003e&quot;},{&quot;fields&quot;:{&quot;quis_6a5&quot;:{&quot;dateString&quot;:[&quot;\u003cdate\u003e&quot;,&quot;\u003cdate\u003e&quot;],&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;integer&quot;:[&quot;\u003cint64\u003e&quot;,&quot;\u003cint64\u003e&quot;],&quot;kind&quot;:&quot;drive#labelField&quot;,&quot;selection&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;text&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;user&quot;:[{&quot;displayName&quot;:&quot;\u003cstring\u003e&quot;,&quot;emailAddress&quot;:&quot;\u003cstring\u003e&quot;,&quot;kind&quot;:&quot;drive#user&quot;,&quot;me&quot;:&quot;\u003cboolean\u003e&quot;,&quot;permissionId&quot;:&quot;\u003cstring\u003e&quot;,&quot;photoLink&quot;:&quot;\u003cstring\u003e&quot;},{&quot;displayName&quot;:&quot;\u003cstring\u003e&quot;,&quot;emailAddress&quot;:&quot;\u003cstring\u003e&quot;,&quot;kind&quot;:&quot;drive#user&quot;,&quot;me&quot;:&quot;\u003cboolean\u003e&quot;,&quot;permissionId&quot;:&quot;\u003cstring\u003e&quot;,&quot;photoLink&quot;:&quot;\u003cstring\u003e&quot;}],&quot;valueType&quot;:&quot;\u003cstring\u003e&quot;},&quot;officiac&quot;:{&quot;dateString&quot;:[&quot;\u003cdate\u003e&quot;,&quot;\u003cdate\u003e&quot;],&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;integer&quot;:[&quot;\u003cint64\u003e&quot;,&quot;\u003cint64\u003e&quot;],&quot;kind&quot;:&quot;drive#labelField&quot;,&quot;selection&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;text&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;user&quot;:[{&quot;displayName&quot;:&quot;\u003cstring\u003e&quot;,&quot;emailAddress&quot;:&quot;\u003cstring\u003e&quot;,&quot;kind&quot;:&quot;drive#user&quot;,&quot;me&quot;:&quot;\u003cboolean\u003e&quot;,&quot;permissionId&quot;:&quot;\u003cstring\u003e&quot;,&quot;photoLink&quot;:&quot;\u003cstring\u003e&quot;},{&quot;displayName&quot;:&quot;\u003cstring\u003e&quot;,&quot;emailAddress&quot;:&quot;\u003cstring\u003e&quot;,&quot;kind&quot;:&quot;drive#user&quot;,&quot;me&quot;:&quot;\u003cboolean\u003e&quot;,&quot;permissionId&quot;:&quot;\u003cstring\u003e&quot;,&quot;photoLink&quot;:&quot;\u003cstring\u003e&quot;}],&quot;valueType&quot;:&quot;\u003cstring\u003e&quot;}},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;kind&quot;:&quot;drive#label&quot;,&quot;revisionId&quot;:&quot;\u003cstring\u003e&quot;}]}