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

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

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

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

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

किसी उपयोगकर्ता की जानकारी फ़ेच करें

Drive पर मौजूद किसी उपयोगकर्ता की जानकारी को about के इंस्टेंस के तौर पर दिखाने के लिए, about.get तरीके का इस्तेमाल करें. about.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 के इंस्टेंस के तौर पर, उपयोगकर्ता के इंस्टॉल किए गए सभी ऐप्लिकेशन की सूची लौटाने के लिए, बिना किसी पैरामीटर के apps.list तरीके का इस्तेमाल करें.

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

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

अनुरोध करें

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 के मुताबिक, किसी भाषा या स्थान-भाषा के कोड का इस्तेमाल करके, खोज के नतीजों को फ़िल्टर करें. साथ ही, इसमें यूनिकोड के एलडीएमएल फ़ॉर्मैट के कुछ एक्सटेंशन इस्तेमाल करें. भाषा कोड के उदाहरणों में, अंग्रेज़ी (अमेरिका) के लिए en-us और फ़्रेंच (कनाडा) के लिए fr-ca शामिल हैं.

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

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

ऐप्लिकेशन की ज़्यादा जानकारी वाली जानकारी को apps के इंस्टेंस के तौर पर डाउनलोड करने के लिए, ऐप्लिकेशन आईडी के साथ 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: इस ऐप्लिकेशन का प्रॉडक्ट लिस्टिंग आईडी.

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