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

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

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

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

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

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

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

يجب ضبط fields المَعلمة system في طريقة get لتحديد الحقول التي سيتم عرضها في الاستجابة. في معظم طرق 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: عنوان URL لصورة الملف الشخصي للمستخدم
  • ‫PERMISSION_ID: معرّف المستخدم ضمن موارد Permission
  • EMAIL_ADDRESS: عنوان البريد الإلكتروني للمستخدم

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

تظهر تطبيقات Google Drive في Google Workspace Marketplace، ويتم استخدامها لتسهيل استخدام Drive، مثل تطبيق "مستندات Google" أو إضافة مستخدَمة في "مستندات Google" لتوقيع المستندات. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام تطبيقات Google Drive.

لعرض قائمة بجميع التطبيقات المثبَّتة لدى المستخدم كنموذج من apps، استخدِم طريقة list بدون أي مَعلمات.

إذا أردت تحديد الحقول التي سيتم عرضها في الرد، يمكنك ضبط المَعلمة fields system. في حال عدم تحديد المَعلمة 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 أيضًا، سيتم عرض اتحاد قائمتَي التطبيقات الناتجتَين. وتشمل الأمثلة على الإضافات 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 مع معرّف التطبيق.

يوضّح نموذج الرمز البرمجي التالي كيفية تقديم 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: معرّف بطاقة بيانات المتجر لهذا التطبيق

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