التغيير القادم بشأن إيقاف استخدام إصدار API التسويق لتمكين الترقية التلقائية للإصدار

١٦ أبريل ٢٠٢٤بواسطة‏‎Mengxuan Zhang‎‏

لتحسين تجربة API الشاملة من خلال جعلها أكثر سلاسة وفعالية، يسعدنا أن نعلن عن الطرح القادم لميزة الترقية التلقائية لإصدار MAPI. بدءًا من مايو 2024، سنعمل على تمكين ميزة الترقية التلقائية للإصدار لنقاط نهاية API التسويق التي لم تتأثر بين الإصدارات. هذا يعني أنه بين الإصدار المقرر إيقاف استخدامه والإصدار التالي المتوفر، إذا لم تتأثر نقطة النهاية، فستعمل المنصة على ترقية الاستدعاء تلقائيًا إلى الإصدار التالي المتوفر، بدلاً من التسبب في فشل الطلب مباشرةً.

تعيين إصدارات API هو طريقة شائعة لمعالجة التغييرات في API، ويتم استخدامها بشكل أكثر شيوعًا لطرح التغييرات الطارئة. عندما يتم طرح إصدارات جديدة، يتم إيقاف استخدام الإصدارات القديمة. أثناء إيقاف استخدام إصدار API، إذا كان التطبيق يعمل على استدعاء إصدار API تم إيقاف استخدامه، فسيتلقى الخطأ "(#2635) أنت تستدعي إصدار تم إيقاف استخدامه لـ API الإعلانات. يُرجى التحديث إلى أحدث إصدار: الإصدار XXX".

في 14 مايو 2024، سيتم إيقاف استخدام الإصدار 17.0. وفقًا لسجل تغييرات الإصدار 18.0، ستتأثر نقاط النهاية التالية:

POST /act_{ad-account-id}/reachfrequencypredictions
GET /act_{ad-account-id}/reachestimate
GET /act_{ad-account-id}/delivery_estimate
POST /act_{ad-account-id}/adsets
POST /{adset-id}
POST /act_{ad-account-id}/saved_audiences
POST /{saved-audience-id}
POST /act_{ad-account-id}/credit_cards

إذا قام التطبيق باستدعاء POST /{adset-id} من خلال الإصدار 17.0 بعد إيقاف استخدامه في 14 مايو 2024، فسيفشل طلب api هذا حيث إنه لم يتم تطبيق الترقية التلقائية على نقاط النهاية المتأثرة في الإصدار 18.0 التالي المتوفر.

إذا قام التطبيق باستدعاء GET /{ad-account-id}/insights من خلال الإصدار 17.0 بعد إيقاف استخدامه، فستعمل المنصة على ترقية الاستدعاء إلى الإصدار 18.0 التالي المتوفر.

إذا كان التطبيق يعمل بالفعل على إجراء استدعاءات من خلال إصدارات أحدث من الإصدار 17.0، فلن يتغير شيء في تاريخ إيقاف استخدام الإصدار.

للإلغاء الاشتراك في الترقية التلقائية للإصدار، يُرجى التحقق من "الإعدادات" > "إعدادات إصدار API الإعلانات" ضمن بطاقة "منتج تطبيق API التسويق" لتعطيل هذه الميزة.

لتأكيد ما إذا تمت ترقية الاستدعاء تلقائيًا، يُرجى التحقق من عنوان استجابة API لمزيد من التفاصيل.