نظرة عامة
واجهة API التسويق هي واجهة API تستند إلى بروتوكول HTTP يمكنك استخدامها للاستعلام عن البيانات بطريقة برمجية وإنشاء الإعلانات وإدارتها وتنفيذ مجموعة متنوعة من المهام الأخرى على نطاق واسع. يتناول هذا القسم معلومات عامة حول واجهات API التسويق وإمكانية الوصول وتعيين الإصدارات وغير ذلك المزيد.
نظرًا إلى أن API تستند إلى بروتوكول HTTP، فإنها تعمل مع أي لغة برمجية أو برنامج يدعم بروتوكول HTTP، بما في ذلك cURL وجميع متصفحات الويب الحديثة تقريبًا. تستند طريقة عمل API التسويق إلى Graph API من Meta، لذلك يجب إدخال جميع الطلبات تقريبًا في عنوان URL المضيف لدى graph.facebook.com.
المفاهيم الأساسية
المفاهيم التي يجب عليك معرفتها لاستخدام API التسويق:
بنية الحملة الإعلانية
تنظم Meta الإعلانات ضمن بنية مكونة من ثلاثة مستويات: الحملة الإعلانية والمجموعة الإعلانية والإعلان. في API، يمكن للمطوّرين الوصول إلى مستوى رابع يُعرف بالتصميم.
التصريح
للوصول إلى نقاط نهاية API التسويق، يجب على التطبيق إلغاء ربط عدة طبقات من تصريح واجهة Graph API.
المصادقة
تعرف على كيفية الحصول على رمز الوصول الذي تحتاج إليه لإجراء استدعاءات واجهة API، وتخزينه.
تقييد معدلات الاستدعاء
تحتوي واجهة API التسويق على منطق تقييد معدلات الاستدعاء الخاص بها ويتم استثنائها من كل تقييدات معدلات الاستدعاء في واجهة Graph API.
تعيين الإصدارات
تتضمن منصة Meta نموذجًا أساسيًا وموسّعًا لتعيين الإصدارات. تعرف على المزيد حول عمليات التغيير وعمليات الإيقاف القادمة من خلال استخدام أنظمتنا الخاصة بتعيين الإصدارات والترحيل. يمكنك الرجوع إلى الجداول الزمنية للإصدارات وعمليات الترحيل وسجل التغييرات.
مراجعة التطبيقات
لاستخدام API التسويق، يجب أن يخضع تطبيقك لعملية مراجعة التطبيقات، مع بعض الاستثناءات في API من جانب الخادم والتحويلات بلا اتصال.
الأذونات
يوجد نوعان من أذونات الإعلانات الرئيسية وهما: ads_management وads_read. يجب منح الأذونات إلى التطبيق الذي تستخدمه لإجراء الاستدعاءات. ويمكن طلب الحصول على الأذونات أثناء عملية مراجعة التطبيقات. يمكنك الرجوع إلى قائمة بالأذونات المتوفرة لتطبيقات الأعمال.
رموز الأخطاء
قد تظهر رموز الأخطاء أثناء استخدام واجهة API. استخدم هذا كمرجع للتعرف على المزيد حول كل رمز خطأ.
مرحلة ما بعد المعالجة
يمكنك التعرف على مرحلة ما بعد المعالجة بعد تلقي طلب من Meta.