REST Resource: labels

रिसॉर्स: लेबल

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

JSON के काेड में दिखाना
{
  "name": string,
  "id": string,
  "revisionId": string,
  "labelType": enum (LabelType),
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "revisionCreator": {
    object (UserInfo)
  },
  "revisionCreateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "publishTime": string,
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "customer": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedLabelPolicy": {
    object (AppliedLabelPolicy)
  },
  "fields": [
    {
      object (Field)
    }
  ],
  "learnMoreUri": string,
  "lockStatus": {
    object (LockStatus)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. लेबल के संसाधन का नाम. अनुरोध के आधार पर, इनमें से किसी एक का इस्तेमाल किया जा सकता है: labels/{id} या labels/{id}@{revisionId}. id और revisionId नीचे देखें.

id

string

सिर्फ़ आउटपुट के लिए. इस लेबल का दुनिया भर में इस्तेमाल होने वाला यूनीक आइडेंटिफ़ायर. आईडी, लेबल name का हिस्सा है, लेकिन name के उलट, आईडी बदलावों के बीच एक जैसा होता है. रेगुलर एक्सप्रेशन से मैच करता है: ([a-zA-Z0-9])+

revisionId

string

सिर्फ़ आउटपुट के लिए. लेबल का बदलाव आईडी. किए गए अनुरोध के आधार पर, बदलाव का आईडी name लेबल का हिस्सा हो सकता है. जब किसी लेबल की संशोधित प्रॉपर्टी बदली जाती है, तो एक नया संशोधन बन जाता है. रेगुलर एक्सप्रेशन से मैच करता है: ([a-zA-Z0-9])+

labelType

enum (LabelType)

ज़रूरी है. लेबल का टाइप.

creator

object (UserInfo)

सिर्फ़ आउटपुट के लिए. वह उपयोगकर्ता जिसने यह लेबल बनाया है.

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस लेबल को बनाने का समय.

revisionCreator

object (UserInfo)

सिर्फ़ आउटपुट के लिए. वह उपयोगकर्ता जिसने यह लेबल संशोधन बनाया था.

revisionCreateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब यह लेबल संशोधन बनाया गया था.

publisher

object (UserInfo)

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

publishTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस लेबल के पब्लिश होने का समय. लेबल के पब्लिश न होने पर, इस वैल्यू का कोई मतलब नहीं होता.

disabler

object (UserInfo)

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

disableTime

string (Timestamp format)

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

customer

string

सिर्फ़ आउटपुट के लिए. वह ग्राहक, जिससे यह लेबल संबंधित है. उदाहरण के लिए: "customers/123abc789."

properties

object (Properties)

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

lifecycle

object (Lifecycle)

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

displayHints

object (DisplayHints)

सिर्फ़ आउटपुट के लिए. लेबल को रेंडर करने के लिए, यूज़र इंटरफ़ेस (यूआई) डिसप्ले के संकेत.

appliedCapabilities

object (AppliedCapabilities)

सिर्फ़ आउटपुट के लिए. लागू किए गए मेटाडेटा पर इस लेबल से जुड़ी सुविधाएं.

schemaCapabilities

object (SchemaCapabilities)

सिर्फ़ आउटपुट के लिए. इस लेबल में उपयोगकर्ता के पास क्या-क्या सुविधाएं हैं.

appliedLabelPolicy

object (AppliedLabelPolicy)

सिर्फ़ आउटपुट के लिए. Drive में मौजूद आइटम पर इस लेबल को लागू करने के बाद क्या कार्रवाई होगी.

fields[]

object (Field)

प्राथमिकता के घटते क्रम में फ़ील्ड की सूची.

learnMoreUri

string

कस्टम यूआरएल, ताकि उपयोगकर्ताओं को इस लेबल के बारे में ज़्यादा जानकारी मिल सके और यह पता चल सके कि इसका इस्तेमाल कैसे किया जाना चाहिए.

lockStatus

object (LockStatus)

सिर्फ़ आउटपुट के लिए. इस लेबल की LockStatus.

LabelType

इस लेबल का टाइप.

Enums
LABEL_TYPE_UNSPECIFIED लेबल टाइप की जानकारी नहीं है.
SHARED Drive में मौजूद आइटम पर लागू करने के लिए, उपयोगकर्ताओं के साथ शेयर किए गए लेबल शेयर किए जा सकते हैं.
ADMIN एडमिन के मालिकाना हक वाला लेबल. इन्हें सिर्फ़ एडमिन बना सकते हैं और इनमें बदलाव कर सकते हैं. सिर्फ़ एडमिन के लिए कुछ अतिरिक्त सुविधाएं काम करती हैं.

UserInfo

उपयोगकर्ता के बारे में जानकारी.

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

string

इस उपयोगकर्ता के लिए आइडेंटिफ़ायर, जिसे ज़्यादा जानकारी पाने के लिए People API के साथ इस्तेमाल किया जा सकता है. उदाहरण के लिए, लोग/12345678.

प्रॉपर्टी

लेबल की बुनियादी प्रॉपर्टी.

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

string

ज़रूरी है. लेबल का टाइटल.

description

string

लेबल का ब्यौरा.

जीवनचक्र

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

  • UNPUBLISHED_DRAFT (शुरुआत की स्थिति)
  • UNPUBLISHED_DRAFT -> PUBLISHED
  • UNPUBLISHED_DRAFT -> (मिटाया गया)
  • PUBLISHED -> DISABLED
  • DISABLED -> PUBLISHED
  • DISABLED -> (मिटाया गया)

पब्लिश की गई और बंद की गई स्थितियों की कुछ अलग-अलग विशेषताएं होती हैं:

  • पब्लिश किया गया—इस स्थिति में किसी ऑब्जेक्ट में कुछ बदलाव किए जा सकते हैं. इस स्थिति में, hasUnpublishedChanges सही होगा. साथ ही, कुछ प्रकार के परिवर्तनों की अनुमति नहीं है. आम तौर पर, ऐसे बदलाव अस्वीकार कर दिए जाते हैं जो लेबल से जुड़े मौजूदा मेटाडेटा को गलत या नई वजह मानते हों.
  • बंद होने पर—यह विकल्प बंद होने पर, कॉन्फ़िगर किया गया DisabledPolicy लागू होता है.
JSON के काेड में दिखाना
{
  "state": enum (State),
  "hasUnpublishedChanges": boolean,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
फ़ील्ड
state

enum (State)

सिर्फ़ आउटपुट के लिए. इस लाइफ़साइकल से जुड़े ऑब्जेक्ट की स्थिति.

hasUnpublishedChanges

boolean

सिर्फ़ आउटपुट के लिए. क्या इस लाइफ़साइकल से जुड़े ऑब्जेक्ट में, पब्लिश नहीं किए गए बदलाव हैं.

disabledPolicy

object (DisabledPolicy)

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

स्थिति

इस लाइफ़साइकल से जुड़े ऑब्जेक्ट की स्थिति.

Enums
STATE_UNSPECIFIED अज्ञात स्थिति.
UNPUBLISHED_DRAFT किसी ऑब्जेक्ट की शुरुआती स्थिति. पब्लिश होने के बाद, ऑब्जेक्ट कभी भी इस स्थिति में नहीं लौट सकता. ऑब्जेक्ट के पब्लिश होने के बाद, कुछ खास तरह के बदलावों की अनुमति नहीं है.
PUBLISHED ऑब्जेक्ट को पब्लिश किया जा चुका है. जैसा कि hasUnpublishedChanges में बताया गया है, ऑब्जेक्ट में, पब्लिश नहीं किए गए ड्राफ़्ट बदलाव हो सकते हैं.
DISABLED ऑब्जेक्ट को पब्लिश कर दिया गया है और उसे बंद कर दिया गया है. जैसा कि hasUnpublishedChanges में बताया गया है, ऑब्जेक्ट में, पब्लिश नहीं किए गए ड्राफ़्ट बदलाव हो सकते हैं.
DELETED ऑब्जेक्ट को हटा दिया गया है.

DisabledPolicy

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

JSON के काेड में दिखाना
{
  "hideInSearch": boolean,
  "showInApply": boolean
}
फ़ील्ड
showInApply

boolean

क्या Drive में मौजूद आइटम पर, 'लागू करें' मेन्यू में इस बंद किए गए ऑब्जेक्ट को दिखाना है या नहीं.

  • true होने पर, यूज़र इंटरफ़ेस (यूआई) में ऑब्जेक्ट को आम तौर पर 'बंद है' के तौर पर दिखाया जाता है. साथ ही, उस ऑब्जेक्ट से चुने हुए का निशान हटाया जा सकता है.
  • false होने पर, ऑब्जेक्ट आम तौर पर यूज़र इंटरफ़ेस (यूआई) में छिपा रहता है.

DisplayHints

लेबल को रेंडर करने के लिए, यूज़र इंटरफ़ेस (यूआई) डिसप्ले के संकेत.

JSON के काेड में दिखाना
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "priority": string
}
फ़ील्ड
disabled

boolean

यूज़र इंटरफ़ेस (यूआई) में लेबल को 'बंद है' के तौर पर दिखाया जाना चाहिए या नहीं.

shownInApply

boolean

Drive में मौजूद किसी आइटम पर वैल्यू लागू करते समय, यह लेबल 'लागू करें' मेन्यू में दिखना चाहिए.

priority

string (int64 format)

सूची में लेबल दिखाने के लिए ऑर्डर करें.

AppliedCapabilities

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

JSON के काेड में दिखाना
{
  "canRead": boolean,
  "canApply": boolean,
  "canRemove": boolean
}
फ़ील्ड
canRead

boolean

उपयोगकर्ता इस लेबल से जुड़ा लागू किया गया मेटाडेटा पढ़ सकता है या नहीं.

canApply

boolean

उपयोगकर्ता, आइटम पर इस लेबल को लागू कर सकता है या नहीं.

canRemove

boolean

उपयोगकर्ता, आइटम से यह लेबल हटा सकता है या नहीं.

SchemaCapabilities

लेबल में बदलाव करते समय, इस लेबल से जुड़ी सुविधाएं.

JSON के काेड में दिखाना
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
फ़ील्ड
canUpdate

boolean

उपयोगकर्ता इस लेबल को बदल सकता है या नहीं.

canDelete

boolean

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

canDisable

boolean

उपयोगकर्ता इस लेबल को बंद कर सकता है या नहीं. उपयोगकर्ता के पास अनुमति होनी चाहिए और यह लेबल पहले से बंद नहीं होना चाहिए.

canEnable

boolean

उपयोगकर्ता इस लेबल को चालू कर सकता है या नहीं. उपयोगकर्ता के पास अनुमति होनी चाहिए और यह लेबल बंद होना चाहिए.

AppliedLabelPolicy

Drive में मौजूद आइटम पर इस लेबल को लागू करने के बाद क्या कार्रवाई होगी.

JSON के काेड में दिखाना
{
  "copyMode": enum (CopyMode)
}
फ़ील्ड
copyMode

enum (CopyMode)

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

CopyMode

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

Enums
COPY_MODE_UNSPECIFIED कॉपी मोड की जानकारी नहीं है.
DO_NOT_COPY जब Drive में मौजूद आइटम को कॉपी किया जाता है, तब लागू किए गए लेबल और फ़ील्ड की वैल्यू, डिफ़ॉल्ट रूप से कॉपी नहीं होती हैं.
ALWAYS_COPY जब Drive में लागू किए गए आइटम को कॉपी किया जाता है, तब लागू किए गए लेबल और फ़ील्ड की वैल्यू हमेशा कॉपी होती हैं. इस मोड का इस्तेमाल सिर्फ़ एडमिन कर सकते हैं.
COPY_APPLIABLE अगर उपयोगकर्ता उस लेबल को कॉपी कर सकता है, तो लागू किए गए लेबल और फ़ील्ड की वैल्यू कॉपी की जाती हैं.

फ़ील्ड

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

JSON के काेड में दिखाना
{
  "id": string,
  "queryKey": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "updater": {
    object (UserInfo)
  },
  "updateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "lockStatus": {
    object (LockStatus)
  },

  // Union field type 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.
}
फ़ील्ड
id

string

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

यह वैल्यू अपने-आप जनरेट हुई है. रेगुलर एक्सप्रेशन से मैच करता है: ([a-zA-Z0-9])+

queryKey

string

सिर्फ़ आउटपुट के लिए. इस कुंजी का इस्तेमाल Drive की खोज क्वेरी बनाते समय किया जाता है. इसकी मदद से, फ़ाइलों पर इस फ़ील्ड के लिए तय की गई वैल्यू के आधार पर फ़ाइलें ढूंढी जा सकती हैं. उदाहरण के लिए, "{queryKey} > 01-01-2001".

properties

object (Properties)

फ़ील्ड की बुनियादी प्रॉपर्टी.

lifecycle

object (Lifecycle)

सिर्फ़ आउटपुट के लिए. इस फ़ील्ड का लाइफ़साइकल.

displayHints

object (DisplayHints)

सिर्फ़ आउटपुट के लिए. किसी फ़ील्ड को रेंडर करने के लिए यूज़र इंटरफ़ेस (यूआई) डिसप्ले.

schemaCapabilities

object (SchemaCapabilities)

सिर्फ़ आउटपुट के लिए. इस फ़ील्ड में बदलाव करते समय, इस उपयोगकर्ता के पास कौन-कौनसी सुविधाएं होती हैं.

appliedCapabilities

object (AppliedCapabilities)

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

creator

object (UserInfo)

सिर्फ़ आउटपुट के लिए. वह उपयोगकर्ता जिसने यह फ़ील्ड बनाया था.

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस फ़ील्ड को बनाए जाने का समय.

updater

object (UserInfo)

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

updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस फ़ील्ड को अपडेट करने का समय.

publisher

object (UserInfo)

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

disabler

object (UserInfo)

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

disableTime

string (Timestamp format)

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

lockStatus

object (LockStatus)

सिर्फ़ आउटपुट के लिए. इस फ़ील्ड का LockStatus.

यूनियन फ़ील्ड type. इस फ़ील्ड का डेटा टाइप और विकल्प. पब्लिश होने के बाद, डेटा टाइप को बदला नहीं जा सकता. type इनमें से सिर्फ़ एक हो सकता है:
textOptions

object (TextOptions)

टेक्स्ट फ़ील्ड के विकल्प.

integerOptions

object (IntegerOptions)

पूर्णांक फ़ील्ड के विकल्प.

dateOptions

object (DateOptions)

तारीख वाले फ़ील्ड के विकल्प.

selectionOptions

object (SelectionOptions)

चुनने के लिए बने फ़ील्ड के विकल्प.

userOptions

object (UserOptions)

उपयोगकर्ता फ़ील्ड के विकल्प.

TextOptions

टेक्स्ट फ़ील्ड टाइप के लिए विकल्प.

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

integer

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

maxLength

integer

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

IntegerOptions

पूर्णांक फ़ील्ड टाइप के लिए विकल्प.

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

string (int64 format)

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

maxValue

string (int64 format)

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

DateOptions

तारीख वाले फ़ील्ड के टाइप के विकल्प.

JSON के काेड में दिखाना
{
  "dateFormatType": enum (DateFormat),
  "dateFormat": string,
  "minValue": {
    object (Date)
  },
  "maxValue": {
    object (Date)
  }
}
फ़ील्ड
dateFormatType

enum (DateFormat)

स्थानीय जगह के अनुसार तारीख को फ़ॉर्मैट करने का विकल्प. फ़ील्ड की वैल्यू, स्थान-भाषा के हिसाब से इस फ़ॉर्मैट में रेंडर की जाती हैं.

dateFormat

string

सिर्फ़ आउटपुट के लिए. ICU तारीख का फ़ॉर्मैट.

minValue

object (Date)

सिर्फ़ आउटपुट के लिए. कम से कम मान्य वैल्यू (साल, महीना, दिन).

maxValue

object (Date)

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

DateFormat

स्थानीय जगह के अनुसार तारीख के फ़ॉर्मैट के विकल्प.

Enums
DATE_FORMAT_UNSPECIFIED तारीख का फ़ॉर्मैट नहीं बताया गया है.
LONG_DATE इसमें महीने का पूरा नाम शामिल है. उदाहरण के लिए, 12 जनवरी, 1999 (MMMM d, y)
SHORT_DATE छोटा, संख्यात्मक, निरूपण. जैसे, 12/13/99 (M/d/yy)

