یادداشت های انتشار

در این یادداشت های انتشار مشترک شوید .

این صفحه با هر نسخه جدید از APIهای Google Photos به روز می شود. تغییرات فهرست انتشار بر اساس تاریخ و شامل هرگونه ویژگی جدید، رفع اشکال و سایر تغییرات است.

اسناد و راهنماها به آخرین نسخه برای استفاده اشاره می کنند.

1 آوریل 2025

یادداشت ها

این نسخه تغییراتی را که قبلاً در Photos API اعلام شده بود، پیاده‌سازی می‌کند.

• حذف برخی از محدوده ها از کتابخانه API.
• محدودیت چندین روش برای کار فقط با محتوای ایجاد شده توسط برنامه.
• خط‌مشی اطلاعات کاربر و برنامه‌نویس Photos API جدید به جای خط‌مشی استفاده قابل قبول قدیمی اعمال می‌شود.

برای جزئیات کامل ، به‌روزرسانی‌های Google Photos APIs را بخوانید.

16 سپتامبر 2024

ویژگی ها

• Picker API جدید را برای انتخاب عکس ایمن و کاربرپسند معرفی کرد.

یادداشت ها

در این نسخه تغییرات کلیدی را در کتابخانه API (از 31 مارس 2025) اعلام کردیم.

• کتابخانه API فقط عکس‌ها و ویدیوهای ایجاد شده توسط برنامه شما را مدیریت می‌کند.
• حذف photoslibrary.readonly ، photoslibrary.sharing ، و photoslibrary scope.
• محدود کردن چندین روش فقط به محتوای ایجاد شده توسط برنامه.

جزئیات کامل در صفحه به‌روزرسانی‌های APIهای Google Photos ارائه می‌شود.

27 اکتبر 2022

یادداشت ها

• آزمایشگاه کد «ساخت برنامه اشتراک‌گذاری عکس با Google Photos و Flutter» دیگر در دسترس نیست. نمونه های دیگر ما را بررسی کنید و به کد نمونه در راهنماهای ما مراجعه کنید.

1 ژوئن 2022

یادداشت ها

• بهترین روش‌ها را برای آپلود اضافه کرد تا به شفاف‌سازی فرآیند آپلود کمک کند، خطاهای رایج و نحوه اجتناب از آنها را بیان کند، و نکاتی را برای بهبود کارایی آپلود ارائه دهد.

27 اکتبر 2021

ویژگی ها

• برنامه شریک Google Photos: راه‌اندازی لایه برتر . لایه برتر مجموعه ای از ویژگی های API پیشرفته است که از هوش ماشینی قدرتمند عکس های Google استفاده می کند.

29 سپتامبر 2021

ویژگی ها

• گزینه جدیدی برای مرتب سازی جستجوهای مبتنی بر فیلتر تاریخ . نتایج را می توان ابتدا جدیدترین یا ابتدا قدیمی ترین مرتب کرد. این امکان جستجوی آسان‌تر را فراهم می‌کند و با ارائه نتایج جستجوی هدفمند بهتر، کارایی را بهبود می‌بخشد.

21 جولای 2021

ویژگی ها

• -no پارامتر جدید برای URL های پایه ویدیو برای بارگیری تصاویر کوچک بدون پوشش دکمه پخش. به‌طور پیش‌فرض، ریز عکس‌های ویدیویی با پوشش دکمه پخش بارگیری می‌شوند. این پارامتر جدید به شما کنترل مخفی کردن دکمه پخش در تصاویر کوچک ویدیو را می دهد.

مسائل حل شد

• شماره 181282432 : تصاویر کوچک ویدیو همیشه با یک دکمه پخش نمایش داده می شود.

25 مه 2021

مسائل حل شد

• ویژگی exposureTime برای فراداده photo در آیتم های رسانه پر نشده است.

19 مه 2021

یادداشت ها

• مستندات URL پایه برای عکس‌های متحرک به‌روزرسانی شده است تا رفتار پارامتر =dv را برای عکس‌های متحرک Android و عکس‌های زنده iOS روشن کند.

11 فوریه 2021

یادداشت ها

• خط مشی استفاده قابل قبول به روز شده است، محتوای تبلیغاتی را اضافه می کند و استفاده از داده را به حداقل می رساند.

7 جولای 2020

ویژگی ها

