‏‎Graph API‎‏

الترقية إلى أحدث إصدار لواجهة Graph API

يوضح هذا الدليل كيفية إعداد تطبيقك لاختبار الإصدارات المختلفة من واجهة Graph API والترقية إلى أحدث إصدار.

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

تعرف على كيفية تأثير التغيير على تطبيقك

تعرض أداة ترقية واجهة API قائمة مخصصة من التغييرات التي تؤثر على التطبيق عند الترقية إلى إصدار مستهدف محدد. ويسمح لك ذلك بعرض جميع التغييرات ذات الصلة بين الإصدار المصدر والهدف.

الخطوة الأولى. في أداة الترقية، حدد تطبيقك من القائمة المنسدلة أو اكتب اسم التطبيق.

تعرض القائمة المنسدلة ما يصل إلى عشرة تطبيقات فقط. ولعرض المزيد من التطبيقات بخلاف التطبيقات المُدرجة، استخدم شريط البحث الموجود في القائمة المنسدلة.

الخطوة الثانية. استخدم القوائم المنسدلة على اليسار لتحديد الإصدار الذي تريد الترقية منه والإصدار الذي تريد الترقية إليه.

الاطلاع على النتائج

تعرض الأداة عدد التغييرات التي يجب إجراؤها لتحديث تطبيقك إلى الإصدار المحدد. إذا كان تطبيقك يُجري استدعاءات واجهة API لن تتأثر بالإصدار الجديد، فلن يتم إرجاع أي بيانات.

يتم ترميز الأساليب بالألوان حسب الإصدار الذي يؤثر على الاستدعاء. مرر مؤشر الماوس فوق المخطط الشريطي لعرض عدد التغييرات في كل إصدار. تشير التواريخ المرتبطة بكل إصدار إلى موعد فرض التغييرات على كل التطبيقات.

يعرض الجدول نوع التغيير (إيقاف الاستخدام أو ميزة جديدة أو تغيير) والأساليب المتأثرة بذلك وعدد الاستدعاءات التي تم إجراؤها خلال آخر 7 أيام والنسبة المئوية لاستدعاءات واجهة API المتأثرة بهذا التغيير على وجه التحديد.

التقييدات

  • يجب أن تتمتع بدور مسؤول أو مطوّر في التطبيق حتى تتمكّن من عرض التطبيق في الأداة.
  • لن يتم إرجاع البيانات إذا لم يجر تطبيقك أي استدعاءات لواجهة API، سواء كانت كثيرة أو قليلة، من الإصدار الذي تمت الترقية منه.
  • قد تكون أحجام الاستدعاءات غير صحيحة. ويتم أخذ عينات من تسجيل استدعاء واجهة API وتجميعها على مدار الأسبوع السابق. وتتم مقارنتها بحجم الاستدعاءات لتقدير عدد الاستدعاءات التي قد تتأثر بإجراء تغيير على إصدار محدد.

ملاحظة: قد لا تؤثر كل التغييرات على كل استدعاءات واجهة API. واستخدم أفضل تقدير لك بشأن تحديد ما إذا كان يجب التعامل مع تغيير معين بواسطة تطبيقك أم لا. واحرص على اختبار استدعاءات واجهة API في الإصدار الجديد للتأكد من عملها بشكل صحيح.

تنفيذ إصدار جديد

في لوحة معلومات التطبيق الإعدادات > إعدادات متقدمة، مرّر إلى القسم ترقية إصدار واجهة API.

ترقية المطوّرين والمسؤولين

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

ترقية جميع عمليات الاستدعاء

يعمل هذا على ترقية جميع عمليات الاستدعاء التي يجريها تطبيق ما إلى الإصدار التالي المتوفر. وتعتبر الترقية المبكرة مفيدة لأنها تحافظ على خيار الرجوع إلى الإصدار الأصلي في حالة وجود أخطاء أو مشكلات غير متوقعة.

معرفة المزيد