तारीख

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

  • पूरी तारीख, जिसमें साल, महीने, और दिन की वैल्यू शून्य के अलावा किसी अन्य वैल्यू के तौर पर शामिल हों.
  • कोई महीना और दिन, जिसमें शून्य साल लिखा हो. जैसे, सालगिरह.
  • अपने आप में एक वर्ष, एक शून्य महीना और एक शून्य दिन.
  • साल और महीने, जिनमें दिन और समय शून्य हो. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म होने की तारीख.

मिलते-जुलते टाइप:

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

integer

तारीख का साल. 1 से 9999 के बीच की संख्या होनी चाहिए, या बिना साल वाली तारीख को बताने के लिए 0 होना चाहिए.

month

integer

साल का महीना. यह वैल्यू 1 से 12 के बीच होनी चाहिए. अगर किसी साल में महीना और दिन नहीं है, तो उस साल की जानकारी देने के लिए यह संख्या 0 होनी चाहिए.

day

integer

महीने का दिन. इसमें 1 से 31 तक का अंतर हो सकता है. साथ ही, यह साल और महीने के लिए मान्य होना चाहिए. इसके अलावा, किसी साल के बारे में बताने के लिए, वैल्यू 0 होनी चाहिए या साल और महीने के बीच की कोई खास जानकारी नहीं होनी चाहिए.

SelectionOptions

फ़ील्ड टाइप के लिए विकल्प.

JSON के काेड में दिखाना
{
  "listOptions": {
    object (ListOptions)
  },
  "choices": [
    {
      object (Choice)
    }
  ]
}
फ़ील्ड
listOptions

object (ListOptions)

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

choices[]

object (Choice)

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

ListOptions

इससे जुड़े फ़ील्ड टाइप के कई वैल्यू वाले वैरिएंट के विकल्प.

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

integer

ज़्यादा से ज़्यादा एंट्री की अनुमति है.

विकल्प

चुनने के लिए फ़ील्ड.

JSON के काेड में दिखाना
{
  "id": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "updater": {
    object (UserInfo)
  },
  "updateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "publishTime": string,
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "lockStatus": {
    object (LockStatus)
  }
}
फ़ील्ड
id

string

चुने गए विकल्प की यूनीक वैल्यू. यह आईडी अपने-आप जनरेट होता है. रेगुलर एक्सप्रेशन से मैच करता है: ([a-zA-Z0-9_])+.

properties

object (Properties)

विकल्प की बुनियादी प्रॉपर्टी.

lifecycle

object (Lifecycle)

सिर्फ़ आउटपुट के लिए. पसंद का लाइफ़साइकल.

displayHints

object (DisplayHints)

सिर्फ़ आउटपुट के लिए. विकल्प दिखाने के लिए यूज़र इंटरफ़ेस (यूआई) डिसप्ले.

schemaCapabilities

object (SchemaCapabilities)

सिर्फ़ आउटपुट के लिए. विकल्प में बदलाव करते समय, इससे जुड़ी सुविधाएं.

appliedCapabilities

object (AppliedCapabilities)

सिर्फ़ आउटपुट के लिए. लागू किए गए मेटाडेटा पर, इस विकल्प से जुड़ी सुविधाएं.

creator

object (UserInfo)

सिर्फ़ आउटपुट के लिए. वह उपयोगकर्ता जिसने यह विकल्प बनाया.

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस विकल्प को बनाने का समय.

updater

object (UserInfo)

सिर्फ़ आउटपुट के लिए. वह उपयोगकर्ता जिसने पिछली बार इस विकल्प को अपडेट किया था.

updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस पसंद को पिछली बार अपडेट किए जाने का समय.

publisher

object (UserInfo)

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

publishTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस विकल्प को पब्लिश करने का समय. अगर चुने गए विकल्प को पब्लिश न किया गया हो, तो इस वैल्यू का कोई मतलब नहीं होता.

disabler

object (UserInfo)

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

disableTime

string (Timestamp format)

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

lockStatus

object (LockStatus)

