कस्टम फ़ाइल प्रॉपर्टी जोड़ें

कस्टम फ़ाइल प्रॉपर्टी एक की-वैल्यू पेयर होती हैं, जिनका इस्तेमाल Google Drive की फ़ाइल (जैसे कि टैग), अन्य डेटा स्टोर के आईडी, और जानकारी ऐप्लिकेशन के बीच शेयर किया जा सकता है. उदाहरण के लिए, आप फ़ाइल जोड़ सकते हैं सभी दस्तावेज़ों में प्रॉपर्टी सबमिट कर दी जाएगी.

सभी ऐप्लिकेशन को दिखाई देने वाली प्रॉपर्टी जोड़ने के लिए, properties files संसाधन. प्रॉपर्टी जोड़ने के लिए अपने ऐप्लिकेशन के लिए सीमित, files संसाधन के appProperties फ़ील्ड का इस्तेमाल करें.

ध्यान दें: अगर Google Drive API (v2) का पुराना वर्शन इस्तेमाल किया जा रहा है, तो जोड़ने के लिए properties संसाधन प्रॉपर्टी का इस्तेमाल करके properties.insert. देखने के लिए, Drive API v2 और v3 तुलना के बारे में जानकारी.

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

यह किसी ऐसी सामान्य प्रॉपर्टी का स्ट्रक्चर है, जिसका इस्तेमाल Drive की फ़ाइल का डेटाबेस आईडी.

डिस्क API v3

"appProperties": {
  "additionalID": "ID",
}

डिस्क API v2

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

कस्टम फ़ाइल प्रॉपर्टी के साथ काम करना

इस सेक्शन में, कस्टम फ़ाइल प्रॉपर्टी से जुड़े ऐसे काम करने के तरीके बताए गए हैं जो इसका असर सभी ऐप्लिकेशन पर पड़ता है.

ध्यान दें: Google Drive के यूज़र इंटरफ़ेस (यूआई) में, बदलाव करने का विकल्प पहले से मौजूद नहीं है कस्टम प्रॉपर्टी.

कस्टम फ़ाइल प्रॉपर्टी जोड़ना या अपडेट करना

सभी ऐप्लिकेशन को दिखने वाली प्रॉपर्टी को जोड़ने या अपडेट करने के लिए, 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. निजी प्रॉपर्टी वापस पाने के लिए, एपीआई पासकोड का इस्तेमाल नहीं किया जा सकता.