Method: files.modifyLabels

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

इससे जोड़े गए या बदले गए लेबल की सूची दिखती है.

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

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

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

पाथ पैरामीटर

पैरामीटर
fileId

string

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

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

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

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

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

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

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

object (Label)

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

string

यह हमेशा "drive#modifyLabelsResponse" होता है.

अनुमति के स्कोप

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

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

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

ModifyLabelsRequest

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

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

object (LabelModification)

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

string

यह हमेशा "drive#modifyLabelsRequest" होता है.

LabelModification

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

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

object (FieldModification)

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

string

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

boolean

अगर यह वैल्यू सही है, तो लेबल को फ़ाइल से हटा दिया जाएगा.
kind

string

यह हमेशा "drive#labelModification" होता है.

FieldModification

किसी लेबल के फ़ील्ड में बदलाव किया गया हो.

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

string

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

string

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

string

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

string (int64 format)

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

string

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

string

जिस फ़ील्ड में बदलाव करना है उसका आईडी.
kind

string

यह हमेशा "drive#labelFieldModification" होता है.
unsetValues

boolean

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