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

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

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

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