Method: labels.delta

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

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

POST https://drivelabels.googleapis.com/v2beta/{name=labels/*}:delta

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

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

पैरामीटर
name

string

ज़रूरी है. अपडेट किए जाने वाले लेबल का संसाधन नाम.

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

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना
{
  "writeControl": {
    object (WriteControl)
  },
  "requests": [
    {
      object (Request)
    }
  ],
  "useAdminAccess": boolean,
  "view": enum (LabelView),
  "languageCode": string
}
फ़ील्ड
writeControl

object (WriteControl)

लिखने के अनुरोधों को लागू करने का कंट्रोल देता है.

requests[]

object (Request)

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

useAdminAccess

boolean

उपयोगकर्ता के एडमिन क्रेडेंशियल का इस्तेमाल करने के लिए, true पर सेट करें. ऐक्सेस की अनुमति देने से पहले सर्वर यह पुष्टि करेगा कि उपयोगकर्ता, लेबल का एडमिन है.

view

enum (LabelView)

तय किए जाने पर, सिर्फ़ बताए गए व्यू से जुड़े कुछ फ़ील्ड दिखाए जाएंगे.

languageCode

string

include_label_in_response के true होने पर, स्थानीय जगह के हिसाब से फ़ील्ड लेबल का आकलन करने के लिए, BCP-47 भाषा कोड.

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

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

लेबल अपडेट के लिए प्रतिक्रिया.

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

object (Response)

अपडेट का जवाब. यह अपडेट के साथ 1:1 मैप करता है. हालांकि, हो सकता है कि कुछ अनुरोधों के जवाब खाली हों.

updatedLabel

object (Label)

अपडेट लागू होने के बाद का लेबल. इसे सिर्फ़ तब सेट किया जाता है, जब [BatchUpdateLabelResponse2.include_label_in_response] true पर सेट हो और इसमें कोई गड़बड़ी न हो.

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

इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.

अनुरोध

लेबल पर लागू करने के लिए, एक तरह का अपडेट.

जेएसओएन के काेड में दिखाना
{

  // Union field kind can be only one of the following:
  "updateLabel": {
    object (UpdateLabelPropertiesRequest)
  },
  "createField": {
    object (CreateFieldRequest)
  },
  "updateField": {
    object (UpdateFieldPropertiesRequest)
  },
  "updateFieldType": {
    object (UpdateFieldTypeRequest)
  },
  "enableField": {
    object (EnableFieldRequest)
  },
  "disableField": {
    object (DisableFieldRequest)
  },
  "deleteField": {
    object (DeleteFieldRequest)
  },
  "createSelectionChoice": {
    object (CreateSelectionChoiceRequest)
  },
  "updateSelectionChoiceProperties": {
    object (UpdateSelectionChoicePropertiesRequest)
  },
  "enableSelectionChoice": {
    object (EnableSelectionChoiceRequest)
  },
  "disableSelectionChoice": {
    object (DisableSelectionChoiceRequest)
  },
  "deleteSelectionChoice": {
    object (DeleteSelectionChoiceRequest)
  }
  // End of list of possible types for union field kind.
}
फ़ील्ड
यूनियन फ़ील्ड kind. अपडेट किस तरह का है. सटीक रूप से एक फ़ील्ड आवश्यक है. kind इनमें से सिर्फ़ एक हो सकती है:
updateLabel

object (UpdateLabelPropertiesRequest)

लेबल की प्रॉपर्टी अपडेट करता है.

createField

object (CreateFieldRequest)

एक नया फ़ील्ड बनाता है.

updateField

object (UpdateFieldPropertiesRequest)

फ़ील्ड की बुनियादी प्रॉपर्टी को अपडेट करता है.

updateFieldType

object (UpdateFieldTypeRequest)

फ़ील्ड के टाइप और/या टाइप के विकल्पों को अपडेट करें.

enableField

object (EnableFieldRequest)

फ़ील्ड को सक्षम करता है.

disableField

object (DisableFieldRequest)

फ़ील्ड को बंद करता है.

deleteField

object (DeleteFieldRequest)

लेबल से फ़ील्ड को मिटाता है.

createSelectionChoice

object (CreateSelectionChoiceRequest)

चुनने के फ़ील्ड में विकल्प बनाता है.

updateSelectionChoiceProperties

object (UpdateSelectionChoicePropertiesRequest)

चुनने के फ़ील्ड में विकल्प प्रॉपर्टी अपडेट करें.

enableSelectionChoice

object (EnableSelectionChoiceRequest)

