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

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

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

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

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

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

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

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

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

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

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

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

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