‏واجهة API الصفحات في فيسبوك‏

البدء

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

قبل البدء

ستحتاج إلى ما يلي:

  • صفحة فيسبوك، ويمكن أن تكون صفحة منشورة أو غير منشورة والتي يمكنك تنفيذ المهمة CREATE_CONTENT فيها.
  • رمز وصول الصفحة لهذه الصفحة
  • الأذونات التالية:
    • pages_manage_metadata
    • pages_manage_posts
    • pages_manage_read_engagement
    • pages_show_list

أفضل الممارسات

عند اختبار استدعاء API، يمكنك تضمين المعلمة access_token وتعيينها على رمز الوصول. مع ذلك، عند إجراء استدعاءات آمنة من التطبيق، استخدم فئة رمز الوصول.

الخطوة الأولى. الحصول على معرف الصفحة

للحصول على قائمة بالمعرفات ورموز وصول الصفحة الخاصة بصفحات فيسبوك التي يمكنك تنفيذ مهمة فيها، أرسل طلب GET إلى نقطة النهاية /user_id/accounts حيث يكون user_id هو معرف المستخدم الذي لديك.

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل page_id بالقيم المتوفرة لديك.
curl -i -X GET "https://graph.facebook.com/v19.0/user_id/accounts?access_token=user_access_token"

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

{
  "data": [
    {
      "access_token": "page_access_token",
      "category": "Internet Company",
      "category_list": [
        {
          "id": "2256",
          "name": "Internet Company"
        }
      ],
      "name": "Name of this Page",
      "id": "page_id",
      "tasks": [
        "ANALYZE",
        "ADVERTISE",
        "MODERATE",
        "CREATE_CONTENT"
      ]
    },
...

الخطوة الثانية. نشر منشور

لنشر منشور، أرسل طلب POST إلى نقطة النهاية /page_id/feed، حيث يكون page_id هو معرف الصفحة التي تنشر عليها، مع تعيين المعلمة message على محتوى الرسالة وتعيين المعلمة access_token على رمز وصول الصفحة:

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل page_id بالقيم المتوفرة لديك.
curl -X POST "https://graph.facebook.com/v19.0/page_id/feed" \
     -H "Content-Type: application/json" \
     -d '{
           "message":"your_message_text",
           "access_token":"page_access_token",
         }'

سيتم نشر المنشور على الفور.

عند نجاح العملية، يتلقى التطبيق استجابة JSON التالية والتي تتضمن معرف المنشور:

{
  "id": "page_post_id" 
}

تفضل بزيارة صفحة فيسبوك لعرض المنشور.

الخطوة الثالثة. التحقق من المنشور

للتحقق من نشر المنشور في الصفحة، أرسل طلب GET إلى نقطة النهاية /page_id/feed:

مثال على الطلب

تم التنسيق لإمكانية القراءة. استبدل القيم الغامقة والمائلة، مثل page_id بالقيم المتوفرة لديك.
      curl -i -X GET "https://graph.facebook.com/v19.0/page_id/feed?access_token=page_access_token"

عند نجاح العملية، سيتلقى التطبيق استجابة JSON التالية التي تتضمن مصفوفة كائنات. يتضمن كل كائن معرف المنشور ومحتوى الرسالة ووقت إنشاء المنشور:

{
  "data": [
    {
      "created_time": "2020-03-25T17:33:34+0000",
      "message": "Hello World!",
      "id": "422575694827569_917077345377399"  
    },
...
  ]
}

استخدام مستكشف Graph

أداة مستكشف Graph هي واجهة مستخدم تسمح لك بالتجربة باستخدام واجهات API في فيسبوك دون إضافة الرمز البرمجي إلى تطبيقك أو موقع الويب. ويمكنك تحديد الأذونات والحصول على رموز الوصول واختبار الأساليب GET وPOST وDELETE والحصول على أجزاء الرمز البرمجي لهذه الاستعلامات لـ Android وiOS وJavaScript وPHP وcURL.

لاحظ أنك ستحتاج إلى معرف تطبيق Facebook لاستخدام مستكشف Graph.

الخطوة الأولى. الحصول على معرف الصفحة

حدّد الأذونات pages_manage_metadata وpages_manage_posts وpages_manage_read_engagement وpages_show_list التي تظهر في القائمة المنسدلة للأذونات، وقم بتعيين طلب GET إلى نقطة النهاية /me/accounts في مربع الاستعلام وانقر على إرسال.

انقر على معرف صفحتك المعروض مباشرةً أسفل اسم صفحتك لنقل المعرف إلى مربع الاستعلام.

الخطوة الثانية. النشر كصفحة

أسفل القائمة المنسدلة مستخدم أو صفحة، حدّد رمز وصول الصفحة المرتبط بصفحتك. وبعد ذلك، قم بتعيين الأسلوب إلى POST باستخدام طلب إلى نقطة النهاية /{page-id}/feed، ثم قم بتعيين key لـ المعلمات إلى message وتعيين value إلى نص منشورك. انقر على إرسال.

وعند نجاح العملية، سيعرض مستكشف Graph معرف منشور الصفحة.

قم بزيارة صفحة فيسبوك لعرض المنشور.

الخطوة الثالثة. التحقق من المنشور

أرسل طلب GET إلى نقطة النهاية /page-id/feed.

عند نجاح العملية، سيعرض مستكشف Graph Explorer وقت إنشاء المنشور ونص المنشور ومعرف منشور الصفحة.

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

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

تعرف على كيفية نشر الروابط والصور ومقاطع الفيديو على الصفحة.

راجع أيضًا

دلائل Graph API

المراجع