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