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

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

يتم تعديل هذه الصفحة بإضافة إصدار جديد من Google Photos Library API. سجل التغييرات يسرد الإصدارات حسب التاريخ ويتضمن أي ميزات جديدة وإصلاحات للأخطاء وغيرها التغييرات.

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

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.

ملاحظات

• تعديلات على إرشادات تجربة المستخدم التي توفّر إرشادات إضافية لتسمية المشروعات الألبومات.

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

Codelabs

• درس تطبيقي جديد حول الترميز: إنشاء تطبيق لمشاركة الصور باستخدام "صور Google" Flutter تعرَّف على كيفية إنشاء تطبيق لمشاركة الصور باستخدام واجهة برمجة تطبيقات مكتبة "صور Google" في 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 السارية. يمكنك مراقبة هذه الحصة في وحدة التحكم في واجهة Google API:

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

• المشكلة 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" متاحة للجمهور العام. شكرًا على ملاحظاتك. وطلبات الميزات خلال فترة معاينة مطوِّر برامج Library API.
• اطّلِع على الأدلّة الجديدة لبدء استخدام Java مكتبات برامج PHP
• تمت إضافة مقتطفات من الرموز البرمجية بلغتَي Java وPHP إلى الأدلة لشرح استخدام مكتبات العملاء.

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

الميزات

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

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

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

ملاحظات

• إذا كنت قد حفظت معرّفات (مثل معرّفات الألبومات أو عناصر الوسائط أو عناصر التحسين) قبل 5 أيلول (سبتمبر) 2018، لن تعمل بعد ذلك لأنّ التنسيق قد تغيّر. سيكون عليك الحصول على أرقام تعريف جديدة لاستخدامها في تطبيقك.
• السمة totalMediaItems تمت إعادة تسمية مورد album إلى 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: عرضت عمليات التحميل القابلة للاستئناف خطأ. اطّلِع على دليل عمليات التحميل التي يمكن استئنافها الجديد للاطّلاع على التعديلات التي تم إجراؤها على البروتوكول.
• المشكلة 79497397: سمة isWriteable غير متوفّرة في استجابة albums.list.
• المشكلة 111143493: فئة محتوى واحدة (PEOPLE) كان الفلتر يعرض نتائج غير دقيقة.
• المشكلة 111056278: فئة محتوى واحدة (BIRTHDAYS) كان عامل التصفية يعرض خطأً.

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

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

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

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