به‌روزرسانی‌های Google Photos API

ارسال شده در سپتامبر 2024.

این صفحه جزئیاتی را در مورد تغییرات خاصی که در APIهای Google Photos ایجاد می شود ارائه می دهد. جزئیات این صفحه را مرور کنید تا متوجه شوید روش ها و دامنه هایی که استفاده می کنید چگونه ممکن است تحت تأثیر قرار گیرند. اطلاعات بیشتر در مورد اعلام این تغییرات را می توانید در پست وبلاگ مرتبط بخوانید.

کتابخانه API: تأثیر بر موارد استفاده رایج

بخش‌های زیر تأثیر تغییرات آتی بر موارد استفاده رایج را شرح می‌دهد.

آپلود آیتم های رسانه ای و ایجاد آلبوم

آنچه در حال تغییر است: بدون تغییر. می توانید با استفاده از محدوده photoslibrary.appendonly به آپلود موارد رسانه و ایجاد آلبوم ادامه دهید.

کاری که می توانید انجام دهید:

اگر برنامه شما در حال آپلود آیتم‌های رسانه یا ایجاد آلبوم است، مطمئن شوید که از محدوده photoslibrary.appendonly استفاده می‌کنید، نه از محدوده photoslibrary . محدوده photoslibrary در حال حذف شدن است.

فهرست کردن، جستجو و بازیابی آیتم ها و آلبوم های رسانه ای

چه چیزی در حال تغییر است: اکنون فقط می توانید آلبوم ها و موارد رسانه ای را که توسط برنامه شما ایجاد شده اند فهرست، جستجو و بازیابی کنید.

کاری که می توانید انجام دهید:

• اگر برنامه شما به کاربران نیاز دارد که عکس‌ها یا آلبوم‌ها را از کل کتابخانه خود انتخاب کنند، از Google Photos Picker API جدید استفاده کنید. این روشی امن و کاربرپسند را برای کاربران فراهم می کند تا به محتوای خاصی دسترسی داشته باشند.
• اگر برنامه شما متکی به دسترسی به کل کتابخانه کاربر است، ممکن است لازم باشد برنامه خود را دوباره ارزیابی کنید یا رویکردهای جایگزین را در نظر بگیرید.

اشتراک گذاری و آلبوم های مشترک

چه چیزی در حال تغییر است: آلبوم‌های مشترک و عملکردهای API مرتبط (اشتراک‌گذاری، لغو اشتراک، دریافت، پیوستن، خروج و فهرست کردن) پس از 31 مارس 2025 403 PERMISSION_DENIED برمی‌گردانند.

کاری که می توانید انجام دهید:

کاربران را به برنامه Google Photos هدایت کنید تا اشتراک‌گذاری خود را مدیریت کنند. می توانید دستورالعمل های واضح یا پیوندهای عمیق را در برنامه خود برای راهنمایی آنها ارائه دهید.

مدیریت آلبوم های ایجاد شده توسط برنامه: غنی سازی ها و محتویات آلبوم

چه چیزی در حال تغییر است: photoslibrary.edit.appcreatedata برای سازگاری مفهومی به سه روش زیر اضافه می شود:

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

کاری که می توانید انجام دهید:

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

کتابخانه API: دامنه ها و روش های تحت تأثیر

به عنوان بخشی از تغییرات خود در APIهای Google Photos، به‌روزرسانی‌های زیر را انجام داده‌ایم.

همانطور که در صفحه مجوز به روز شده نشان داده شده است، حوزه های زیر از 31 مارس 2025 از کتابخانه API حذف خواهند شد:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

دامنه های زیر باقی خواهند ماند:

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

این جدول روش‌ها و محدوده‌های خاص کتابخانه API را که تحت تأثیر قرار گرفته است، توضیح می‌دهد.

به‌روزرسانی‌های خط‌مشی Photos API

خط‌مشی استفاده قابل قبول فعلی پس از ۳۱ مارس ۲۰۲۵ با داده‌های کاربر و خط‌مشی برنامه‌نویس Photos API جدید جایگزین می‌شود. خط مشی جدید اکنون برای پیش نمایش در دسترس است.

