تاريخ النشر: أيلول (سبتمبر) 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. | النطاقات المتبقية:
|
|
النطاقات المتبقية:
|
||
لن تكون هذه الطرق متاحة بعد الآن. | النطاقات المتبقية:
|
|
ستتم إضافة photoslibrary.edit.appcreatedata إلى هذه الطرق. لا يمكن استخدام هذه الطرق الآن إلا مع الألبومات وعناصر الوسائط التي أنشأها تطبيقك. ويشمل ذلك ملفات الوسائط التي تم اختيارها من خلال واجهة برمجة التطبيقات Picker API وإضافتها إلى مكتبة المستخدم من خلال واجهة برمجة تطبيقات المكتبة. |
النطاقات المتبقية:
|
|
النطاقات المتبقية:
|
||
لن يتم إجراء أي تغيير على هاتَين الطريقتَين. | النطاقات المتبقية:
|
تعديلات على سياسة واجهة برمجة تطبيقات "صور 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.
أين يمكنني العثور على مزيد من المعلومات عن هذه التغييرات؟
تقدّم هذه الصفحة التي تشاهدها حاليًا نظرة عامة وملخصًا لجميع التغييرات.
تم تعديل بقية المستندات على موقعنا الإلكتروني للإشارة إلى لواجهات برمجة التطبيقات المحدثة.
مشاركة المدوّنة هذه الإعلان عن التغييرات.
ماذا لو كانت لديّ أسئلة أخرى أو كنت بحاجة إلى المساعدة في نقل بيانات طلبي؟
إذا كانت لديك أسئلة حول مستندات المطوِّرين، يمكنك مراجعة الدعم للاطّلاع على تفاصيل إضافية حول الحصول على المساعدة.