REST Resource: spreadsheets.developerMetadata

संसाधन: DeveloperMetadata

स्प्रेडशीट में किसी जगह या ऑब्जेक्ट से जुड़ा डेवलपर मेटाडेटा. ज़्यादा जानकारी के लिए, मेटाडेटा को पढ़ना, लिखना, और खोजना लेख पढ़ें.

डेवलपर मेटाडेटा का इस्तेमाल, स्प्रेडशीट के अलग-अलग हिस्सों में किसी भी तरह का डेटा जोड़ने के लिए किया जा सकता है. यह डेटा, स्प्रेडशीट के उन हिस्सों से जुड़ा रहेगा. भले ही, स्प्रेडशीट में बदलाव किया जाए या उसे एक जगह से दूसरी जगह ले जाया जाए. उदाहरण के लिए, अगर डेवलपर मेटाडेटा को पांचवीं लाइन से जोड़ा गया है और इसके बाद पांचवीं लाइन के ऊपर एक और लाइन डाली जाती है, तो वह ओरिजनल मेटाडेटा अब भी उसी लाइन से जुड़ा रहेगा जिससे वह पहले जुड़ा था. अब वह लाइन छठी लाइन बन गई है. अगर उससे जुड़ा ऑब्जेक्ट मिटा दिया जाता है, तो उसका मेटाडेटा भी मिट जाता है.

JSON के काेड में दिखाना 
{
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "location": {
    object (DeveloperMetadataLocation)
  },
  "visibility": enum (DeveloperMetadataVisibility)
}
फ़ील्ड
metadataId

integer

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

string

मेटाडेटा की. ऐसा हो सकता है कि किसी स्प्रेडशीट में एक ही कुंजी के लिए कई मेटाडेटा मौजूद हों. डेवलपर मेटाडेटा में हमेशा एक कुंजी तय की जानी चाहिए.
metadataValue

string

मेटाडेटा की से जुड़ा डेटा.
location

object (DeveloperMetadataLocation)

वह जगह जहां मेटाडेटा जुड़ा हुआ है.
visibility

enum (DeveloperMetadataVisibility)

मेटाडेटा किसको दिखे. डेवलपर मेटाडेटा के लिए, हमेशा यह जानकारी दी जानी चाहिए कि इसे कौन देख सकता है.

DeveloperMetadataLocation

स्प्रेडशीट में ऐसी जगह जहां मेटाडेटा जोड़ा जा सकता है.

JSON के काेड में दिखाना 
{
  "locationType": enum (DeveloperMetadataLocationType),

  // Union field location can be only one of the following:
  "spreadsheet": boolean,
  "sheetId": integer,
  "dimensionRange": {
    object (DimensionRange)
  }
  // End of list of possible types for union field location.
}
फ़ील्ड
locationType

enum (DeveloperMetadataLocationType)

यह ऑब्जेक्ट किस तरह की जगह को दिखाता है. इस फ़ील्ड में मौजूद डेटा को सिर्फ़ पढ़ा जा सकता है.
यूनियन फ़ील्ड location. वह जगह जहां मेटाडेटा जुड़ा होता है. location इनमें से सिर्फ़ एक हो सकता है:
spreadsheet

boolean

अगर मेटाडेटा पूरी स्प्रेडशीट से जुड़ा है, तो यह वैल्यू True होती है.
sheetId

integer

जब मेटाडेटा किसी पूरी शीट से जुड़ा होता है, तब शीट का आईडी.
dimensionRange

object (DimensionRange)

जब मेटाडेटा किसी डाइमेंशन से जुड़ा होता है, तब यह पंक्ति या कॉलम को दिखाता है. DimensionRange के तौर पर, सिर्फ़ एक पंक्ति या कॉलम चुना जा सकता है. इसे असीमित नहीं किया जा सकता. साथ ही, यह एक से ज़्यादा पंक्तियों या कॉलम में नहीं फैला हो सकता.

DeveloperMetadataLocationType

उन जगहों की गिनती जहां डेवलपर मेटाडेटा को जोड़ा जा सकता है.

Enums
DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED डिफ़ॉल्ट मान.
ROW पूरी लाइन के डाइमेंशन से जुड़ा डेवलपर मेटाडेटा.
COLUMN पूरे कॉलम डाइमेंशन से जुड़ा डेवलपर मेटाडेटा.
SHEET पूरी शीट से जुड़ा डेवलपर मेटाडेटा.
SPREADSHEET पूरी स्प्रेडशीट से जुड़ा डेवलपर मेटाडेटा.

DeveloperMetadataVisibility

मेटाडेटा दिखने की संभावित स्थितियों की गिनती.

Enums
DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED डिफ़ॉल्ट मान.
DOCUMENT दस्तावेज़ में दिखने वाला मेटाडेटा, उस दस्तावेज़ को ऐक्सेस करने वाले किसी भी डेवलपर प्रोजेक्ट से ऐक्सेस किया जा सकता है.
PROJECT प्रोजेक्ट में दिखने वाला मेटाडेटा, सिर्फ़ उस डेवलपर प्रोजेक्ट को दिखता है और उसे ऐक्सेस किया जा सकता है जिसने मेटाडेटा बनाया है.

तरीके

get

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