ملاحظات حول الإصدار

يمكنك الاشتراك في ملاحظات الإصدار هذه.

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

تشير المستندات والأدلة إلى أحدث إصدار يمكن استخدامه.

1 نيسان (أبريل) 2025

ملاحظات

ينفِّذ هذا الإصدار التغييرات التي تم الإعلان عنها سابقًا على واجهات برمجة تطبيقات "صور Google".

• إزالة بعض النطاقات من Library API
• حصر العديد من الطرق بالعمل مع المحتوى الذي تم إنشاؤه في التطبيق فقط
• سياسة مطوّري واجهة برمجة التطبيقات Photos API وبيانات مستخدميها الجديدة: تسري بدلاً من سياسة الاستخدام المقبول القديمة.

لمعرفة التفاصيل الكاملة، يُرجى الاطّلاع على التعديلات على واجهات برمجة تطبيقات "صور Google".

16 أيلول (سبتمبر) 2024

الميزات

• طرحنا واجهة برمجة التطبيقات Picker API الجديدة لاختيار الصور بأمان وبطريقة سهلة الاستخدام.

ملاحظات

في هذا الإصدار، أعلنّا عن تغييرات رئيسية على Library API (سيصبح ساريًا اعتبارًا من 31 آذار (مارس) 2025).

• ستدير Library API الصور والفيديوهات التي أنشأها تطبيقك فقط.
• إزالة نطاقات photoslibrary.readonly وphotoslibrary.sharing و photoslibrary
• حصر العديد من الطرق بالمحتوى الذي ينشئه التطبيق فقط

يمكنك الاطّلاع على التفاصيل الكاملة في صفحة تعديلات على واجهات برمجة تطبيقات "صور Google".

27 تشرين الأول (أكتوبر) 2022

ملاحظات

• لم يعُد متاحًا ورشة رموز "إنشاء تطبيق لمشاركة الصور باستخدام "صور Google" وFlutter". راجِع النماذج الأخرى واطّلِع على رمز النموذج ضمن أدلةنا.

1 حزيران (يونيو) 2022

ملاحظات

• تمت إضافة أفضل الممارسات المتعلقة بالتحميل للمساعدة في توضيح عملية التحميل، وتسليط الضوء على الأخطاء الشائعة وكيفية تجنّبها، وتقديم نصائح لتحسين كفاءة التحميل.

27 تشرين الأول (أكتوبر) 2021

الميزات

• برنامج شركاء "صور Google": إطلاق المستوى المميّز تشمل الفئة المميّزة مجموعة من ميزات واجهة برمجة التطبيقات المحسّنة التي تستفيد من الذكاء الاصطناعي القوي في "صور Google".

29 أيلول (سبتمبر) 2021

الميزات

• خيار جديد لترتيب عمليات البحث المستندة إلى فلتر التاريخ يمكن ترتيب النتائج حسب الأحدث أولاً أو الأقدم أولاً. ويتيح ذلك البحث بسهولة أكبر ويزيد من الكفاءة من خلال تقديم نتائج بحث مستهدفة بشكلٍ أفضل.

21 تموز (يوليو) 2021

الميزات

• -no مَعلمة جديدة لعناوين URL الأساسية للفيديوهات لتحميل الصور المصغّرة بدون زر تشغيل متراكب يتم تلقائيًا تحميل Thumbnails للفيديوهات مع زر تشغيل متراكب. تمنحك هذه المَعلمة الجديدة إمكانية إخفاء زر التشغيل في الصور المصغّرة للفيديوهات.

المشاكل التي تم حلّها

• الطلب 181282432: يتم دائمًا عرض الصور المصغّرة للفيديوهات مع زر تشغيل متراكب.

25 أيار (مايو) 2021

المشاكل التي تم حلّها

• لم يتمّ تعبئة بيانات الموقع الإلكتروني exposureTime لملفphoto الوصفي في عناصر الوسائط.

19 أيار (مايو) 2021

ملاحظات

• تم تعديل مستندات عنوان URL الأساسي للصور الحية لشرح سلوك المَعلمة =dv للصور الحية على Android وLive Photos على iOS.

11 شباط (فبراير) 2021

ملاحظات

