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 के काेड में दिखाना 
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
फ़ील्ड
labelId

string

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

object (FieldModification)

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

boolean

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

string

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

FieldModification

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

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

string

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

string

यह हमेशा drive#labelFieldModification होता है.
setDateValues[]

string

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

string

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

string

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

string (int64 format)

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

string

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

boolean

इस फ़ील्ड की वैल्यू हटा देता है.