Method: labels.delta

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

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना
{
  "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

BCP-47 भाषा कोड, जिसका इस्तेमाल स्थानीय भाषा में फ़ील्ड लेबल का आकलन करने के लिए किया जाता है. ऐसा तब किया जाता है, जब include_label_in_response की वैल्यू true हो.

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

लेबल अपडेट करने का रिस्पॉन्स.

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

JSON के काेड में दिखाना
{
  "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

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

अनुरोध

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

JSON के काेड में दिखाना
{

  // 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

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

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

string (FieldMask format)

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

properties

object (Properties)

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

CreateFieldRequest

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

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

object (Field)

ज़रूरी है. फ़ील्ड बनाना.

UpdateFieldPropertiesRequest

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

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

string (FieldMask format)

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

id

string

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

properties

object (Properties)

ज़रूरी है. बुनियादी फ़ील्ड प्रॉपर्टी.

UpdateFieldTypeRequest

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

JSON के काेड में दिखाना
{
  "updateMask": string,
  "id": string,

  // Union field type_options can be only one of the following:
  "textOptions": {
    object (TextOptions)
  },
  "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)

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

integerOptions

object (IntegerOptions)

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

dateOptions

object (DateOptions)

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

selectionOptions

object (SelectionOptions)

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

userOptions

object (UserOptions)

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

EnableFieldRequest

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

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

string

ज़रूरी है. जिस फ़ील्ड को चालू करना है उसका आईडी.

DisableFieldRequest

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

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

string (FieldMask format)

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

id

string

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

disabledPolicy

object (DisabledPolicy)

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

DeleteFieldRequest

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

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

string

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

CreateSelectionChoiceRequest

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

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

string

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

choice

object (Choice)

ज़रूरी है. बनाने की सुविधा.

UpdateSelectionChoicePropertiesRequest

किसी चॉइस प्रॉपर्टी को अपडेट करने का अनुरोध करना.

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

string (FieldMask format)

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

fieldId

string

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

id

string

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

properties

object (Properties)

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

EnableSelectionChoiceRequest

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

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

string

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

id

string

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

DisableSelectionChoiceRequest

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

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

string (FieldMask format)

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

fieldId

string

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

id

string

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

disabledPolicy

object (DisabledPolicy)

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

DeleteSelectionChoiceRequest

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

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

string

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

id

string

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

जवाब

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

JSON के काेड में दिखाना
{

  // 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

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

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

string

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

priority

integer

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

UpdateFieldPropertiesResponse

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

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

integer

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

UpdateFieldTypeResponse

इस टाइप में कोई फ़ील्ड नहीं होता.

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

EnableFieldResponse

इस टाइप में कोई फ़ील्ड नहीं होता.

जवाब के बाद दिखने वाला फ़ील्ड चालू है.

DisableFieldResponse

इस टाइप में कोई फ़ील्ड नहीं होता.

फ़ील्ड बंद करने के बाद मिलने वाला जवाब.

DeleteFieldResponse

इस टाइप में कोई फ़ील्ड नहीं होता.

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

CreateSelectionChoiceResponse

जवाब, चुने गए विकल्प बनाने के बाद.

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

string

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

id

string

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

UpdateSelectionChoicePropertiesResponse

'चुनी गई पसंद' प्रॉपर्टी को अपडेट करने के बाद मिलने वाला रिस्पॉन्स.

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

integer

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

EnableSelectionChoiceResponse

इस टाइप में कोई फ़ील्ड नहीं होता.

'पसंदीदा जवाब' सुविधा चालू करने के बाद मिलने वाला जवाब.

DisableSelectionChoiceResponse

इस टाइप में कोई फ़ील्ड नहीं होता.

जवाब के लिए, 'पसंदीदा विकल्प' सुविधा बंद है.

DeleteSelectionChoiceResponse

इस टाइप में कोई फ़ील्ड नहीं होता.

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