• تم تعديل سياسة الاستخدام المقبول، مع إضافة محتوى حول الإعلانات والحدّ من استخدام البيانات.

7 تموز (يوليو) 2020

الميزات

• تم تعديل واجهة برمجة التطبيقات لتتوافق مع عناصر التحكّم الجديدة في المشاركة في "صور Google". يتم الآن عرض حقل جديد، وهو isJoinable، كجزء من السمة shareInfo للألبومات المشترَكة. يمكن لواجهة برمجة التطبيقات إدراج مستخدمين في ألبوم مشترَك عندما يكون isJoinable هو true. إذا أوقف المالك ميزة "مشاركة الرابط" في ألبوم في "صور Google"، سيكون isJoinable هو false، ولن تتمكّن واجهة برمجة التطبيقات من ربط المستخدمين بهذا الألبوم.
• المشاكل 111405623، 116379853، 117685011: يمكنك الآن تغيير عناوين الألبومات وصور الأغلفة، وتغيير أوصاف عناصر الوسائط التي أنشأها تطبيقك. اطلب photoslibrary.edit.appcreateddata نطاق التفويض الجديد للوصول إلى ميزة التعديل.

17 شباط (فبراير) 2020

الميزات

• تمت زيادة الحد الأقصى لحجم ملف التحميل الذي يمكن استخدامه لتحميل صورة من 75 ميغابايت إلى 200 ميغابايت.
• عند تحميل الملفات، يجب الآن تحديد نوع MIME في مرحلة تحميل البايت.
• يمكنك الآن تحديد أسماء الملفات عند إنشاء ملف وسائط، بدلاً من عند تحميل وحدات بايت الوسائط. يتوافق السمة fileName الجديدة في simpleMediaItem مع سلاسل UTF-8. سيظل بإمكانك تحديد اسم ملف عنصر الوسائط عند تحميل وحدات بايت الوسائط، ولكننا ننصحك بشدة بتعديل عملية التنفيذ.

ملاحظات

• تم تعديل سياسة الاستخدام المقبول، مع إضافة بعض التفاصيل الإضافية التي تركّز على الحد من استخدام البيانات وتخزينها.
• تم تعديل مستندات عنوان URL الأساسي لتضمين الصور الحيّة.

16 آب (أغسطس) 2019

الميزات

• الطلب 131874809: سمة جديدة isOwned في shareInfo لتحديد ما إذا كان المستخدم هو مالك الألبوم المشترَك. يمكنك الاطّلاع على مزيد من التفاصيل في دليل المطوّر المخصّص لمشاركة الوسائط.

المشاكل التي تم حلّها

• المشكلة 131711405: كانت سمة shareableUrl غير متوفّرة في الردّ albums.list.
• المشكلة 113870729: mediaItems.list كانت في بعض الأحيان تعرض عناصر وسائط مكرّرة عند حدود الصفحة.
• المشكلة 93428763: يعرض الآن حقل status للبيانات الوصفية للفيديوVideoProcessingStatus الفيديو الأعلى جودة المتاح.

12 حزيران (يونيو) 2019

الميزات

• الطلب 110188560: فلتر بحث جديد لاختيار ملفّات الوسائط التي تم وضع علامة عليها كعناصر مفضّلة: FeatureFilter
• فئات محتوى جديدة لعلامة التبويب ContentFilter لفلترة عناصر الوسائط التي تتطابق مع فئات معيّنة: ARTS وCRAFTS وFASHION وHOUSES وGARDENS وFLOWERS وHOLIDAYS

ملاحظات

• إرشادات مُحدَّثة حول تجربة المستخدم تقدّم guidance إضافية حول اختيار أسماء للمشاريع والألبومات

7 أيار (مايو) 2019

Codelabs

• دورة تدريبية جديدة حول رموز البرامج: إنشاء تطبيق لمشاركة الصور باستخدام "صور Google" وIDE Flutter تعرَّف على كيفية إنشاء تطبيق لمشاركة الصور باستخدام Google Photos Library API في Flutter. اطّلِع على دليل العيّنات للاطّلاع على التفاصيل.

29 نيسان (أبريل) 2019

الميزات

