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

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

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

लेबल अपडेट करने का जवाब.

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

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

object (Response)

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

object (Label)

अपडेट लागू होने के बाद का लेबल. इसे सिर्फ़ तब सेट किया जाता है, जब 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

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

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