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

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

  • باستخدام مرجع about، يمكنك retrieving information about the user, the user's Drive settings, and their system capabilities.

  • باستخدام مرجع apps، يمكنك retrieving a list of the user's installed apps، مع معلومات عن كل أنواع MIME المتوافقة مع التطبيق وامتدادات الملفات وتفاصيل أخرى.

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

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

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

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

إدراج تطبيقات المستخدم

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

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

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

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