किसी चयन फ़ील्ड में विकल्प सक्षम करें.

disableSelectionChoice

object (DisableSelectionChoiceRequest)

किसी चयन फ़ील्ड में विकल्प को अक्षम करें.

deleteSelectionChoice

object (DeleteSelectionChoiceRequest)

किसी चुनने के फ़ील्ड में से कोई विकल्प मिटाएं.

UpdateLabelPropertiesRequest

लेबल की बुनियादी प्रॉपर्टी को अपडेट करता है.

जेएसओएन के काेड में दिखाना
{
  "updateMask": string,
  "properties": {
    object (Properties)
  }
}
फ़ील्ड
updateMask

string (FieldMask format)

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

properties

object (Properties)

ज़रूरी है. अपडेट की जाने वाली लेबल प्रॉपर्टी.

CreateFieldRequest

लेबल में एक फ़ील्ड बनाने का अनुरोध करें.

जेएसओएन के काेड में दिखाना
{
  "field": {
    object (Field)
  }
}
फ़ील्ड
field

object (Field)

ज़रूरी है. बनाने के लिए फ़ील्ड.

UpdateFieldPropertiesRequest

फ़ील्ड की प्रॉपर्टी अपडेट करने का अनुरोध करना.

जेएसओएन के काेड में दिखाना
{
  "updateMask": string,
  "id": string,
  "properties": {
    object (Properties)
  }
}
फ़ील्ड
updateMask

string (FieldMask format)

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

id

string

ज़रूरी है. अपडेट किया जाने वाला फ़ील्ड.

properties

object (Properties)

ज़रूरी है. बेसिक फ़ील्ड प्रॉपर्टी.

UpdateFieldTypeRequest

फ़ील्ड का टाइप बदलने का अनुरोध करें.

जेएसओएन के काेड में दिखाना
{
  "updateMask": string,
  "id": string,

  // Union field type_options can be only one of the following:
  "textOptions": {
    object (TextOptions)
  },
  "longTextOptions": {
    object (LongTextOptions)
  },
  "integerOptions": {
    object (IntegerOptions)
  },
  "dateOptions": {
    object (DateOptions)
  },
  "selectionOptions": {
    object (SelectionOptions)
  },
  "userOptions": {
    object (UserOptions)
  }
  // End of list of possible types for union field type_options.
}
फ़ील्ड
updateMask

string (FieldMask format)

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

id

string

ज़रूरी है. अपडेट किया जाने वाला फ़ील्ड.

यूनियन फ़ील्ड type_options.

type_options इनमें से सिर्फ़ एक हो सकती है:

textOptions

object (TextOptions)

फ़ील्ड को टेक्स्ट फ़ॉर्मैट में अपडेट करें.

longTextOptions

object (LongTextOptions)

फ़ील्ड को लंबे टेक्स्ट पर अपडेट करें.

integerOptions

object (IntegerOptions)

फ़ील्ड को पूर्णांक में अपडेट करें.

dateOptions

object (DateOptions)

फ़ील्ड को तारीख पर अपडेट करें.

selectionOptions

object (SelectionOptions)

फ़ील्ड को 'चुने गए' पर अपडेट करें.

userOptions

object (UserOptions)

फ़ील्ड को उपयोगकर्ता के तौर पर अपडेट करें.

LongTextOptions

इसमें लंबे टेक्स्ट वाले फ़ील्ड टाइप को चुनने का विकल्प होता है.

जेएसओएन के काेड में दिखाना
{
  "minLength": integer,
  "maxLength": integer
}
फ़ील्ड
minLength

integer

सिर्फ़ आउटपुट के लिए. टेक्स्ट फ़ील्ड के लिए वैल्यू की कम से कम मान्य लंबाई.

maxLength

integer

सिर्फ़ आउटपुट के लिए. टेक्स्ट फ़ील्ड के लिए वैल्यू की ज़्यादा से ज़्यादा मान्य लंबाई.

EnableFieldRequest

फ़ील्ड को चालू करने का अनुरोध करें.

जेएसओएन के काेड में दिखाना
{
  "id": string
}
फ़ील्ड
id

string

ज़रूरी है. चालू किए जाने वाले फ़ील्ड का आईडी.

DisableFieldRequest

फ़ील्ड को बंद करने का अनुरोध करना.

जेएसओएन के काेड में दिखाना
{
  "updateMask": string,
  "id": string,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
फ़ील्ड
updateMask

string (FieldMask format)

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

id

string

ज़रूरी है. बंद किए जाने वाले फ़ील्ड की कुंजी.

disabledPolicy

object (DisabledPolicy)

ज़रूरी है. फ़ील्ड के बंद होने से जुड़ी नीति.

DeleteFieldRequest

फ़ील्ड मिटाने का अनुरोध करें.

जेएसओएन के काेड में दिखाना
{
  "id": string
}
फ़ील्ड
id

string

ज़रूरी है. मिटाए जाने वाले फ़ील्ड का आईडी.

CreateSelectionChoiceRequest

चुनने का कोई विकल्प बनाने का अनुरोध करें.

जेएसओएन के काेड में दिखाना
{
  "fieldId": string,
  "choice": {
    object (Choice)
  }
}
फ़ील्ड
fieldId

string

ज़रूरी है. वह चयन फ़ील्ड, जिसमें विकल्प बनाया जाएगा.

choice

object (Choice)

ज़रूरी है. कॉन्टेंट बनाने का विकल्प.

UpdateSelectionChoicePropertiesRequest

विकल्प की प्रॉपर्टी अपडेट करने का अनुरोध करें.

जेएसओएन के काेड में दिखाना
{
  "updateMask": string,
  "fieldId": string,
  "id": string,
  "properties": {
    object (Properties)
  }
}
फ़ील्ड
updateMask

string (FieldMask format)

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

fieldId

string

ज़रूरी है. अपडेट किया जाने वाला चुनने का फ़ील्ड.

id

string

ज़रूरी है. अपडेट करने का विकल्प.

properties

object (Properties)

ज़रूरी है. अपडेट करने के लिए बढ़िया प्रॉपर्टी.

EnableSelectionChoiceRequest

कोई विकल्प चालू करने का अनुरोध करें.

जेएसओएन के काेड में दिखाना
{
  "fieldId": string,
  "id": string
}
फ़ील्ड
fieldId

string

ज़रूरी है. वह चयन फ़ील्ड जिसमें विकल्प को चालू किया जाएगा.

id

string

ज़रूरी है. चालू करने का विकल्प चुनें.

DisableSelectionChoiceRequest

किसी विकल्प को बंद करने का अनुरोध करना.

जेएसओएन के काेड में दिखाना
{
  "updateMask": string,
  "fieldId": string,
  "id": string,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
फ़ील्ड
updateMask

string (FieldMask format)

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

fieldId

string

ज़रूरी है. वह चयन फ़ील्ड जिसमें किसी विकल्प को अक्षम कर दिया जाएगा.

id

string

ज़रूरी है. बंद करने का विकल्प.

disabledPolicy

object (DisabledPolicy)

ज़रूरी है. अपडेट की जाने वाली बंद की गई नीति.

DeleteSelectionChoiceRequest

किसी विकल्प को मिटाने का अनुरोध करें.

जेएसओएन के काेड में दिखाना
{
  "fieldId": string,
  "id": string
}
फ़ील्ड
fieldId

string

ज़रूरी है. वह चुनने का फ़ील्ड जिससे विकल्प को मिटाया जाएगा.

id

string

ज़रूरी है. हटाने का विकल्प.

जवाब

किसी अपडेट से मिला एक जवाब.

जेएसओएन के काेड में दिखाना
{

  // Union field response can be only one of the following:
  "updateLabel": {
    object (UpdateLabelPropertiesResponse)
  },
  "createField": {
    object (CreateFieldResponse)
  },
  "updateField": {
    object (UpdateFieldPropertiesResponse)
  },
  "updateFieldType": {
    object (UpdateFieldTypeResponse)
  },
  "enableField": {
    object (EnableFieldResponse)
  },
  "disableField": {
    object (DisableFieldResponse)
  },
  "deleteField": {
    object (DeleteFieldResponse)
  },
  "createSelectionChoice": {
    object (CreateSelectionChoiceResponse)
  },
  "updateSelectionChoiceProperties": {
    object (UpdateSelectionChoicePropertiesResponse)
  },
  "enableSelectionChoice": {
    object (EnableSelectionChoiceResponse)
  },
  "disableSelectionChoice": {
    object (DisableSelectionChoiceResponse)
  },
  "deleteSelectionChoice": {
    object (DeleteSelectionChoiceResponse)
  }
  // End of list of possible types for union field response.
}
फ़ील्ड
यूनियन फ़ील्ड response. इससे जुड़े अनुरोध का जवाब. response इनमें से सिर्फ़ एक हो सकती है:
updateLabel

object (UpdateLabelPropertiesResponse)

लेबल की बुनियादी प्रॉपर्टी अपडेट की गईं.

createField

object (CreateFieldResponse)

एक नया फ़ील्ड बनाता है.

updateField

object (UpdateFieldPropertiesResponse)

फ़ील्ड की बुनियादी प्रॉपर्टी को अपडेट करता है.

updateFieldType

object (UpdateFieldTypeResponse)

फ़ील्ड के टाइप और/या टाइप के विकल्पों को अपडेट करें.

enableField

object (EnableFieldResponse)

फ़ील्ड चालू करता है.

disableField

object (DisableFieldResponse)

फ़ील्ड को बंद करता है.

deleteField

object (DeleteFieldResponse)

लेबल से फ़ील्ड को मिटाता है.

createSelectionChoice

object (CreateSelectionChoiceResponse)

किसी चयन फ़ील्ड में जोड़ने के लिए एक नया चयन सूची विकल्प बनाता है.

updateSelectionChoiceProperties

object (UpdateSelectionChoicePropertiesResponse)

चुने गए फ़ील्ड में कोई विकल्प अपडेट करता है.

enableSelectionChoice

object (EnableSelectionChoiceResponse)

किसी चयन फ़ील्ड में विकल्प सक्षम करता है.

disableSelectionChoice

object (DisableSelectionChoiceResponse)

किसी चयन फ़ील्ड में विकल्प को अक्षम करता है.

deleteSelectionChoice

object (DeleteSelectionChoiceResponse)

चुनने के फ़ील्ड से किसी विकल्प को मिटाता है.

UpdateLabelPropertiesResponse

लेबल प्रॉपर्टी में अपडेट होने के बाद जवाब.

CreateFieldResponse

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

जेएसओएन के काेड में दिखाना
{
  "id": string,
  "priority": integer
}
फ़ील्ड
id

string

बनाए गए फ़ील्ड का फ़ील्ड. अनुरोध करने के लिए अगर कोई वैल्यू खाली छोड़ दी जाती है, तो एक कुंजी अपने-आप जनरेट हो जाएगी. इसकी पहचान यहां की जा सकती है.

priority

integer

बनाए गए फ़ील्ड की प्राथमिकता. प्राथमिकता, फ़ील्ड (1-n) के बीच एक जैसी प्राथमिकताओं को तय करने के लिए तय की गई प्राथमिकता से बदल सकती है.

UpdateFieldPropertiesResponse

फ़ील्ड प्रॉपर्टी में अपडेट होने के बाद रिस्पॉन्स.

जेएसओएन के काेड में दिखाना
{
  "priority": integer
}
फ़ील्ड
priority

integer

अपडेट किए गए फ़ील्ड की प्राथमिकता. प्राथमिकता, फ़ील्ड (1-n) के बीच एक जैसी प्राथमिकताओं को तय करने के लिए तय की गई प्राथमिकता से बदल सकती है.

UpdateFieldTypeResponse

फ़ील्ड टाइप में अपडेट होने के बाद रिस्पॉन्स.

EnableFieldResponse

फ़ील्ड चालू होने के बाद जवाब दिया गया.

DisableFieldResponse

फ़ील्ड बंद होने के बाद रिस्पॉन्स.

DeleteFieldResponse

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

CreateSelectionChoiceResponse

चुनने का विकल्प बनाने के बाद जवाब दिया गया है.

जेएसओएन के काेड में दिखाना
{
  "fieldId": string,
  "id": string
}
फ़ील्ड
fieldId

string

फ़ील्ड के लिए सर्वर से जनरेट किया गया आईडी.

id

string

फ़ील्ड में चुने गए विकल्प का सर्वर से जनरेट किया गया आईडी

UpdateSelectionChoicePropertiesResponse

चुनने की पसंद वाली प्रॉपर्टी से जुड़े अपडेट के बाद दिया गया जवाब.

जेएसओएन के काेड में दिखाना
{
  "priority": integer
}
फ़ील्ड
priority

integer

अपडेट किए गए विकल्प की प्राथमिकता. प्राथमिकता, विकल्पों (1-n) के बीच एक जैसी प्राथमिकताओं को पक्का करने के लिए तय की गई प्राथमिकता से बदल सकती है.

EnableSelectionChoiceResponse

विकल्प चालू करने के बाद जवाब दिया गया.

DisableSelectionChoiceResponse

विकल्प बंद होने के बाद रिस्पॉन्स.

DeleteSelectionChoiceResponse

विकल्प मिटाने के बाद जवाब.