• الطلب 109505022: طلبات جديدة لإضافة ملفات وسائط حالية إلى ألبوم و إزالتها منه:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  تتيح هذه الطلبات الوصول إلى عناصر الوسائط والألبومات التي أنشأها تطبيقك. تتوفّر مزيد من التفاصيل في دليل المطوّر حول إدارة الألبومات.

• يعرض طلب REST لإنشاء عناصر وسائط mediaItems.batchCreate الآن حالة HTTP 207 MULTI-STATUS للنجاح الجزئي في حال تعذّر إنشاء بعض عناصر الوسائط. يمكنك الاطّلاع على مزيد من التفاصيل في دليل المطوّر المتعلق بتحميل الوسائط.

ملاحظات

• تتضمّن أحدث إصدارات مكتبات العميل تغييرًا جذريًا. تم نقل الفئات المرتبطة بـ MediaItem وAlbum وDateRange إلى حزمة جديدة مخصّصة. لم تتغيّر وظائف هذه العناصر، بل تغيّر موقعها فقط في مكتبة العملاء. راجِع ملاحظات الإصدار لكلّ من مكتبة Java العميلة (1.2.0) ومكتبة PHP العميلة (1.2.0).

14 شباط (فبراير) 2019

ملاحظات

• يتم تطبيق حدّ حصة جديد للاطّلاع على وحدات بايت الوسائط من عناوين قاعدة URL. يمكنك مراقبة هذه الحصة في وحدة تحكّم واجهة برمجة التطبيقات.

المشاكل التي تم حلّها

• المشكلة 124355983: أخطاء 500 عند الاتصال mediaItems.get لأجل بعض عناصر الوسائط المشتركة

21 كانون الثاني (يناير) 2019

المشاكل التي تم حلّها

• المشكلة 121998358: كانت السمة isWriteable غير متوفّرة في ردّ albums.create.

7 كانون الثاني (يناير) 2019

المشاكل التي تم حلّها

• المشكلة 118464845: عرضت mediaItems.list عددًا كبيرًا جدًا من الصفحات الفارغة.
• الطلب 111714379: أرجعت mediaItems.search نصف pageSize.

30 تشرين الثاني (نوفمبر) 2018

الميزات

• طلب جديد mediaItems.batchGet لاسترداد عناصر وسائط متعددة حسب معرّفاتها
• الطلب 111279349: طلب جديد sharedAlbums.leave لمغادرة ألبوم مشترك
• الطلب 111279347: طلب جديد لإضافة رمز albums.unshare لتمييز ألبوم مشترَك على أنّه خاص

المشاكل التي تم حلّها

• الخطأ 113978705: تم تحويل الأوصاف التي تم ضبطها في mediaItems.batchCreate إلى عناصر HTML.
• الطلب 114462217: تعذّر ضبط اسم ملف لملفّات الفيديو في mediaItems.batchCreate.
• المشكلة 118475587: تم عرض عناوين URL غير صالحة للمنتجات لعناصر الوسائط.
• المشكلة 111862704: أخطاء 403 عند الوصول إلى عناوين URL الأساسية
• المشكلة 115932469: تعذُّر عمليات التحميل بسبب خطأ في المساحة المتوفّرة.

6 أيلول (سبتمبر) 2018

الميزات

• أصبحت مكتبات العملاء لـ Java وPHP متوفرة الآن.

ملاحظات

• أصبحت Google Photos Library API متاحة للجميع. نشكرك على ملاحظاتك وطلباتك بشأن الميزات خلال فترة معاينة المطوّرين لواجهة برمجة التطبيقات Library API.
• اطّلِع على الأدلة الجديدة للبدء باستخدام مكتبتَي برمجة تطبيقات Java و PHP.
• تمت إضافة مقتطفات من الرموز البرمجية بلغتَي Java وPHP إلى الأدلة لشرح استخدام مكتبات العملاء.

5 أيلول (سبتمبر) 2018

الميزات

• مكالمة جديدة sharedAlbums.get ل الحصول على ألبوم باستخدام shareToken
• الموقع الجديد isJoined في shareInfo لتحديد ما إذا كان المستخدم قد انضم إلى الألبوم المشترَك

المشاكل التي تم حلّها