सिर्फ़ आउटपुट के लिए. इस विकल्प का LockStatus.

प्रॉपर्टी

विकल्प की बुनियादी प्रॉपर्टी.

JSON के काेड में दिखाना
{
  "displayName": string,
  "description": string,
  "badgeConfig": {
    object (BadgeConfig)
  },
  "insertBeforeChoice": string
}
फ़ील्ड
displayName

string

ज़रूरी है. इस फ़ील्ड की पहचान करने वाले यूज़र इंटरफ़ेस (यूआई) में दिखाया जाने वाला टेक्स्ट.

description

string

इस लेबल का ब्यौरा.

badgeConfig

object (BadgeConfig)

इस विकल्प के लिए बैज कॉन्फ़िगरेशन. अगर किसी लेबल को सेट किया जाता है, तो उसे "बैज वाला लेबल" माना जाता है.

insertBeforeChoice

string

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

BadgeConfig

लेबल के बैज की स्थिति.

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

object (Color)

बैज का रंग. अगर इसके बारे में नहीं बताया गया है, तो कोई बैज रेंडर नहीं किया जाता. यहां सेट किए गए बैकग्राउंड, फ़ोरग्राउंड, और सोलो (हल्के और गहरे रंग वाले मोड) रंग, Drive के यूज़र इंटरफ़ेस (यूआई) में सुझाए गए कलर में बदल जाते हैं.

priorityOverride

string (int64 format)

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

रंग

RGBA कलर स्पेस में कोई रंग दिखाता है. यह प्रज़ेंटेशन इस तरह से डिज़ाइन किया गया है कि कॉम्पैक्टनेस के बजाय, अलग-अलग भाषाओं में रंग को आसानी से समझा जा सके और उन्हें अलग-अलग भाषाओं में कैसे दिखाया जा सके. उदाहरण के लिए, इस प्रतिनिधित्व के फ़ील्ड को Java में java.awt.Color के कंस्ट्रक्टर को आसानी से दिया जा सकता है; इसे iOS में, UIColor के +colorWithRed:green:blue:alpha तरीके में भी आसानी से उपलब्ध कराया जा सकता है; और बस थोड़ी सी मेहनत करके, इसे JavaScript में सीएसएस rgba() स्ट्रिंग में आसानी से फ़ॉर्मैट किया जा सकता है.

इस रेफ़रंस पेज में उस ऐब्सलूट कलर स्पेस से जुड़ी जानकारी नहीं है जिसका इस्तेमाल आरजीबी वैल्यू को समझने के लिए किया जाना चाहिए. उदाहरण के लिए, sRGB, Adobe RGB, DCI-P3, और BT.2020. डिफ़ॉल्ट रूप से, ऐप्लिकेशन को sRGB में कलर स्पेस के तौर पर माना जाना चाहिए.

जब रंग की समानता तय करने की ज़रूरत हो, तो लागू करने पर, जब तक कि कोई और दस्तावेज़ न हो, दो रंगों को बराबर मानें. अगर सभी लाल, हरे, नीले और ऐल्फ़ा वैल्यू में से हर एक की वैल्यू में ज़्यादा से ज़्यादा 1e-5 का अंतर हो.

उदाहरण (Java):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

उदाहरण (iOS / Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

उदाहरण (JavaScript):

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
JSON के काेड में दिखाना
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
फ़ील्ड
red

number

इंटरवल [0, 1] में वैल्यू के तौर पर रंग में लाल रंग.

green

number

इंटरवल [0, 1] में वैल्यू के तौर पर रंग में हरे रंग की मात्रा.

blue

number

इंटरवल [0, 1] में वैल्यू के तौर पर रंग में नीले रंग की मात्रा.

alpha

number

इस रंग का वह हिस्सा, जिसे पिक्सल पर लागू किया जाना चाहिए. इसका मतलब है कि आखिरी पिक्सल का रंग समीकरण से तय होता है:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

इसका मतलब है कि 1.0 वैल्यू किसी ठोस रंग से मेल खाती है, जबकि 0.0 वैल्यू पूरी तरह से पारदर्शी रंग से मेल खाती है. यह किसी सामान्य फ़्लोट स्केलर के बजाय रैपर मैसेज का इस्तेमाल करता है, ताकि डिफ़ॉल्ट वैल्यू और सेट न की जा रही वैल्यू के बीच अंतर किया जा सके. अगर छोड़ दिया जाता है, तो इस रंग ऑब्जेक्ट को एक ठोस रंग के रूप में रेंडर किया जाता है (जैसे कि ऐल्फ़ा वैल्यू को साफ़ तौर पर 1.0 का मान दिया गया था).

DisplayHints

किसी विकल्प को रेंडर करने के लिए यूज़र इंटरफ़ेस (यूआई) डिसप्ले.

JSON के काेड में दिखाना
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "badgeColors": {
    object (BadgeColors)
  },
  "darkBadgeColors": {
    object (BadgeColors)
  },
  "badgePriority": string
}
फ़ील्ड
disabled

boolean

क्या विकल्प को यूज़र इंटरफ़ेस (यूआई) में 'बंद है' के तौर पर दिखाना चाहिए.

shownInApply

boolean

Drive में मौजूद किसी आइटम पर वैल्यू लागू करते समय, यह विकल्प 'लागू करें' मेन्यू में दिखना चाहिए.

badgeColors

object (BadgeColors)

बैज के लिए इस्तेमाल होने वाले रंग. चुने गए properties.badge_config.color के आधार पर, Google Material के रंगों में बदला गया है.

darkBadgeColors

object (BadgeColors)

बैज के लिए इस्तेमाल करने के लिए गहरे रंग वाला मोड. चुने गए properties.badge_config.color के आधार पर, Google Material के रंगों में बदला गया है.

badgePriority

string (int64 format)

इस बैज की प्राथमिकता. इसका इस्तेमाल, एक से ज़्यादा बैज की तुलना करने और उन्हें क्रम से लगाने के लिए किया जाता है. स्कोर के कम होने का मतलब है कि बैज पहले दिखाया जाना चाहिए. अगर बैजिंग कॉन्फ़िगरेशन मौजूद नहीं है, तो यह 0 होगा. ऐसा न करने पर, इसे BadgeConfig.priority_override या डिफ़ॉल्ट अनुमान पर सेट कर दिया जाएगा, जो लेबल बनाने की तारीख, फ़ील्ड और विकल्प की प्राथमिकता को प्राथमिकता देता है.

BadgeColors

Badgeconfig से लिए गए रंग को, इस्तेमाल किए जा सकने वाले सबसे सही रंग में बदल दिया गया है.

JSON के काेड में दिखाना
{
  "backgroundColor": {
    object (Color)
  },
  "foregroundColor": {
    object (Color)
  },
  "soloColor": {
    object (Color)
  }
}
फ़ील्ड
backgroundColor

object (Color)

सिर्फ़ आउटपुट के लिए. फ़ोरग्राउंड के साथ पेयर करने वाला बैज बैकग्राउंड.

foregroundColor

object (Color)

सिर्फ़ आउटपुट के लिए. फ़ोरग्राउंड वाला बैज, जो बैकग्राउंड के साथ जुड़ता है.

soloColor

object (Color)

सिर्फ़ आउटपुट के लिए. बिना बैकग्राउंड वाले टेक्स्ट के लिए इस्तेमाल किया जा सकने वाला रंग.

SchemaCapabilities

चुने गए विकल्प में बदलाव करते समय उससे जुड़ी सुविधाएं.

JSON के काेड में दिखाना
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
फ़ील्ड
canUpdate

boolean

उपयोगकर्ता इस विकल्प को अपडेट कर सकता है या नहीं.

canDelete

boolean

उपयोगकर्ता इस विकल्प को मिटा सकता है या नहीं.

canDisable

boolean

उपयोगकर्ता इस विकल्प को बंद कर सकता है या नहीं.

canEnable

boolean

उपयोगकर्ता इस विकल्प को चालू कर सकता है या नहीं.

AppliedCapabilities

लागू किए गए मेटाडेटा पर, इस विकल्प से जुड़ी सुविधाएं.

JSON के काेड में दिखाना
{
  "canRead": boolean,
  "canSearch": boolean,
  "canSelect": boolean
}
फ़ील्ड
canRead

boolean

उपयोगकर्ता किसी आइटम पर लागू किए गए मिलते-जुलते मेटाडेटा को पढ़ सकता है या नहीं.

canSelect

boolean

उपयोगकर्ता किसी आइटम पर यह विकल्प चुन सकता है या नहीं.

LockStatus

इसमें यह जानकारी होती है कि लेबल कॉम्पोनेंट को लॉक किया जाना चाहिए या नहीं.

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

boolean

सिर्फ़ आउटपुट के लिए. बताता है कि यह लेबल घटक किसी LabelLock का (प्रत्यक्ष) लक्ष्य है या नहीं. लेबल कॉम्पोनेंट को इंप्लिसिट तरीके से लॉक किया जा सकता है, भले ही वह किसी LabelLock का डायरेक्ट टारगेट न हो. इस स्थिति में, इस फ़ील्ड को 'गलत' पर सेट किया जाता है.

UserOptions

उपयोगकर्ता फ़ील्ड टाइप के लिए विकल्प.

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

object (ListOptions)

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

प्रॉपर्टी

फ़ील्ड की बुनियादी प्रॉपर्टी.

JSON के काेड में दिखाना
{
  "displayName": string,
  "required": boolean,
  "insertBeforeField": string
}
फ़ील्ड
displayName

string

ज़रूरी है. इस फ़ील्ड की पहचान करने वाले यूज़र इंटरफ़ेस (यूआई) में दिखाया जाने वाला टेक्स्ट.

required

boolean

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

insertBeforeField

string

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

DisplayHints

किसी फ़ील्ड को रेंडर करने के लिए यूज़र इंटरफ़ेस (यूआई) डिसप्ले.

JSON के काेड में दिखाना
{
  "required": boolean,
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean
}
फ़ील्ड
required

boolean

फ़ील्ड को यूज़र इंटरफ़ेस (यूआई) में ज़रूरत के मुताबिक दिखाना चाहिए या नहीं.

disabled

boolean

फ़ील्ड को यूज़र इंटरफ़ेस (यूआई) में 'बंद है' के तौर पर दिखाना चाहिए या नहीं.

shownInApply

boolean

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

SchemaCapabilities

फ़ील्ड में बदलाव करते समय, इस फ़ील्ड से जुड़ी सुविधाएं.

JSON के काेड में दिखाना
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
फ़ील्ड
canUpdate

boolean

उपयोगकर्ता इस फ़ील्ड को बदल सकता है या नहीं.

canDelete

boolean

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

canDisable

boolean

उपयोगकर्ता इस फ़ील्ड को बंद कर सकता है या नहीं. उपयोगकर्ता के पास अनुमति होनी चाहिए और यह फ़ील्ड पहले से बंद नहीं होना चाहिए.

canEnable

boolean

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

AppliedCapabilities

लागू किए गए मेटाडेटा पर, इस फ़ील्ड से जुड़ी सुविधाएं.

JSON के काेड में दिखाना
{
  "canRead": boolean,
  "canSearch": boolean,
  "canWrite": boolean
}
फ़ील्ड
canRead

boolean

उपयोगकर्ता किसी आइटम पर लागू किए गए मिलते-जुलते मेटाडेटा को पढ़ सकता है या नहीं.

canWrite

boolean

उपयोगकर्ता, Drive में मौजूद आइटम पर इस फ़ील्ड को सेट कर सकता है या नहीं.

तरीके

create

एक नया लेबल बनाता है.

delete

Drive में मौजूद आइटम से लेबल और उससे जुड़ा मेटाडेटा हमेशा के लिए मिटा दिया जाता है.

delta

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

disable

पब्लिश किए गए लेबल को बंद करें.

enable

बंद किए गए लेबल को चालू करें और उसे पब्लिश की गई स्थिति पर वापस लाएं.

get

लेबल को उसके संसाधन नाम के आधार पर पाएं.

list

लेबल की सूची बनाएं.

publish

ड्राफ़्ट के सभी बदलावों को लेबल में पब्लिश करें.

updateLabelCopyMode

किसी लेबल की CopyMode को अपडेट करता है.

updatePermissions

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