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

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

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

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

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

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

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

रिस्पॉन्स में दिखाए जाने वाले फ़ील्ड तय करने के लिए, आपको get तरीके पर fields सिस्टम पैरामीटर सेट करना ज़रूरी है. 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 दस्तावेज़ों के लिए एमआईई टाइप एक्सपोर्ट करना लेख पढ़ें.

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

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

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