• الخطأ 79321120: لم تكن السمة mimeType متوفّرة في ردّ mediaItems.batchCreate لعناصر الوسائط في الفيديو.
• المشكلة 79319272: لم تتضمّن استجابة mediaItems.batchCreate سمات مثل mediaMetadata وcontributorInfo.
• المشكلة 110237685: تم حلّ مشكلة مرتبطة بتحميل الملفات تتعلّق بسياسة مشاركة الموارد المتعددة المصادر (CORS).
• المشكلة 79318118: لم يكن يتم الحفاظ على الترتيب المتّسق عند تحميل عناصر متعددة إلى ألبوم في طلب mediaItems.batchCreate.

ملاحظات

• إذا كنت قد تخزّنت معرّفات (مثل معرّفات الألبومات أو عناصر الوسائط أو عناصر التحسين) قبل 5 أيلول (سبتمبر) 2018، لن تعود صالحة لأنّ التنسيق قد تغيّر. عليك الحصول على أرقام تعريف جديدة لاستخدامها في تطبيقك.
• تمت إعادة تسمية السمة totalMediaItems لمورد الألبوم إلى mediaItemsCount.
• تم تغيير الحد الأقصى لقيمة المَعلمة pageSize في دعوات mediaItems.list و mediaItems.search إلى 100. تم تغيير العدد التلقائي لعناصر الوسائط التي يتم عرضها عند عدم تحديد المَعلمة pageSize إلى 25.
• تم تعديل أدلة عرض محتوى المكتبة و مشاركة الوسائط و الوصول إلى عناصر الوسائط بإضافة ميزة الفلترة excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) التي تم طرحها في 31 تموز (يوليو) 2018.

31 تموز (يوليو) 2018

الميزات

• طلب جديد mediaItems.list لعرض عناصر الوسائط
• فلتر جديد excludeNonAppCreatedData للبحث عن العناصر أو عرض الألبومات التي أنشأها تطبيقك
• مَعلمات جديدة لالوصول إلى الصور:
  • المشكلة 79871479: c مَعلمة الاقتصاص، لاقتصاص الصورة إلى أبعاد دقيقة
  • الطلب 110343547، الطلب 111228390: مَعلمة تنزيل d، لتنزيل الصورة الأصلية
• يعرض الآن طلب البحث sharedAlbums.join ألبومًا.
• المشكلة 109655786: يحتوي album الآن على معرّف عنصر الوسائط لصورة الغلاف، وهو coverPhotoMediaItemId.
• الإصدار 79656863: mediaItem يحتوي الآن على اسم ملف عنصر الوسائط، filename.

المشاكل التي تم حلّها

• المشكلة 79757390: لم يكن يتم ضبط اسم الملف أثناء طلبات التحميل. اطّلِع على الحقلَين X-Goog-Upload-File-Namefile و X-Goog-Upload-Protocol في دليل تحميل الوسائط.
• المشكلة 80182372: ظهرت رسالة خطأ عند محاولة تحميل ملف قابل للاستئناف. اطّلِع على دليل عمليات التحميل التي يمكن استئنافها الجديد للاطّلاع على التعديلات التي تم إجراؤها على الprotocolly.
• المشكلة 79497397: سمة isWriteable غير متوفّرة في استجابة albums.list.
• المشكلة 111143493: كان فلتر فئة المحتوىPEOPLE يعرض نتائج غير دقيقة.
• المشكلة 111056278: كان فلتر BIRTHDAYS content category يعرض خطأ.

الإصدار التجريبي: 8 أيار (مايو) 2018

الإصدار الأولي من Library API

المشاكل المعروفة

• يُرسِل GET mediaItem خطأً إذا كان عنصر الوسائط id الذي يتلقّاه هو عنصر وسائط من ألبوم مشترَك وليس مملوكًا للمستخدم.
• لن يؤدي الردّ من طلب batchCreate إلى عرض mediaMetadata أو contributorInfo.
• إذا كان عنصر الوسائط فيديو، لن تؤدي طلب البحث batchCreate إلى عرض mimeType.
• لا تحافظ batchCreate على ترتيب ثابت عند تحميل عناصر متعددة.
• لا تتيح batchCreate ترتيب العناصر (بإضافة position) عند إنشاء عناصر وسائط في ألبوم مشترَك بصفتك مالك الألبوم المشترَك. يتم ضبطه تلقائيًا على نهاية الألبوم.