عرض معلومات المستخدم

يوفّر Google Drive خيارَين لجمع معلومات عن مستخدمي Drive:

• باستخدام مورد about، يمكنك استرداد معلومات حول المستخدم وإعدادات Drive الخاصة به وإمكانات النظام.

• باستخدام مورد apps، يمكنك استرداد قائمة بالتطبيقات المثبَّتة على جهاز المستخدم، مع معلومات عن أنواع MIME المتوافقة مع كل تطبيق، وامتدادات الملفات، وتفاصيل أخرى.

يشرح هذا الدليل كيفية استرداد معلومات المستخدم في Drive.

الحصول على تفاصيل حول مستخدم

لعرض معلومات عن مستخدم Drive كنموذج من about، استخدِم طريقة get. يتم قياس القيم التي يتم إرجاعها بالبايت.

يجب ضبط fields مَعلمة النظام في طريقة get لتحديد الحقول المطلوب عرضها في الاستجابة. في معظم طرق Drive، لا يكون هذا الإجراء مطلوبًا إلا لعرض الحقول غير التلقائية، ولكنّه إلزامي لمورد about. إذا حذفت المَعلمة، ستعرض الطريقة رسالة خطأ. لمزيد من المعلومات، يُرجى الاطّلاع على عرض حقول معيّنة.

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"
  }
}

عرض قائمة بتطبيقات المستخدم

تظهر تطبيقات Google Drive في Google Workspace Marketplace، وتُستخدَم لتسهيل استخدام Drive، مثل تطبيق "مستندات Google" أو إضافة تُستخدَم في "مستندات Google" لتوقيع المستندات. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام تطبيقات 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"
  ]
}

عرض قائمة بتطبيقات المستخدمين مع مَعلمات طلب البحث

للعثور على تطبيق معيّن، استخدِم مَعلمة واحدة أو أكثر من مَعلمات طلب البحث الاختيارية:

• appFilterExtensions: لفلترة نتائج البحث باستخدام قائمة ملحقات ملفات مفصولة بفواصل يتم تضمين التطبيقات التي تندرج ضمن نطاق طلب البحث عن التطبيقات ويمكنها فتح امتدادات الملفات المدرَجة في الرد. في حال توفير appFilterMimeTypes أيضًا، سيتم عرض اتحاد قائمتَي التطبيقات الناتجتَين. وتشمل أمثلة الإضافات docx لبرنامج Microsoft Word وpptx لبرنامج Microsoft PowerPoint. للاطّلاع على المزيد من الأمثلة على امتدادات الملفات، يُرجى الرجوع إلى تصدير أنواع MIME لمستندات Google Workspace.

  يوضّح نموذج الرمز التالي كيفية تقديم عدة امتدادات ملفات كمعلَمة طلب بحث: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx.

• appFilterMimeTypes: لفلترة نتائج البحث باستخدام قائمة مفصولة بفواصل لأنواع MIME. يتم تضمين التطبيقات التي تقع ضمن نطاق طلب البحث عن التطبيقات ويمكنها فتح أنواع MIME المدرَجة في الرد. إذا تم توفير appFilterExtensions أيضًا، سيتم عرض اتحاد قائمتَي التطبيقات الناتجتَين. تشمل أمثلة أنواع MIME ما يلي: application/vnd.google-apps.form لـ "نماذج Google" وapplication/vnd.google-apps.site لـ "مواقع Google". للاطّلاع على المزيد من الأمثلة على أنواع MIME، يُرجى الانتقال إلى أنواع MIME المتوافقة في Google Workspace وGoogle Drive.

  يوضّح نموذج الرمز البرمجي التالي كيفية تقديم أنواع MIME متعددة كمعلَمة طلب بحث: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site.

• languageCode: لفلترة نتائج البحث باستخدام رمز لغة أو رمز إعدادات محلية، كما هو محدّد في BCP 47، مع بعض الإضافات من تنسيق LDML الخاص بـ Unicode تشمل أمثلة رموز اللغات en-us للغة الإنجليزية (الولايات المتحدة) وfr-ca للغة الفرنسية (كندا).

  تعرض عيّنة الرمز البرمجي التالية كيفية تقديم رموز لغات متعددة كمعلَمة طلب بحث: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

الحصول على تطبيق المستخدم حسب رقم التعريف

لتنزيل معلومات التطبيق التفصيلية كنسخة من apps، استخدِم طريقة get مع معرّف التطبيق.

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"
}

مواضيع ذات صلة

في ما يلي بعض الخطوات التالية التي يمكنك تجربتها:

• لإنشاء ملف في Drive، يُرجى الاطّلاع على إنشاء الملفات وإدارتها.

• لتحميل بيانات الملف عند إنشاء ملف أو تعديله، اطّلِع على تحميل بيانات الملف.

• لتنزيل الملفات وتصديرها، يُرجى الاطّلاع على تنزيل الملفات وتصديرها.