تصريح

للوصول إلى نقاط نهاية واجهة API التسويق، يجب على التطبيق إلغاء ربط عدة طبقات من تصريح واجهة Graph API.

الطبقة الأولى: أنواع التطبيقات

عند إنشاء تطبيق على Facebook، ستتم مطالبتك بتوضيح كيفية استخدام هذا التطبيق. علمًا بأن التحديد الذي تختاره سيوضح نوع التطبيق: نشاط تجاري أو ممارسة ألعاب الفيديو أو بلا. راجع أنواع التطبيقات.

للوصول إلى نقاط نهاية واجهة API التسويق، يتعين عليك إنشاء تطبيق نشاط تجاري. راجع المنتجات المتوفرة لتطبيقات الأنشطة التجارية.

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

الطبقة الثانية: مستويات الوصول والأذونات والميزات

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

مستويات الوصول

مستوى الوصول	الوصف
الوصول القياسي	يتم اعتماد تطبيقات الأنشطة التجارية تلقائيًا للحصول على وصول قياسي بالنسبة لكل الأذونات والميزات المتوفرة لنوع تطبيق النشاط التجاري. يمكنك استخدام هذا الخيار إذا كنت تبدأ في الاستخدام. كما يمكنك إنشاء عمليات دفق شاملة قبل طلب الأذونات كاملة. ويمكنك الوصول إلى عدد غير محدود من الحسابات الإعلانية. قد لا تتوفر بعض استدعاءات واجهة API باستخدام الوصول القياسي نظرًا لأنها قد تنتمي إلى عدة حسابات أو لأنه لا يمكن تحديد الحساب المتأثر بطريقة برمجية.
الوصول المتقدم	يجب اعتماد الوصول المتقدم من خلال عملية مراجعة التطبيقات على أساس إذن وميزة فرديين. لطلب الوصول المتقدم، انتقل إلى لوحة معلومات تطبيقك وانقر على مراجعة التطبيقات > الأذونات والميزات. ابحث عن الإذن أو الميزة التي تريد الوصول إليها، وضمن إجراء، انقر على طلب الوصول المتقدم. كما يمكنك تحديد ميزة واحدة أو أكثر. وبمجرد تحديد الخيارات، انقر على متابعة الطلب وستنتقل إلى شاشة ترشدك خلال عملية التقديم. بعد إرسال معلوماتك، يستجيب Facebook للطلب إما بالقبول أو الرفض مع توفير المعلومات إذا كان تطبيقك غير مؤهل للوصول القياسي. وإذا تم اعتمادك للوصول المتقدم، فستحتاج إلى إكمال ما يلي للاحتفاظ بحالتك: إجراء ما لا يقل عن 1500 عملية استدعاء لواجهة API التسويق خلال آخر 15 يومًا بنجاح. إجراء عمليات استدعاء لواجهة API التسويق بمعدل خطأ أقل من 10% في آخر 15 يومًا.

مستوى الوصول

الوصف

الوصول القياسي

يتم اعتماد تطبيقات الأنشطة التجارية تلقائيًا للحصول على وصول قياسي بالنسبة لكل الأذونات والميزات المتوفرة لنوع تطبيق النشاط التجاري.

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

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

الوصول المتقدم

يجب اعتماد الوصول المتقدم من خلال عملية مراجعة التطبيقات على أساس إذن وميزة فرديين.

لطلب الوصول المتقدم، انتقل إلى لوحة معلومات تطبيقك وانقر على مراجعة التطبيقات > الأذونات والميزات.

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

بعد إرسال معلوماتك، يستجيب Facebook للطلب إما بالقبول أو الرفض مع توفير المعلومات إذا كان تطبيقك غير مؤهل للوصول القياسي.

وإذا تم اعتمادك للوصول المتقدم، فستحتاج إلى إكمال ما يلي للاحتفاظ بحالتك:

إجراء ما لا يقل عن 1500 عملية استدعاء لواجهة API التسويق خلال آخر 15 يومًا بنجاح.
إجراء عمليات استدعاء لواجهة API التسويق بمعدل خطأ أقل من 10% في آخر 15 يومًا.

