تحديثات على واجهات برمجة التطبيقات لصور Google

تاريخ النشر: أيلول (سبتمبر) 2024

تقدّم هذه الصفحة تفاصيل عن تغييرات محدّدة يتم إجراؤها على واجهات برمجة التطبيقات في "صور Google". راجِع التفاصيل الواردة في هذه الصفحة للتعرّف على كيفية تأثُّر الطرق والنطاقات التي تستخدمها. يمكنك الاطّلاع على مزيد من المعلومات حول إعلان هذه التغييرات في مشاركة المدونة ذات الصلة.

Library API: التأثير في حالات الاستخدام الشائعة

توضّح الأقسام التالية بالتفصيل كيفية تأثُّر حالات الاستخدام الشائعة بالتغييرات القادمة.

تحميل عناصر الوسائط وإنشاء ألبومات

التغييرات: لن تطرأ أي تغييرات. يمكنك مواصلة تحميل عناصر الوسائط و إنشاء ألبومات باستخدام نطاق photoslibrary.appendonly.

الإجراءات التي يمكنك اتّخاذها:

إذا كان تطبيقك يحمّل عناصر وسائط أو ينشئ ألبومات، تأكَّد من استخدام نطاق photoslibrary.appendonly وليس نطاق photoslibrary. تتم إزالة النطاق photoslibrary.

إدراج ملفات الوسائط والألبومات والبحث عنها واستردادها

التغييرات: يمكنك الآن إدراج الألبومات ومواد الوسائط التي أنشأها تطبيقك والبحث عنها واستردادها فقط.

الإجراءات التي يمكنك اتّخاذها:

• إذا كان تطبيقك يتطلّب من المستخدمين اختيار صور أو ألبومات من مكتبتهم بالكامل، استخدِم Google Photos Picker API الجديدة. ويوفّر ذلك طريقة آمنة وسهلة الاستخدام للمستخدمين من أجل منح إذن الوصول إلى محتوى معيّن.
• إذا كان تطبيقك يعتمد على الوصول إلى مكتبة المستخدم بالكامل، قد تحتاج إلى إعادة تقييم تطبيقك أو التفكير في طرق بديلة.

المشاركة والألبومات المشتركة

التغييرات: ستُعرِض الألبومات المشترَكة ووظائف واجهة برمجة التطبيقات المرتبطة بها (share و unshare وget وjoin وleave وlist) 403 PERMISSION_DENIED بعد 403 PERMISSION_DENIED 31 آذار (مارس) 2025.

الإجراءات التي يمكنك اتّخاذها:

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

إدارة الألبومات التي أنشأها التطبيق: التحسينات ومحتوى الألبوم

التغييرات: تتم إضافة photoslibrary.edit.appcreateddata إلى الطرق الثلاث التالية لتحقيق الاتساق الفكري:

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

الإجراءات التي يمكنك اتّخاذها:

• إذا كان تطبيقك يستخدم هذه الطرق حاليًا، ننصحك باستخدام النطاق photoslibrary.edit.appcreateddata لتبسيط عملية التفويض.

Library API: النطاقات والطُرق المتأثرة

في إطار التغييرات التي أجريناها على واجهات برمجة تطبيقات "صور Google"، أجرينا التحسينات التالية:

كما هو موضّح في صفحة التفويض المعدّلة، سيتمّ بعد 31 آذار (مارس) 2025 إزالة النطاقات التالية من Library API:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

ستبقى النطاقات التالية سارية:

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

توضِّح هذه الجداول طرق واجهة برمجة التطبيقات الخاصة بالمكتبة والنطاقات المتأثرة.

التحديثات	الطُرق	المستويات
ولا يمكن استخدام هذه الطرق الآن إلا مع الألبومات وعناصر الوسائط التي أنشأها تطبيقك.	albums.create mediaItems.batchCreate	النطاقات المتبقية: photoslibrary.appendonly النطاقات التي تمت إزالتها: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	النطاقات المتبقية: photoslibrary.readonly.appcreateddata النطاقات التي تمت إزالتها: photoslibrary photoslibrary.readonly
ولن تكون هذه الطرق متاحة بعد الآن.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	النطاقات المتبقية: بدون النطاقات التي تمت إزالتها: photoslibrary.sharing
ستتم إضافة photoslibrary.edit.appcreateddata إلى هذه الطرق. لا يمكن الآن استخدام هذه الطرق إلا مع الألبومات وعناصر الوسائط التي أنشأها تطبيقك.	albums.addEnrichment albums.batchAddMediaItems	النطاقات المتبقية: photoslibrary.appendonly photoslibrary.edit.appcreateddata النطاقات التي تمت إزالتها: photoslibrary
	albums.batchRemoveMediaItems	النطاقات المتبقية: photoslibrary.edit.appcreateddata النطاقات التي تمت إزالتها: photoslibrary
