REST Resource: spreadsheets.developerMetadata

संसाधन: DeveloperMetadata

स्प्रेडशीट में मौजूद किसी जगह या ऑब्जेक्ट से जुड़ा डेवलपर मेटाडेटा. डेवलपर मेटाडेटा का इस्तेमाल स्प्रेडशीट के अलग-अलग हिस्सों के साथ आर्बिट्रेरी डेटा को जोड़ने के लिए किया जा सकता है. साथ ही, जब स्प्रेडशीट में बदलाव होता है, तो यह उन जगहों पर जुड़ा रहता है. उदाहरण के लिए, अगर डेवलपर मेटाडेटा पंक्ति 5 से जुड़ा है और दूसरी पंक्ति बाद में पंक्ति 5 के ऊपर डाली जाती है, तो वह मूल मेटाडेटा अब भी उस पंक्ति से जुड़ा रहेगा जिसके साथ वह पहले जुड़ा था (अब पंक्ति 6 है). अगर संबंधित ऑब्जेक्ट को मिटा दिया जाता है, तो इसका मेटाडेटा भी मिट जाता है.

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

सही है, जब मेटाडेटा पूरी स्प्रेडशीट से जुड़ा होता है.
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 से मेल खाने वाले सभी डेवलपर मेटाडेटा को दिखाता है.