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

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

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

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

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

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

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

get() वाले तरीके के लिए, fields पैरामीटर की ज़रूरत होती है, ताकि जवाब में दिखाए जाने वाले फ़ील्ड की सूची बनाई जा सके. पैरामीटर को छोड़ने पर, यह तरीका गड़बड़ी का मैसेज दिखाता है. अपनी ज़रूरत के हिसाब से फ़ील्ड पाने के लिए, खास फ़ील्ड दिखाना लेख पढ़ें.

एक उदाहरण दिखाएं

नीचे दिए गए कोड सैंपल में, अनुरोध में क्वेरी पैरामीटर के तौर पर एक से ज़्यादा 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 पैरामीटर सेट किया जा सकता है. अपनी ज़रूरत के हिसाब से फ़ील्ड देखने के लिए, खास फ़ील्ड दिखाना लेख पढ़ें.

एक उदाहरण दिखाएं

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

अनुरोध

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 दस्तावेज़ों के लिए एमआईई टाइप एक्सपोर्ट करना लेख पढ़ें.

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

  • appFilterMimeTypes: कॉमा लगाकर अलग किए गए MIME टाइप की सूची का इस्तेमाल करके, खोज के नतीजों को फ़िल्टर करें. ऐप्लिकेशन क्वेरी के दायरे में आने वाले ऐसे ऐप्लिकेशन, जिनमें सूची में दिए गए MIME टाइप खोले जा सकते हैं उन्हें जवाब में शामिल किया जाता है. अगर appFilterExtensions भी दिए गए हैं, तो ऐप्लिकेशन की दोनों सूचियों को मिलाकर एक नई सूची बनाई जाती है. एमआईएम टाइप के उदाहरणों में, 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: खोज के नतीजों को भाषा या स्थानीय भाषा के कोड का इस्तेमाल करके फ़िल्टर करें. इसके लिए, यूनिकोड के LDML फ़ॉर्मैट के कुछ एक्सटेंशन का इस्तेमाल करें. ये कोड, बीसीपी 47 के मुताबिक तय किए गए हैं. भाषा कोड के उदाहरणों में, अंग्रेज़ी (अमेरिका) के लिए 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: इस ऐप्लिकेशन के लिए प्रॉडक्ट लिस्टिंग आईडी.

यहां कुछ और तरीके दिए गए हैं, जिन्हें आज़माया जा सकता है: