वापस लौटने वाले उपयोगकर्ता की जानकारी

Google Drive, Drive के उपयोगकर्ताओं के बारे में जानकारी इकट्ठा करने के लिए दो विकल्प देता है:

  • about संसाधन का इस्तेमाल करके, उपयोगकर्ता, उसकी Drive की सेटिंग, और उसके सिस्टम की क्षमताओं के बारे में जानकारी हासिल की जा सकती है.

  • apps संसाधन का इस्तेमाल करके, उपयोगकर्ता के इंस्टॉल किए गए ऐप्लिकेशन की सूची हासिल की जा सकती है. साथ ही, हर ऐप्लिकेशन के साथ काम करने वाले MIME टाइप, फ़ाइल एक्सटेंशन, और अन्य जानकारी भी हासिल की जा सकती है.

इस गाइड में, Drive में उपयोगकर्ता की जानकारी हासिल करने का तरीका बताया गया है.

किसी उपयोगकर्ता के बारे में जानकारी पाना

` about` के इंस्टेंस के तौर पर, Drive के किसी उपयोगकर्ता के बारे में जानकारी पाने के लिए, ` get` तरीके का इस्तेमाल करें. लौटाई गई वैल्यू, बाइट में मेज़र की जाती हैं.

रिस्पॉन्स में लौटाए जाने वाले फ़ील्ड तय करने के लिए, आपको ज़रूरी है कि आप fields सिस्टम पैरामीटर को तरीके get पर सेट करें. Drive के ज़्यादातर तरीकों में, यह कार्रवाई सिर्फ़ डिफ़ॉल्ट फ़ील्ड के अलावा अन्य फ़ील्ड लौटाने के लिए ज़रूरी होती है. हालांकि, about संसाधन के लिए यह ज़रूरी है. अगर आपने पैरामीटर शामिल नहीं किया, तो यह तरीका गड़बड़ी का मैसेज दिखाता है. ज़्यादा जानकारी के लिए, खास फ़ील्ड लौटाना लेख पढ़ें.

नीचे दिए गए कोड सैंपल में, अनुरोध में क्वेरी पैरामीटर के तौर पर कई fields देने का तरीका बताया गया है. रिस्पॉन्स में, अनुरोध के लिए फ़ील्ड की वैल्यू मिलती हैं.

अनुरोध

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

रिस्पॉन्स

{
  "kind": "drive#about",
  "user": {
    "kind": "drive#user",
    "displayName": "DISPLAY_NAME",
    "photoLink": "PHOTO_LINK",
    "me": true,
    "permissionId": "PERMISSION_ID",
    "emailAddress": "EMAIL_ADDRESS"
  },
  "storageQuota": {
    "usage": "10845031958",
    "usageInDrive": "2222008387",
    "usageInDriveTrash": "91566"
  }
}

रिस्पॉन्स में ये वैल्यू शामिल होती हैं:

  • DISPLAY_NAME: उपयोगकर्ता का नाम, सादे टेक्स्ट में.
  • PHOTO_LINK: उपयोगकर्ता की प्रोफ़ाइल फ़ोटो का यूआरएल.
  • PERMISSION_ID: Permission संसाधनों में उपयोगकर्ता का आईडी.
  • EMAIL_ADDRESS: उपयोगकर्ता का ईमेल पता

उपयोगकर्ता के ऐप्लिकेशन की सूची पाना

Google Drive के ऐप्लिकेशन, Google Workspace Marketplace में दिखते हैं और इनका इस्तेमाल, Drive को ज़्यादा सुविधाजनक बनाने के लिए किया जाता है. जैसे, Google Docs ऐप्लिकेशन या Docs में दस्तावेज़ों पर हस्ताक्षर करने के लिए इस्तेमाल किया जाने वाला ऐड-ऑन. ज़्यादा जानकारी के लिए, Google Drive के ऐप्लिकेशन इस्तेमाल करना लेख पढ़ें.

उपयोगकर्ता के इंस्टॉल किए गए सभी ऐप्लिकेशन की सूची, apps के इंस्टेंस के तौर पर पाने के लिए, बिना किसी पैरामीटर के list तरीके का इस्तेमाल करें.

अगर आपको रिस्पॉन्स में लौटाए जाने वाले फ़ील्ड तय करने हैं, तो fields सिस्टम पैरामीटर सेट किया जा सकता है. अगर आपने fields पैरामीटर तय नहीं किया है, तो सर्वर, फ़ील्ड का डिफ़ॉल्ट सेट लौटाता है. ज़्यादा जानकारी के लिए, खास फ़ील्ड लौटाना लेख पढ़ें.

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

अनुरोध

GET https://www.googleapis.com/drive/v3/apps

रिस्पॉन्स

{
  "kind": "drive#appList",
  "selfLink": "https://www.googleapis.com/drive/v3/apps",
  "items": [
    {
      "kind": "drive#app",
      "id": "ID",
      "name": "Google Sheets",
      "supportsCreate": true,
      "supportsImport": true,
      "supportsMultiOpen": false,
      "supportsOfflineCreate": true,
      "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
      "productId": "PRODUCT_ID"
    }
  ],
  "defaultAppIds": [
    "ID"
  ]
}

