نظرة عامة على Google Picker

يعرّف هذا المستند أداة اختيار الملفات من Google وGoogle Picker API. ويساعدك أيضًا في تحديد النهج الأفضل لتطبيقك.

توفّر أداة اختيار الملفات من Google مربّع حوار أنيقًا "لفتح الملفات" للمعلومات المخزّنة في Google Drive. وهي طريقة تتيح للمستخدمين اختيار الصور والفيديوهات والمستندات أو تحميلها من حساباتهم على Drive بدون مغادرة تطبيقك.

Google Picker API هي الواجهة الفنية المستخدَمة لتنفيذ أداة اختيار الملفات من Google في تطبيقك. من خلال استخدام Google Picker API، يمكنك إنشاء واجهة مألوفة تتعامل مع تعقيدات المصادقة وتصفّح الملفات، وتعرض بيانات وصفية محدّدة للملفات (مثل المعرّفات وعناوين URL) مرة أخرى إلى تطبيقك بعد أن يختار المستخدم ملفًا.

أبرز حالات الاستخدام

تتسم أداة اختيار الملفات من Google بالمرونة ويمكن تخصيصها لتناسب مختلف مهام سير العمل في التطبيقات:

  • بديل لتحميل الملفات: يمكن للمستخدمين تحميل ملف إلى Drive مباشرةً من خلال أداة اختيار الملفات من Google.
  • أدوات التعاون: يمكنك السماح للمستخدمين بربط مستندات Google أو "جداول بيانات Google" محدّدة بمهمة إدارة مشروع أو حدث تقويم مشترك.
  • إرفاق مواد العرض: يمكنك استخدام أداة اختيار الملفات من Google كطريقة تتيح للمستخدمين إرفاق مستندات داعمة من Drive بتقرير نفقات أو تذكرة دعم.

مقارنة بين تطبيقات الويب والتطبيقات المتوافقة مع أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة

على الرغم من أنّ الوظائف الأساسية تظل متسقة، يختلف تنفيذ Google Picker API حسب مكان تشغيل تطبيقك. يعرض جدول المقارنة التالي الاختلافات الفنية والوظيفية عند تنفيذها لتطبيقات الويب مقابل التطبيقات المتوافقة مع أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة.

الميزة تطبيقات الويب التطبيقات المتوافقة مع أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة
التكنولوجيا الأساسية مكتبة JavaScript من جهة العميل معلّمات عناوين URL لبروتوكول OAuth 2.0 وعمليات إعادة التوجيه باستخدام بروتوكول HTTP
العرض يتم دمجها في تنسيق واجهة المستخدم الحالية للتطبيق. يتم فتحها في علامة تبويب جديدة في متصفّح النظام التلقائي للمستخدم. لا يمكن عرضها بعد الآن في عرض ويب مضمّن.
سير عمل المصادقة يتطلّب رمز دخول محدّدًا يتم تمريره من خلال setOAuthToken. يتم تشغيله من خلال إضافة trigger_onepick=true إلى طلب OAuth.
طريقة الردّ طلبات معاودة الاتصال المباشرة في JavaScript معرّفات الموارد المنتظمة لإعادة التوجيه أو مخطّطات عناوين URL المخصّصة
المستويات مرنة، يمكن استخدام drive.file وdrive.readonly وما إلى ذلك صارمة، يُسمح فقط باستخدام drive.file ولا يمكن الجمع بينها وبين مستويات أخرى.
التهيئة تستخدم واجهة PickerBuilder السلسة في JavaScript. تستخدم معلّمات سلسلة طلب البحث في عنوان URL الخاص بالتفويض.

يُرجى العِلم أنّه لاستخدام نطاق drive.file، يجب أن يكون المستخدم مسجّلاً الدخول عند الوصول إلى أداة اختيار الملفات من Google.

في ما يلي الاختلافات الاستراتيجية الرئيسية:

  • تم تصميم تطبيقات الويب لتوفير تفاعلية عالية وتخصيصًا دقيقًا (مثل طرق عرض محدّدة حسب نوع الملف وتقييد طريقة العرض على مجلدات معيّنة في Drive).
  • تم تصميم التطبيقات المتوافقة مع أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة لتعزيز الأمان والبساطة، باستخدام متصفّح النظام للتعامل مع المصادقة واختيار الملفات في سير عمل واحد وموحّد.