Method: files.modifyLabels

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

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

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

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

पाथ पैरामीटर

पैरामीटर
fileId

string

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

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

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

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

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

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

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

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

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

string

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

object (FieldModification)

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

boolean

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

string

यह हमेशा drive#labelबदलाव होता है.

FieldModification

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

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

string

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

string

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

string

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

string

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

string

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

string (int64 format)

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

string

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

boolean

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