• API برای پشتیبانی از کنترل‌های اشتراک‌گذاری جدید در Google Photos به‌روزرسانی شده است. یک فیلد جدید، isJoinable ، اکنون به عنوان بخشی از ویژگی shareInfo برای آلبوم‌های مشترک برگردانده شده است. وقتی isJoinable true باشد، API می‌تواند کاربران را به یک آلبوم مشترک ملحق کند . اگر مالکی اشتراک‌گذاری پیوند را در آلبومی در Google Photos غیرفعال کرده باشد، isJoinable false است و API نمی‌تواند کاربران را به آن آلبوم بپیوندد.
• شماره‌های 111405623 ، 116379853 ، 117685011 : اکنون می‌توانید عناوین آلبوم و عکس‌های جلد را تغییر دهید ، و توضیحات را برای موارد رسانه‌ای که برنامه خود ایجاد کرده است تغییر دهید . برای دسترسی به‌روزرسانی، محدوده مجوز جدید photoslibrary.edit.appcreateddata درخواست کنید.

17 فوریه 2020

ویژگی ها

• حداکثر حجم فایل آپلود یک عکس از 75 مگابایت به 200 مگابایت افزایش یافته است.
• وقتی فایل‌ها را آپلود می‌کنید، اکنون باید یک نوع MIME در مرحله آپلود بایت مشخص شود.
• اکنون به جای بارگذاری بایت های رسانه، نام فایل ها را هنگام ایجاد یک آیتم رسانه مشخص می کنید. ویژگی fileName جدید در simpleMediaItem از رشته های UTF-8 پشتیبانی می کند. هنوز هم می‌توانید هنگام آپلود بایت‌های رسانه، نام فایل مورد رسانه را مشخص کنید، با این حال ما قویاً توصیه می‌کنیم پیاده‌سازی خود را به‌روزرسانی کنید.

یادداشت ها

• خط‌مشی استفاده قابل قبول به‌روزرسانی شده است، با برخی جزئیات اضافی که بر به حداقل رساندن استفاده و ذخیره داده تمرکز دارد.
• مستندات URL پایه برای شامل عکس های متحرک به روز شده است.

16 آگوست 2019

ویژگی ها

• شماره 131874809 : دارایی جدید در shareInfo isOwned تا مشخص شود آیا کاربر مالک آلبوم مشترک است یا خیر. جزئیات بیشتر در راهنمای توسعه دهنده رسانه اشتراک گذاری موجود است.

مسائل حل شد

• شماره 131711405 : ویژگی shareableUrl در پاسخ albums.list وجود نداشت.
• شماره 113870729 : mediaItems.list گاهی اوقات موارد رسانه ای تکراری را در مرزهای صفحه برمی گرداند.
• شماره 93428763 : فیلد status برای فراداده ویدیو اکنون به درستی وضعیت VideoProcessingStatus با بالاترین کیفیت ویدیوی موجود را برمی‌گرداند.

12 ژوئن 2019

ویژگی ها

• شماره 110188560 : فیلتر جستجوی جدید برای انتخاب موارد رسانه ای که به عنوان مورد علاقه علامت گذاری شده اند: FeatureFilter .
• دسته‌های محتوای جدید برای ContentFilter برای فیلتر کردن موارد رسانه‌ای که با دسته‌های خاص مطابقت دارند: ARTS ، CRAFTS ، FASHION ، HOUSES ، GARDENS ، FLOWERS ، HOLIDAYS .

یادداشت ها

• دستورالعمل های UX به روز شده که راهنمایی های بیشتری را برای نام گذاری پروژه ها و آلبوم ها ارائه می دهد.

7 مه 2019

Codelabs

• Codelab جدید: یک برنامه اشتراک‌گذاری عکس با Google Photos و Flutter بسازید . با نحوه ایجاد یک برنامه اشتراک‌گذاری عکس با استفاده از Google Photos Library API در Flutter آشنا شوید. برای جزئیات به راهنمای نمونه ها مراجعه کنید.

29 آوریل 2019

ویژگی ها

• شماره 109505022 : تماس‌های جدید برای افزودن و حذف موارد رسانه‌ای موجود به آلبوم:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  این تماس‌ها از آیتم‌های رسانه و آلبوم‌هایی پشتیبانی می‌کنند که توسط برنامه شما ایجاد شده‌اند. جزئیات بیشتر در راهنمای توسعه‌دهنده آلبوم‌های مدیریت موجود است.

• فراخوان REST برای ایجاد موارد رسانه mediaItems.batchCreate اکنون وضعیت HTTP 207 MULTI-STATUS را برای موفقیت نسبی برمی‌گرداند اگر برخی از موارد رسانه ایجاد نشدند. جزئیات بیشتر در راهنمای برنامه‌نویس رسانه آپلود موجود است.