रिस्पॉन्स में ये वैल्यू शामिल होती हैं:

  • ID: ऐप्लिकेशन आईडी.
  • PRODUCT_ID: इस ऐप्लिकेशन के लिए, प्रॉडक्ट लिस्टिंग आईडी.

क्वेरी पैरामीटर के साथ, उपयोगकर्ता के ऐप्लिकेशन की सूची पाना

कोई खास ऐप्लिकेशन ढूंढने के लिए, क्वेरी के एक या उससे ज़्यादा वैकल्पिक पैरामीटर का इस्तेमाल करें:

  • appFilterExtensions: फ़ाइल एक्सटेंशन की कॉमा से अलग की गई सूची का इस्तेमाल करके, खोज के नतीजों को फ़िल्टर करें. ऐप्लिकेशन क्वेरी स्कोप में मौजूद वे ऐप्लिकेशन, जो सूची में शामिल फ़ाइल एक्सटेंशन को खोल सकते हैं, रिस्पॉन्स में शामिल किए जाते हैं. अगर appFilterMimeTypes भी दिए जाते हैं, तो ऐप्लिकेशन की दो सूचियों का यूनियन लौटाया जाता है. एक्सटेंशन के उदाहरणों में, Microsoft Word के लिए docx और Microsoft PowerPoint के लिए pptx शामिल हैं. फ़ाइल एक्सटेंशन के ज़्यादा उदाहरणों के लिए, Google Workspace के दस्तावेज़ों के लिए MIME टाइप एक्सपोर्ट करना लेख पढ़ें.

    नीचे दिए गए कोड सैंपल में, क्वेरी पैरामीटर के तौर पर कई फ़ाइल एक्सटेंशन देने का तरीका बताया गया है: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx.

  • appFilterMimeTypes: MIME टाइप की कॉमा लगाकर अलग की गई लिस्ट का इस्तेमाल करके, खोज के नतीजों को फ़िल्टर करें. ऐप्लिकेशन क्वेरी स्कोप में मौजूद वे ऐप्लिकेशन, जो सूची में शामिल MIME टाइप को खोल सकते हैं, रिस्पॉन्स में शामिल किए जाते हैं. अगर appFilterExtensions भी दिए जाते हैं, तो ऐप्लिकेशन की दो सूचियों का यूनियन लौटाया जाता है. MIME टाइप के उदाहरणों में, Google Forms के लिए application/vnd.google-apps.form और Google Sites के लिए application/vnd.google-apps.site शामिल हैं. MIME टाइप के ज़्यादा उदाहरणों के लिए, Google Workspace और Google Drive के साथ काम करने वाले MIME टाइप लेख पढ़ें.

    नीचे दिए गए कोड सैंपल में, क्वेरी पैरामीटर के तौर पर कई MIME टाइप देने का तरीका बताया गया है: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site.

  • languageCode: खोज के नतीजों को किसी भाषा या इलाके के कोड का इस्तेमाल करके फ़िल्टर करें, जैसा कि BCP 47 के तहत तय किया गया है. इसमें, Unicode's LDML फ़ॉर्मैट से कुछ एक्सटेंशन भी शामिल हैं. भाषा कोड के उदाहरणों में, अंग्रेज़ी (अमेरिका) के लिए en-us और फ़्रेंच (कनाडा) के लिए fr-ca शामिल हैं.

    नीचे दिए गए कोड सैंपल में, क्वेरी पैरामीटर के तौर पर कई भाषा कोड देने का तरीका बताया गया है: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

आईडी के हिसाब से, उपयोगकर्ता का ऐप्लिकेशन पाना

ऐप्लिकेशन की पूरी जानकारी, appsके इंस्टेंस के तौर पर डाउनलोड करने के लिए, ऐप्लिकेशन आईडी के साथ get तरीके का इस्तेमाल करें.

नीचे दिए गए कोड सैंपल में, अनुरोध में क्वेरी पैरामीटर के तौर पर appId देने का तरीका बताया गया है. रिस्पॉन्स में, अनुरोध के लिए फ़ील्ड की वैल्यू मिलती हैं.

अनुरोध

GET https://www.googleapis.com/drive/v3/apps/APP_ID

रिस्पॉन्स

{
  "kind": "drive#app",
  "id": "ID",
  "name": "Google Sheets",
  "supportsCreate": true,
  "supportsImport": true,
  "supportsMultiOpen": false,
  "supportsOfflineCreate": true,
  "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
  "productId": "PRODUCT_ID"
}

रिस्पॉन्स में ये वैल्यू शामिल होती हैं:

  • ID: ऐप्लिकेशन आईडी.
  • PRODUCT_ID: इस ऐप्लिकेशन के लिए, प्रॉडक्ट लिस्टिंग आईडी.

यहां कुछ अगले चरण दिए गए हैं जिन्हें आज़माया जा सकता है: