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

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

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

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

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

استرجاع معلومات عن مستخدم

لعرض معلومات عن مستخدم Drive كمثيل لـ about، استخدِم طريقة about.get. تتطلّب الطريقة about.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" لتوقيع المستندات. لمزيد من المعلومات، راجِع استخدام تطبيقات Google Drive.

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

عرض مثال

يعرض نموذج الرمز البرمجي التالي كيفية عرض قائمة بجميع تطبيقات المستخدم المثبَّتة في الطلب. تعرض الاستجابة قيم الحقول الخاصة بالطلب.

طلب

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، استخدِم الطريقة 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: معرّف بيانات المنتج لهذا التطبيق

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