Learn about the new Picker API and important Library API changes.
Details here.
بدء استخدام Picker API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توفّر واجهة برمجة التطبيقات 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
واستخدامه في تطبيقك.
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Picker API lets users securely select photos and videos from their Google Photos library and share them with your application."],["Before using the Picker API, ensure it's the right fit for your use case and properly configure your app with the necessary API and authentication setup."],["The Picker API flow involves creating a session, directing users to the Google Photos app for selection, polling the session for completion, and then retrieving the selected media items."],["Developers should check the provided resources like reference documentation and samples for detailed information and implementation examples."]]],["The Picker API enables users to share media from Google Photos with your app. First, check for and obtain an OAuth token. Then, create a new session via the Picker API, generating a `pickerUri`. Direct users to this URI to select media. Periodically poll the session until `mediaItemsSet` is true. Use the list method to retrieve details of selected items, and then access their content using `baseUrl` for use in your application.\n"]]