يتم فرض تقييدات على كل مستوى، يمكنك الرجوع إلى الميزات ومستويات الوصول. ويجب أيضًا على كل المطوّرين اتباع كل شروط منصة Facebook وسياسات المطوّرين. ويتم إجراء الاستدعاءات على أي مستوى وصول مقابل بيانات الإنتاج.

للتحقق من مستوى الوصول الحالي، انتقل إلى لوحة معلومات التطبيق > مراجعة التطبيقات > الأذونات والميزات.

الأذونات والميزات

تتغير الأذونات التي يجب عليك طلبها بناءً على واجهة API التي تريد الوصول إليها.

إذا كان تطبيقك يدير حسابك الإعلاني فقط، فسيكون توفير الوصول القياسي والإذنين ads_read وads_management كافيًا. وإذا كان تطبيقك يدير الحسابات الإعلانية لأشخاص آخرين، فستحتاج إلى توفير الوصول المتقدم والإذنين ads_read و/أو ads_management. يمكنك الرجوع إلى كل الأذونات المتوفرة لتطبيقات الأنشطة التجارية.

تتغير الميزات التي يجب عليك طلبها بناءً على الطريقة التي تريد اتباعها عند استخدام واجهات API لدينا. وإذا كنت تدير الإعلانات، فإن إحدى الميزات الشائعة التي يجب طلبها هي Ads Management Standard Access. يمكنك الرجوع إلى كل الميزات المتوفرة لتطبيقات الأنشطة التجارية.

للحصول على صلاحية Advanced Access للوصول القياسي لإدارة الإعلانات، يحتاج تطبيقك إلى استيفاء المتطلبات التالية:

إجراء ما لا يقل عن 1500 عملية استدعاء لـ API التسويق خلال آخر 15 يومًا بنجاح.
إجراء عمليات استدعاء لـ API التسويق بمعدل خطأ أقل من 10% في آخر 15 يومًا.

إذا كنت تدير إعلانات أحد الأشخاص، فيمكنك استخدام المعلمة scope لمطالبة شخص ما بالحصول على الأذونات ads_management أو ads_read. ويحصل تطبيقك على الوصول عندما ينقر شخص ما على السماح:

https://www.facebook.com/v19.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

عند إدخال الحقل YOUR_URL، يمكنك وضع / كعلامة لاحقة. المثال: http://www.facebook.com/

أمثلة

حالة الاستخدام	الطلب
عندما تريد قراءة وإدارة الإعلانات الخاصة بالحسابات الإعلانية التي تملكها أو التي تم منحك إمكانية الوصول إليها من قبل مالكي هذه الحسابات الإعلانية.	الإذن: `ads_management` الميزة: `Ads Management Standard Access`
عندما تريد قراءة تقارير الإعلانات الخاصة بالحسابات الإعلانية التي تملكها أو التي تم منحك إمكانية الوصول إليها من قبل مالكي هذه الحسابات الإعلانية.	الإذن: `ads_read` الميزة: `Ads Management Standard Access`
عندما تريد سحب تقارير الإعلانات من مجموعة من العملاء وقراءة الإعلانات وإدارتها من مجموعة أخرى من العملاء.	الإذنان: `ads_management` و`ads_read` الميزة: `Ads Management Standard Access`

الميزات ومستويات الوصول

يعرض الجدول أدناه مدى تأثير مستويات الوصول القياسي والمتقدم على ميزة الوصول القياسي لإدارة الإعلانات.

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

مستويات الوصول مقابل الوصول القياسي لإدارة الإعلانات

تحتوي أذونات وميزات التطبيقات على مستويين مختلفين من مستويات الوصول وهما: الوصول القياسي والوصول المتقدم. يُرجى ملاحظة أن استخدام مصطلح "الوصول القياسي" هنا لا يرتبط بميزة الوصول القياسي لإدارة الإعلانات. ولا تزال صلاحية Advanced Access للوصول القياسي لإدارة الإعلانات تتطلب أن يخضع التطبيق لعملية المراجعة للحصول على صلاحية الوصول إلى الميزة.

الطبقة الثالثة: التحقق من النشاط التجاري

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