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

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

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

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

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

डिस्क एपीआई v3

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

डिस्क एपीआई 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 निजी प्रॉपर्टी जोड़ी जा सकती हैं.
  • UTF-8 एन्कोडिंग में हर प्रॉपर्टी स्ट्रिंग (कुंजी और वैल्यू, दोनों शामिल हैं) के लिए ज़्यादा से ज़्यादा 124 बाइट. उदाहरण के लिए, 10 वर्णों वाली कुंजी वाली प्रॉपर्टी की वैल्यू में सिर्फ़ 114 वर्ण हो सकते हैं. इसी तरह, जिस प्रॉपर्टी में वैल्यू के लिए 100 वर्णों की ज़रूरत होती है वह कुंजी के लिए, ज़्यादा से ज़्यादा 24 वर्णों का इस्तेमाल कर सकती है.

ज़्यादा जानकारी के लिए, files संसाधन देखें. Drive API v2 के लिए, properties संसाधन देखें.

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

appProperties फ़ील्ड का इस्तेमाल करके, निजी प्रॉपर्टी सिर्फ़ तब वापस पाई जा सकती हैं, जब पुष्टि किए गए अनुरोध में, OAuth 2.0 क्लाइंट आईडी से मिले ऐक्सेस टोकन का इस्तेमाल किया जाता है. निजी प्रॉपर्टी को वापस पाने के लिए, एपीआई पासकोड का इस्तेमाल नहीं किया जा सकता.