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

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

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

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

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

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

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

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

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

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

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

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

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

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

التغييرات: الألبومات المشتركة ووظائف واجهة برمجة التطبيقات المرتبطة (مشاركة إلغاء المشاركة والحصول عليها والانضمام إليها والخروج وإدراج القائمة) 403 PERMISSION_DENIED بعد 31 آذار (مارس) 2025

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

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

إدارة الألبومات التي تم إنشاؤها من خلال التطبيقات: الإضافات ومحتويات الألبوم

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

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

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

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

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

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

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

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

ستظل النطاقات التالية:

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

يوضّح هذا الجدول بالتفصيل الطرق والنطاقات المحدّدة في Library API المتأثرة.

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

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

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

تعديلات على مستندات واجهة Photos API

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

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

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

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

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

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

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

كيف سيؤثر ذلك في Library API؟

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

يمكنك مراجعة المجموعة الكاملة من التغييرات في الجدول أعلى هذه الصفحة.

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

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

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

ما هي واجهة برمجة تطبيقات أداة اختيار "صور Google"؟

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

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

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

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

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

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

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