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 से मेल खाने वाले सभी डेवलपर मेटाडेटा को दिखाता है.