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

تتيح لك Library API التفاعل مع الصور والفيديوهات والألبومات ضمن مكتبات "صور Google" الخاصة بالمستخدمين، ولكن مع التركيز على نقطة مهمة: لا يمكنك الوصول إلا إلى وإدارة المحتوى الذي أنشأه تطبيقك.

قبل البدء

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

حالات الاستخدام الرئيسية لواجهة برمجة التطبيقات Library API

إنّ Library API مثالية للسيناريوهات التي يحتاج فيها تطبيقك إلى:

  • تحميل الوسائط وتخزينها: يمكنك استيراد الصور والفيديوهات (التي أنشأها تطبيقك) بأمان إلى مكتبات "صور Google" الخاصة بالمستخدمين.
  • تنظيم المحتوى: يمكنك إنشاء ألبومات وإدارتها لمساعدة المستخدمين في تنظيم الوسائط المرتبطة بالتطبيق.
  • تحسين الصور والألبومات: يمكنك إضافة سياق إلى عناصر الوسائط والألبومات من خلال الإجراءات الإضافية، مثل العناوين أو الأوصاف أو معلومات الموقع الجغرافي.
  • الوصول إلى البيانات التي أنشأها التطبيق: يمكنك استرداد الصور والفيديوهات والألبومات التي أنشأها تطبيقك في السابق والتفاعل معها.

سير العمل المعتاد لواجهة برمجة التطبيقات Library API

على الرغم من أنّ واجهة برمجة التطبيقات Library API توفّر وظائف مختلفة، قد يشمل سير العمل المعتاد الخطوات التالية:

  1. تحميل الوسائط: استخدِم نقطة نهاية عمليات التحميل لتحميل وحدات البايت الخاصة بالصور أو الفيديوهات بأمان إلى "صور Google". تؤدي هذه الخطوة إلى إنشاء uploadToken.

  2. إنشاء عناصر وسائط: استخدِم mediaItems.batchCreate الطريقة، مع تقديم uploadToken، لإنشاء عناصر وسائط في مكتبة المستخدم.

  3. إنشاء ألبومات (اختياري): استخدِم طريقة albums.create لإنشاء ألبومات ضمن مكتبة المستخدم من أجل تنظيم عناصر الوسائط.

  4. إدارة الألبومات:

    • أضِف عناصر وسائط (أنشأها تطبيقك) إلى الألبومات باستخدام albums.batchAddMediaItems.
    • أزِل عناصر الوسائط من الألبومات باستخدام رمز albums.batchRemoveMediaItems.
    • أضِف معلومات إضافية إلى الألبومات (مثل العناوين أو المواقع الجغرافية) باستخدام albums.addEnrichment.
    • استرداد معلومات حول ألبومات محددة باستخدام albums.get
    • أدرِج الألبومات التي أنشأها تطبيقك باستخدام albums.list.

  5. الوصول إلى الوسائط التي أنشأها التطبيق:

    • يمكنك استرداد تفاصيل حول وسائط معيّنة باستخدام mediaItems.get أو mediaItems.batchGet.
    • ابحث عن عناصر الوسائط التي أنشأها تطبيقك باستخدام mediaItems.search.
    • يمكنك إدراج عناصر الوسائط ضمن ألبوم محدّد أنشأه التطبيق باستخدام ‎ mediaItems.search مع معرّف الألبوم.

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