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

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

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

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

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

Notes

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

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

Notes

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

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

الميزات

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

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

الميزات

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

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

الميزات

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

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

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

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

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

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

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

Notes

• تم تحديث الوثائق المتعلقة بعنوان URL الأساسي للصور المتحركة لتوضيح سلوك المعلمة =dv للصور المتحركة على Android والصور المتحركة على iOS.

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

Notes

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

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. لا يزال بإمكانك تحديد اسم ملف عنصر الوسائط عند تحميل وحدات بايت للوسائط، إلا أنّنا ننصحك بشدة بتحديث طريقة التنفيذ.

Notes

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

16 آب (أغسطس) 2019

الميزات

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

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

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

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

الميزات

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

Notes

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

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

دروس تطبيقية حول الترميز

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

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

الميزات

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

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

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

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

Notes

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

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

Notes

• يسري حد جديد لحصة الوصول إلى وحدات بايت الوسائط من عناوين 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.

Notes

• تم إدخال واجهة برمجة تطبيقات مكتبة "صور 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.

Notes

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