कस्टम फ़ाइल प्रॉपर्टी एक की-वैल्यू पेयर होती हैं, जिनका इस्तेमाल Google Drive की फ़ाइल (जैसे कि टैग), अन्य डेटा स्टोर के आईडी, और जानकारी ऐप्लिकेशन के बीच शेयर किया जा सकता है. उदाहरण के लिए, आप फ़ाइल जोड़ सकते हैं सभी दस्तावेज़ों में प्रॉपर्टी सबमिट कर दी जाएगी.
सभी ऐप्लिकेशन को दिखाई देने वाली प्रॉपर्टी जोड़ने के लिए, properties
files
संसाधन. प्रॉपर्टी जोड़ने के लिए
अपने ऐप्लिकेशन के लिए सीमित, files
संसाधन के appProperties
फ़ील्ड का इस्तेमाल करें.
प्रॉपर्टी का इस्तेमाल खोज नतीजों में भी किया जा सकता है एक्सप्रेशन के बारे में ज़्यादा जानें.
यह किसी ऐसी सामान्य प्रॉपर्टी का स्ट्रक्चर है, जिसका इस्तेमाल Drive की फ़ाइल का डेटाबेस आईडी.
डिस्क API v3
"appProperties": {
"additionalID": "ID",
}
डिस्क API v2
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
कस्टम फ़ाइल प्रॉपर्टी के साथ काम करना
इस सेक्शन में, कस्टम फ़ाइल प्रॉपर्टी से जुड़े ऐसे काम करने के तरीके बताए गए हैं जो इसका असर सभी ऐप्लिकेशन पर पड़ता है.
कस्टम फ़ाइल प्रॉपर्टी जोड़ना या अपडेट करना
सभी ऐप्लिकेशन को दिखने वाली प्रॉपर्टी को जोड़ने या अपडेट करने के लिए,
files.update
तरीका सेट करने के लिए
files
का properties
फ़ील्ड
संसाधन.
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
{ "properties": { "name": "wrench", "mass": "1.3kg", "count": "3" } }
आप चाहें, तो Google Apps Script में Drive सेवा. ज़्यादा जानकारी के लिए, यह देखें कस्टम यूआरएल जोड़ा जा रहा है प्रॉपर्टी के लिए.
कस्टम फ़ाइल प्रॉपर्टी पाना या उनकी सूची बनाना
सभी ऐप्लिकेशन को दिखने वाली प्रॉपर्टी देखने के लिए,
पाने का files.get
तरीका
.
GET https://www.googleapis.com/drive/v3/files/FILE_ID
?fields=properties
रिस्पॉन्स में एक properties
ऑब्जेक्ट शामिल होता है, जिसमें
की-वैल्यू पेयर.
{ "properties": { "name": "wrench", "mass": "1.3kg", "count": "3" } }
कस्टम फ़ाइल प्रॉपर्टी मिटाएं
सभी ऐप्लिकेशन को दिखने वाली प्रॉपर्टी की वैल्यू मिटाने के लिए,
files.update
तरीका सेट करने के लिए
files
का properties
फ़ील्ड
संसाधन को शून्य पर सेट करना.
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
{ "name": null }
परिवर्तन देखने के लिए,
पाने का files.get
तरीका
फ़ाइल के लिए properties
ऑब्जेक्ट.
{ "properties": { "mass": "1.3kg", "count": "3" } }
कस्टम फ़ाइल प्रॉपर्टी की सीमाएं
कस्टम प्रॉपर्टी की सीमाएं नीचे दी गई हैं:
- हर फ़ाइल में ज़्यादा से ज़्यादा 100 कस्टम प्रॉपर्टी, सभी सोर्स से जोड़ी जा सकती हैं.
- हर फ़ाइल में ज़्यादा से ज़्यादा 30 सार्वजनिक प्रॉपर्टी होनी चाहिए. इन्हें सभी सोर्स से शामिल किया जाता है.
- किसी भी एक ऐप्लिकेशन की हर फ़ाइल में ज़्यादा से ज़्यादा 30 निजी प्रॉपर्टी होनी चाहिए.
- हर प्रॉपर्टी स्ट्रिंग (इसमें कुंजी और वैल्यू, दोनों शामिल हैं) के लिए ज़्यादा से ज़्यादा 124 बाइट UTF-8 एन्कोडिंग. उदाहरण के लिए, 10 वर्णों वाली कुंजी वाली प्रॉपर्टी इसकी वैल्यू में सिर्फ़ 114 वर्ण हो सकते हैं. इसी तरह, एक प्रॉपर्टी वैल्यू के लिए 100 वर्ण होने चाहिए. इस तरह के वर्णों के लिए, 24 वर्णों का इस्तेमाल किया जा सकता है बटन दबाएं.
ज़्यादा जानकारी के लिए, files
देखें
संसाधन. Drive API v2 के लिए, यहां जाएं
properties
संसाधन.
निजी कस्टम फ़ाइल प्रॉपर्टी ऐक्सेस करें
निजी प्रॉपर्टी को सिर्फ़ appProperties
फ़ील्ड का इस्तेमाल करके वापस लाया जा सकता है
ऐसा अनुरोध जिसकी पुष्टि हो चुकी है और जो OAuth 2.0 से मिले ऐक्सेस टोकन का इस्तेमाल करता है
Client-ID. निजी प्रॉपर्टी वापस पाने के लिए, एपीआई पासकोड का इस्तेमाल नहीं किया जा सकता.