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

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

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

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

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

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

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

يجب ضبط مَعلمة system في fields على طريقة get لتحديد الحقول التي سيتم عرضها في الاستجابة. في معظم methods (طرق) 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" ل signing documents. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام التطبيقات في 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.

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

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