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

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

قبل البدء

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

مسار Picker API

في ما يلي نظرة عامة حول آلية عمل واجهة برمجة تطبيقات "المنتقي":

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

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

  3. توجيه المستخدمين إلى تطبيق "صور Google": يمكنك تقديم pickerUri لمستخدميك (إما كرابط يمكن النقر عليه أو رمز استجابة سريعة). سيفتح عنوان URL هذا تطبيق "صور Google" بشكل آمن.

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

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

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

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

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