یادداشت ها

• آخرین نسخه‌های کتابخانه‌های سرویس گیرنده شامل یک تغییر اساسی است. کلاس های مرتبط با MediaItem ، Album و DateRange به یک بسته اختصاصی جدید منتقل شده اند. عملکرد آنها تغییر نکرده است، فقط مکان آنها در کتابخانه مشتری است. به یادداشت های انتشار برای کتابخانه سرویس گیرنده جاوا (1.2.0) و کتابخانه مشتری PHP (1.2.0) مراجعه کنید.

14 فوریه 2019

یادداشت ها

• محدودیت سهمیه جدیدی برای دسترسی به بایت های رسانه از URL های پایه اعمال می شود. می‌توانید این سهمیه را در Google API Console نظارت کنید .

مسائل حل شد

• شماره 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 : نشانی‌های اینترنتی نامعتبر محصول برای موارد رسانه برگردانده شد.
• شماره 111862704 : خطاهای 403 هنگام دسترسی به URL های پایه.
• شماره 115932469 : آپلودها با خطای سهمیه ناموفق هستند.

6 سپتامبر 2018

ویژگی ها

• کتابخانه های کلاینت جاوا و PHP اکنون در دسترس هستند.

یادداشت ها

• Google Photos Library API در دسترس بودن عمومی قرار گرفته است. از بازخورد و درخواست‌های ویژگی شما در طول دوره پیش‌نمایش توسعه‌دهنده کتابخانه API متشکریم.
• راهنماهای جدید برای شروع کار با کتابخانه های کلاینت جاوا و PHP را بررسی کنید.
• نمونه کدهای جاوا و پی اچ پی برای نشان دادن استفاده از کتابخانه های سرویس گیرنده به راهنماها اضافه شده است.

5 سپتامبر 2018

ویژگی ها

• تماس جدید sharedAlbums.get برای دریافت آلبوم با استفاده از shareToken .
• ویژگی جدید در shareInfo isJoined تا مشخص شود آیا کاربر به آلبوم مشترک پیوسته است یا خیر.

مسائل حل شد

• شماره 79321120 : ویژگی mimeType در mediaItems.batchCreate پاسخ برای موارد رسانه ویدیویی وجود نداشت.
• شماره 79319272 : ویژگی هایی مانند mediaMetadata ، contributorInfo در پاسخ mediaItems.batchCreate وجود نداشت.
• شماره 110237685 : مشکل آپلود فایل مربوط به CORS برطرف شد.
• شماره 79318118 : هنگام آپلود چندین مورد در یک آلبوم در تماس mediaItems.batchCreate ، نظم ثابتی حفظ نمی شد.

یادداشت ها

• اگر شناسه‌ها (مانند شناسه‌های آلبوم‌ها، آیتم‌های رسانه یا موارد غنی‌سازی) را قبل از ۵ سپتامبر ۲۰۱۸ ذخیره کرده‌اید، با تغییر قالب، دیگر کار نمی‌کنند. برای استفاده در برنامه خود باید شناسه های جدیدی دریافت کنید.
• ویژگی 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 : آپلودهای قابل ازسرگیری با خطا مواجه شدند. راهنمای آپلودهای Resumable جدید برای پروتکل به روز شده را ببینید.
• شماره 79497397 : ویژگی isWriteable در پاسخ آلبومs.list وجود ندارد.
• شماره 111143493 : فیلتر دسته بندی محتوای PEOPLE نتایج نادرستی را نشان می داد.
• شماره 111056278 : فیلتر دسته محتوای BIRTHDAYS خطایی را برمی‌گرداند.

نسخه پیش نمایش - 8 مه 2018

انتشار اولیه کتابخانه API.

مسائل شناخته شده

• اگر شناسه id رسانه‌ای که دریافت می‌کند برای آیتم رسانه‌ای است که از یک آلبوم مشترک است و متعلق به کاربر نیست، GET mediaItem خطا می‌دهد.
• پاسخ از تماس batchCreate mediaMetadata یا contributorInfo را بر نمی گرداند.
• اگر مورد رسانه یک ویدیو باشد، تماس batchCreate mimeType برنمی‌گرداند.
• batchCreate هنگام آپلود چندین مورد، نظم ثابتی را حفظ نمی کند.
• batchCreate هنگام ایجاد موارد رسانه در یک آلبوم مشترک به عنوان مالک آلبوم مشترک، از سفارش دادن (افزودن در position ) پشتیبانی نمی کند. به طور پیش فرض به انتهای آلبوم می رسد.