به‌روزرسانی‌های مستندات Photos API

ما تغییرات قابل توجهی در اسناد Photos API ایجاد کرده‌ایم تا به‌روزرسانی‌های آینده را منعکس کرده و از تجربه توسعه شما پشتیبانی کنیم:

• سایت Unified Photos APIs: ما همه منابع Photos API را در یک مکان مناسب و واحد (این سایت) ادغام کرده‌ایم و تجربه‌ای ساده را برای توسعه‌دهندگان فراهم می‌کنیم. در اینجا خواهید یافت:
  • منابع متمرکز: دستورالعمل‌های راه‌اندازی ترکیبی و راهنمای استفاده عمومی ، و اطلاعات پشتیبانی و خط‌مشی ترکیبی برای Picker API و Library API.
  • سایت های اختصاصی API: سایت های مجزا با راهنماهای دقیق، اسناد مرجع و نمونه کد برای Picker API و Library API
• محتوای کتابخانه API به روز شده: اسناد کتابخانه API برای منعکس کردن قابلیت های آن پس از غروب آفتاب تجدید نظر شده است. در سرتاسر اسناد به‌روزرسانی شده، برچسب‌هایی را می‌بینید که هر محتوای تغییر یا حذف شده را برجسته می‌کنند، با پیوندهایی به محتوای قدیمی مربوطه برای ارجاع در هنگام مهاجرت.
• اسناد قدیمی حفظ شده: ما اسناد کتابخانه API اصلی را برای توسعه دهندگانی که نیاز به انتقال ادغام های موجود دارند، حفظ کرده ایم. اگر پروژه جدیدی را شروع می کنید، از اسناد به روز شده استفاده کنید. اگر در حال به روز رسانی یک پروژه موجود هستید، به اسناد قدیمی و به روز شده در طول مهاجرت خود مراجعه کنید.

سوالات متداول

چه چیزی با APIهای Google Photos تغییر می کند؟

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

این تغییرات چه زمانی اعمال می شود؟

این تغییرات از 31 مارس 2025 اعمال خواهند شد. ما از همه افرادی که دارای ادغام‌های موجود هستند و از کتابخانه API برای انتخاب عکس استفاده می‌کنند، تشویق می‌کنیم تا در اسرع وقت به API Picker مهاجرت کنند.

کتابخانه API چگونه تحت تأثیر قرار خواهد گرفت؟

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

می توانید مجموعه کامل تغییرات را در جدول بالای همین صفحه مشاهده کنید.

اگر برنامه من در حال حاضر از محدوده ها یا روش های آسیب دیده استفاده می کند، چه کاری باید انجام دهم؟

اگر برنامه شما از هر یک از حوزه‌ها یا روش‌های آسیب‌دیده استفاده می‌کند، توصیه می‌کنیم مراحل زیر را انجام دهید:

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

Google Photos Picker API چیست؟

Picker API روشی جدید و ایمن برای توسعه دهندگان است که به کاربران اجازه می دهد عکس ها و آلبوم ها را از کتابخانه Google Photos خود انتخاب کنند و به طور یکپارچه آنها را به برنامه شما برگردانند. Picker API قابلیت های انتخاب عکس قوی را ارائه می دهد، از جمله انتخاب موارد جداگانه، انتخاب همه موارد در یک آلبوم، و جستجو در کتابخانه Google Photos.

از کجا می توانم اطلاعات بیشتری در مورد این تغییرات پیدا کنم؟

این صفحه ای که در حال حاضر مشاهده می کنید نمای کلی و خلاصه ای از تمام تغییرات را ارائه می دهد.

بقیه اسناد موجود در سایت ما به روز شده اند تا API های به روز شده را منعکس کنند.

این پست وبلاگ تغییرات را اعلام می کند.

اگر سؤالات بیشتری داشته باشم یا برای انتقال درخواستم به کمک نیاز داشته باشم، چه؟

اگر درباره مستندات برنامه‌نویس سؤالی دارید، صفحه پشتیبانی ما را برای جزئیات بیشتر در مورد دریافت راهنمایی مرور کنید .