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/v2/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 
     { 
 "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 .

    FieldModification

    A 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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: