نظرة عامة

تُعد واجهة API الصفحات مجموعة من نقاط نهاية واجهة Graph API في فيسبوك التي يمكن للتطبيقات استخدامها لإنشاء إعدادات ومحتوى الصفحة وإدارتها.

المكونات

رموز الوصول

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

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

Graph API

إذا لم تكن على دراية بـ Graph API، فيُرجى قراءة وثائق Graph API قبل المتابعة للتعرف على المزيد حول مخطط التواصل الاجتماعي من Meta.

تسجيل دخول فيسبوك

يسمح تسجيل دخول فيسبوك لمستخدمي التطبيق بتسجيل الدخول إلى التطبيق وكذلك للتطبيق بطلب الأذونات من المستخدمين للوصول إلى البيانات.

تسجيل دخول فيسبوك للأعمال

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

الميزات

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

عمليات الذِكر

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

معرفات المستخدم على مستوى الصفحة

يتم تحديد المستخدمين الذين يتفاعلون مع الصفحات من خلال معرفات المستخدم على مستوى الصفحة (PSID). تُعد المعرفات على مستوى الصفحة معرفات فريدة لكل زوج من المستخدم والصفحة. تستند نقاط نهاية واجهة API الصفحات ومنصة Messenger إلى المعرفات على مستوى الصفحة لتحديد تفاعلات مستخدم ما مع الصفحة، بالإضافة إلى محادثات المستخدم العامة في Messenger مع تلك الصفحة.

الأذونات

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

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

البحث عن الصفحة

يمكنك البحث عن معلومات حول صفحات فيسبوك بما في ذلك الأسماء والمواقع ويمكنك البحث عن الصفحات لإجراء @الذكر ومواقع الصفحات ويمكنك الإشارة إلى صفحة لعرض محتوى مرتبط بعلامة تجارية.

تقييدات معدلات الاستدعاء

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

المهام

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

يمكنك الموافقة على المستخدمين الفرديين بالنسبة للمهام التالية:

إذا تم منح الشخص إمكانية وصول المسؤول لصفحة ما في واجهة المستخدم، فيمكن لذلك الشخص إجراء كل المهام في تلك الصفحة.

منصة Messenger

إجراء محادثات على Messenger مع عملائك أو الأشخاص المهتمين بصفحتك على فيسبوك.

أحداث Webhooks من Meta للصفحات

احصل على الإشعارات الفورية عندما يعلق مستخدم على منشور صفحة أو يتفاعل على منشور صفحة.

مراجعة التطبيقات

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

بإمكان التطبيقات في وضع التطوير طلب أي إذن من أي مستخدم تطبيق لديه دور في التطبيق.

طريقة العمل

فيما يلي الدفق الأساسي للوصول إلى واجهة API الصفحات:

1. احصل على رمز وصول المستخدم من تطبيق المستخدم عبر تسجيل دخول فيسبوك.
2. استعلم عن نقطة النهاية /me/accounts واحصل على المعرف ورمز وصول الصفحة المرتبط بالصفحة التي سمح مستخدم التطبيق لتطبيقك بالوصول إليها.
3. احتفظ بمعرف الصفحة ورمز وصول الصفحة اللذين تم إرجاعهما.
4. استخدم المعرف والرمز للاستعلام عن عقدة الصفحة.

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

الخطوات التالية

اتبع دليل بدء الاستخدام للتعرف على كيفية نشر منشور صفحة باستخدام واجهة API الصفحات.

راجع أيضًا