ولن تتغيّر هذه الطرق.	albums.patch mediaItems.patch	النطاقات المتبقية: photoslibrary.edit.appcreateddata النطاقات التي تمت إزالتها: بدون

تعديلات على سياسة Photos API

سيتم بعد 31 آذار (مارس) 2025 استبدال سياسة الاستخدام المقبول الحالية بسياسة مطوّري واجهة برمجة التطبيقات Photos API وبيانات مستخدميها الجديدة. تتوفّر السياسة الجديدة الآن للاطّلاع عليها.

تعديلات على مستندات Photos API

أجرينا تغييرات كبيرة على مستندات Photos API لتعكس التحديثات القادمة وتدعم تجربة التطوير:

• موقع "واجهات برمجة تطبيقات Photos" المُدمَج: لقد دمجنا جميع موارد Photos API في مكان واحد (هذا الموقع الإلكتروني)، ما يوفر تجربة سلسة للمطوّرين. يمكنك العثور على ما يلي:
  • الموارد المركزية: تعليمات الإعداد والإرشادات العامة للاستخدام، بالإضافة إلى معلومات الدعم والسياسة لكلٍّ من Picker API وLibrary API
  • مواقع إلكترونية مخصّصة لواجهات برمجة التطبيقات: مواقع إلكترونية فردية تتضمّن أدلة تفصيلية ومستندات مرجعية وعينات رموز برمجية لواجهة برمجة تطبيقات Picker ولواجهة برمجة تطبيقات Library
• محتوى Library API المعدَّل: تم تعديل مستندات Library API لتعكس إمكانات Library API بعد فترة الإيقاف نهائيًا.
• المستندات القديمة المحفوظة: احتفظنا بمستندات Library API الأصلية للمطوّرين الذين يحتاجون إلى نقل عمليات الدمج الحالية. إذا كنت بصدد بدء مشروع جديد، استخدِم المستندات المعدَّلة. إذا كنت بصدد تعديل مشروع حالي، يمكنك الرجوع إلى كل من مستندات الإصدار القديم وتلك المعدَّلة عند الحاجة أثناء عملية نقل البيانات.

الأسئلة الشائعة

ما هي التغييرات التي ستطرأ على واجهات برمجة تطبيقات "صور Google"؟

نقدّم واجهة برمجة التطبيقات Google Photos Picker API الجديدة لاختيار الصور بأمان، ونعدّل واجهة برمجة التطبيقات Library API الحالية للتركيز على إدارة الصور والفيديوهات التي ينشئها تطبيقك.

متى ستسري هذه التغييرات؟

ستسري هذه التغييرات اعتبارًا من 31 آذار (مارس) 2025. ننصحك جميع مطوّري التطبيقات الذين لديهم عمليات دمج حالية تستخدِم واجهة برمجة التطبيقات Library API لاختيار الصور بنقل بياناتهم إلى واجهة برمجة التطبيقات Picker API في أقرب وقت ممكن.

كيف ستتأثّر واجهة برمجة التطبيقات Library API؟

ستتم إزالة النطاقات photoslibrary.readonly وphotoslibrary.sharing وphotoslibrary. ستؤدي طلبات بيانات واجهة برمجة التطبيقات التي تعتمد على هذين النطاقَين فقط إلى عرض 403 PERMISSION_DENIED بعد 31 آذار (مارس) 2025. ستقتصر العديد من الطلبات الأخرى على العمل مع الصور والفيديوهات التي أنشأها تطبيقك فقط.

يمكنك مراجعة المجموعة الكاملة من التغييرات في جدول النطاقات والأساليب المتأثّرة في هذه الصفحة.

ماذا عليّ فعله إذا كان تطبيقي يستخدم حاليًا النطاقات أو الطرق المتأثرة؟

إذا كان تطبيقك يستخدم أيًا من النطاقات أو الطرق المتأثرة، ننصحك باتّباع الخطوات التالية:

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

ما هي واجهة برمجة التطبيقات Picker API في "صور Google"؟

Picker API هي طريقة جديدة وآمنة تتيح للمطوّرين السماح للمستخدمين باختيار الصور والفيديوهات من مكتبة "صور Google" وإرسالها بسلاسة إلى تطبيقك.

أين يمكنني العثور على مزيد من المعلومات عن هذه التغييرات؟

تقدّم هذه الصفحة التي تطّلع عليها حاليًا نظرة عامة وملخّصًا لجميع التغييرات.

تم تعديل باقي المستندات على موقعنا الإلكتروني لتعكس واجهات برمجة التطبيقات المعدّلة.

مشاركة المدونة هذه تعلن عن التغييرات.

ماذا لو كانت لديّ أسئلة أخرى أو كنت بحاجة إلى مساعدة في نقل بيانات تطبيقي؟

إذا كانت لديك أسئلة حول مستندات المطوّرين، يمكنك مراجعة صفحة الدعم للحصول على تفاصيل إضافية حول الحصول على المساعدة.