توفّر واجهة برمجة التطبيقات Picker API طريقة آمنة تمكّن المستخدمين من اختيار الصور والفيديوهات من مكتبة "صور Google" ومشاركتها في تطبيقك.
قبل البدء
- الاطّلاع على النظرة العامة: مقارنة Picker API وLibrary API للتأكّد من أنّ Picker API هي الواجهة المناسبة لحالة الاستخدام
- ضبط إعدادات تطبيقك: فعِّل واجهة برمجة التطبيقات واضبط المصادقة. اطّلِع على ضبط تطبيقك للاطّلاع على الخطوات المفصّلة.
مسار Picker API
في ما يلي نظرة عامة حول آلية عمل واجهة برمجة تطبيقات "المنتقي":
التحقّق من رمز OAuth المميز: قبل بدء مسار واجهة برمجة التطبيقات للمنتقي، ابحث عن رمز دخول OAuth 2.0 صالح للمستخدم. إذا لم يكن هناك رمز مميّز، عليك بدء مسار تفويض OAuth 2.0 للحصول على رمز.
إنشاء جلسة: ابدأ العملية من خلال إجراء طلب إلى Picker API من أجل إنشاء جلسة جديدة. ستؤدي هذه المكالمة إلى عرض
pickerUri
فريد.توجيه المستخدمين إلى تطبيق "صور Google": يمكنك تقديم
pickerUri
لمستخدميك (إما كرابط يمكن النقر عليه أو رمز استجابة سريعة). سيفتح عنوان URL هذا تطبيق "صور Google" بشكل آمن.اختيار المستخدم لعناصر الوسائط: ضمن تطبيق "صور Google"، يمكن للمستخدمين تصفّح مكتبتهم واختيار الصور والفيديوهات التي يريدون مشاركتها مع تطبيقك. يمكنك الاطّلاع على نظرة عامة حول تجربة اختيار المستخدم.
الاستعلام عن الجلسة: يجب أن يُجري تطبيقك استطلاعات دورية للجلسة للتحقّق من الحالة. أنت تبحث عن السمة
mediaItemsSet
لعرض القيمة "صحيح"، ما يشير إلى أنّ المستخدم قد أكمل اختياره.عرض عناصر الوسائط المحدّدة: بعد أن يعرض
mediaItemsSet
القيمة "صحيح"، يمكنك استخدام طريقة القائمة للحصول على تفاصيل عن عناصر الوسائط المحدّدة.استرداد عناصر الوسائط واستخدامها: يمكنك الآن الوصول إلى عناصر الوسائط المختارة. يمكنك جلب المحتوى باستخدام رمز العلامة
baseUrl
واستخدامه في تطبيقك.
الخطوات التالية
- مراجعة المستندات المرجعية: يمكنك الاطّلاع على المستندات المرجعية التفصيلية لواجهة برمجة تطبيقات أداة الاختيار لمعرفة المزيد حول جميع الطرق والمَعلمات المتاحة.
- تجربة النماذج: يمكنك الاطّلاع على النموذج لمعرفة كيفية استخدام Picker API والحصول على أفكار لدمج هذه الواجهة.