Method: files.modifyLabels

यह नीति, फ़ाइल पर लागू किए गए लेबल के सेट में बदलाव करती है. जोड़े गए या बदले गए लेबल की सूची दिखाता है.

एचटीटीपी अनुरोध

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

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
fileId

string

उस फ़ाइल का आईडी जिससे लेबल जुड़े हैं.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में ModifyLabelsRequest का उदाहरण है.

जवाब का मुख्य भाग

file.modifylabel के अनुरोध का जवाब. इसमें सिर्फ़ वे लेबल होते हैं जिन्हें अनुरोध करने पर जोड़ा या अपडेट किया गया था.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
फ़ील्ड
modifiedLabels[]

object (Label)

उन लेबल की सूची जिन्हें अनुरोध पर जोड़ा या अपडेट किया गया था.
kind

string

यह हमेशा drive#modifylabelResponse पर लागू होता है

अनुमति देने के दायरे

इनमें से कोई एक OAuth स्कोप ज़रूरी है:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

कुछ दायरे सीमित हैं. इनका इस्तेमाल करने के लिए, सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.

ModifyLabelsRequest

किसी फ़ाइल पर लेबल के सेट में बदलाव करने का अनुरोध. इस अनुरोध में कई बदलाव हो सकते हैं, जो या तो सभी सफल हो जाएंगे या सभी अपने आप फ़ेल हो जाएंगे.

जेएसओएन के काेड में दिखाना 
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
फ़ील्ड
labelModifications[]

object (LabelModification)

फ़ाइल के लेबल पर लागू किए जाने वाले बदलावों की सूची.
kind

string

यह हमेशा drive#modifylabelRequest पर सेट होता है.

LabelModification

किसी फ़ाइल पर लेबल में बदलाव करना. लेबल संशोधन का इस्तेमाल किसी फ़ाइल पर लेबल लागू करने, फ़ाइल पर मौजूदा लेबल अपडेट करने या फ़ाइल से लेबल हटाने के लिए किया जा सकता है.

जेएसओएन के काेड में दिखाना 
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
फ़ील्ड
labelId

string

उस लेबल का आईडी जिसमें बदलाव करना है.
fieldModifications[]

object (FieldModification)

इस लेबल के फ़ील्ड में किए गए बदलावों की सूची.
removeLabel

boolean

सही होने पर, फ़ाइल से लेबल हटा दिया जाएगा.
kind

string

यह हमेशा drive#labelModified है.

FieldModification

लेबल के फ़ील्ड में होने वाला बदलाव.

जेएसओएन के काेड में दिखाना 
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
फ़ील्ड
fieldId

string

बदले जाने वाले फ़ील्ड का आईडी.
kind

string

यह हमेशा drive#labelfieldModified है.
setDateValues[]

string

date फ़ील्ड की वैल्यू को इन नई वैल्यू से बदलता है. स्ट्रिंग, RFC 3339 पूरी तारीख के फ़ॉर्मैट में होनी चाहिए: YYYY-MM-DD.
setTextValues[]

string

text फ़ील्ड की वैल्यू सेट करता है.
setSelectionValues[]

string

selection फ़ील्ड को इन नई वैल्यू से बदलता है.
setIntegerValues[]

string (int64 format)

किसी integer फ़ील्ड की वैल्यू को इन नई वैल्यू से बदलता है.
setUserValues[]

string

user फ़ील्ड को इन नई वैल्यू से बदलता है. मान, मान्य ईमेल पते होने चाहिए.
unsetValues

boolean

इस फ़ील्ड के लिए वैल्यू को अनसेट करता है.