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

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

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

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

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

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

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

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

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