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