Photos Library API

إدارة الصور والفيديوهات والألبومات في "صور Google"

الخدمة: photoslibrary.googleapis.com

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تحتوي خدمة واحدة على عدة نقاط نهاية للخدمة. تشتمل هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط جميع معرّفات الموارد المنتظمة (URI) أدناه بنقطة نهاية الخدمة هذه:

  • https://photoslibrary.googleapis.com

مورد REST: v1.albums

الطُرق
addEnrichment POST /v1/albums/{albumId}:addEnrichment
تُضيف ميزة "تحسين المحتوى" في موضع محدّد في ألبوم محدّد.
batchAddMediaItems POST /v1/albums/{albumId}:batchAddMediaItems
تُضيف هذه الوظيفة ملف وسائط واحدًا أو أكثر في مكتبة "صور Google" الخاصة بالمستخدم إلى ألبوم.
batchRemoveMediaItems POST /v1/albums/{albumId}:batchRemoveMediaItems
لإزالة عنصر وسائط واحد أو أكثر من ألبوم محدّد.
create POST /v1/albums
ينشئ ألبومًا في مكتبة "صور Google" للمستخدم.
get GET /v1/albums/{albumId}
لعرض الألبوم استنادًا إلى albumId المحدد.
list GET /v1/albums
تعرض هذه السمة جميع الألبومات التي تظهر للمستخدم في علامة التبويب "الألبومات" في تطبيق "صور Google".
patch PATCH /v1/albums/{album.id}
عدِّل الألبوم باستخدام id المحدّد.
share POST /v1/albums/{albumId}:share
وضع علامة على ألبوم كمُشترَك ويمكن للمستخدمين الآخرين الوصول إليه
unshare POST /v1/albums/{albumId}:unshare
يضع علامة على ألبوم تمت مشاركته سابقًا باعتباره خاصًا.

مورد REST: v1.mediaItems

الطُرق
batchCreate POST /v1/mediaItems:batchCreate
تُنشئ هذه الطريقة عنصرًا واحدًا أو أكثر من ملفات الوسائط في مكتبة "صور Google" لدى المستخدم.
batchGet GET /v1/mediaItems:batchGet
يتم عرض قائمة بعناصر الوسائط لمعرّفات عناصر الوسائط المحدّدة.
get GET /v1/mediaItems/{mediaItemId}
لعرض عنصر الوسائط لمعرف عنصر الوسائط المحدد.
list GET /v1/mediaItems
يمكنك إدراج جميع عناصر الوسائط من مكتبة "صور Google" لدى المستخدم.
patch PATCH /v1/mediaItems/{mediaItem.id}
تعديل عنصر الوسائط باستخدام id المحدَّد
search POST /v1/mediaItems:search
يبحث عن ملفات الوسائط في مكتبة "صور Google" لدى المستخدم.

مورد REST:‏ v1.sharedAlbums

الطُرق
get GET /v1/sharedAlbums/{shareToken}
لعرض الألبوم استنادًا إلى shareToken المحدد.
join POST /v1/sharedAlbums:join
الانضمام إلى ألبوم مشترَك نيابةً عن مستخدم "صور Google"
leave POST /v1/sharedAlbums:leave
مغادرة ألبوم مشترك تم الانضمام إليه سابقًا نيابةً عن مستخدم "صور Google"
list GET /v1/sharedAlbums
يسرد هذا الحقل جميع الألبومات المشتركة المتوفّرة في علامة التبويب "المشاركة" في تطبيق "صور Google" الخاص بالمستخدم.