بدء استخدام Picker API

توفّر Picker API طريقة آمنة للمستخدمين لاختيار الصور والفيديوهات من مكتبة "صور Google" ومشاركتها مع تطبيقك.

قبل البدء

• الاطّلاع على النظرة العامة: مقارنة Picker API وLibrary API للتأكّد من أنّ Picker API هي الخيار المناسب لحالة الاستخدام.
• ضبط تطبيقك: فعِّل واجهة برمجة التطبيقات وأعِدّ المصادقة. راجِع مقالة ضبط تطبيقك للحصول على خطوات تفصيلية.

مسار عمل Picker API

في ما يلي نظرة عامة على طريقة عمل Picker API:

1. التحقّق من الرمز المميز لبروتوكول OAuth: قبل بدء عملية Picker API، تحقَّق من توفّر رمز دخول صالح لبروتوكول OAuth 2.0 للمستخدم. إذا لم يكن هناك رمز مميز، عليك بدء عملية تفويض OAuth 2.0 للحصول على رمز مميز.

2. إنشاء جلسة: ابدأ العملية من خلال إجراء طلب إلى واجهة برمجة التطبيقات Picker لـ إنشاء جلسة جديدة. ستعرض هذه الدالة pickerUri فريدًا.

3. توجيه المستخدمين إلى تطبيق "صور Google": قدِّم pickerUri للمستخدمين (إما كرابط قابل للنقر أو رمز استجابة سريعة). سيفتح عنوان URL هذا تطبيق "صور Google" بشكل آمن. بالنسبة إلى التطبيقات المستندة إلى الويب، يمكنك إضافة /autoclose إلى معرّف الموارد المنتظم (URI) هذا لإغلاق نافذة "صور Google" تلقائيًا بعد أن يكمل المستخدم عملية الاختيار.

4. يختار المستخدم عناصر الوسائط: يمكن للمستخدمين تصفّح مكتبتهم داخل تطبيق "صور Google" واختيار الصور والفيديوهات التي يريدون مشاركتها مع تطبيقك. يمكنك الاطّلاع على نظرة عامة حول تجربة اختيار المستخدم.

5. التحقّق من حالة الجلسة: يجب أن يتحقّق تطبيقك من حالة الجلسة بشكل دوري. أنت تبحث عن الخاصية mediaItemsSet لإرجاع القيمة "صحيح"، ما يشير إلى أنّ المستخدم قد انتهى من عملية الاختيار.

   ملاحظة: في كل مرة تجري فيها عملية الاقتراع لجلسة، يتضمّن الرد الفواصل الزمنية والمهلات المقترَحة لضبط عملية الاقتراع.

6. إدراج عناصر الوسائط المحدّدة: بعد أن تعرض mediaItemsSet القيمة "صحيح"، يمكنك استخدام طريقة الإدراج للحصول على تفاصيل حول عناصر الوسائط المحدّدة.

7. استرداد عناصر الوسائط واستخدامها: يمكنك الآن الوصول إلى عناصر الوسائط المحدّدة. يمكنك استرداد محتواها باستخدام baseUrl واستخدامها في تطبيقك.

الخطوات التالية

• مراجعة المستندات المرجعية: يمكنك الاطّلاع على مستندات Picker API المرجعية المفصّلة للتعرّف على جميع الطرق والمعلَمات المتاحة.
• تجربة النماذج: اطّلِع على النموذج لمعرفة طريقة عمل Picker API والحصول على أفكار لعملية الدمج.