عنوان URL /?id={url}

يمثل عنوان URL تمت مشاركته في منشور أو في تعليق على منشور.

للحصول على معلومات إضافية، يمكنك الرجوع إلى وثائق API فهرسة علامة تبويب الأخبار.

القراءة

يمكنك الحصول على معلومات حول عنوان URL تمت مشاركته في منشور أو في تعليق على منشور.

المتطلبات

التقييدات

• قيم التفاعل التي تم إرجاعها ليست دقيقة ولكنها تعكس تفاعل المستخدمين مع عنوان URL.
• يتم تقييد طلبات GET عند 10 طلبات لكل عنوان URL ولكل تطبيق في الساعة.

المعلمات

يمكن تضمين معلمات سلسلة الاستعلام التالية لتدعيم الطلب.

الحقول

الأمثلة

للحصول على معلومات حول عنوان URL تم نشره في منشور أو تعليق، أرسل طلب GET إلى https://graph.facebook.com مع تعيين المعلمة id على عنوان URL، وأي حقول حول عنوان URL ورمز الوصول الذي تم طلبه من المستخدم أو الصفحة التي نشرت المنشور أو التعليق.

يعرض المثال التالي التفاعل في عنوان URL، وهو https://www.facebook.com، الذي تمت مشاركته بواسطة المستخدم الذي يمثله رمز وصول المستخدم.

curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

عند نجاح العملية، يتلقى تطبيقك عدد تسجيلات التفاعل التالية لعنوان URL الذي تمت مشاركته:

{
  "engagement": {
    "reaction_count": 514919172,
    "comment_count": 68687082,
    "share_count": 975739682,
    "comment_plugin_count": 1641
  },
  "id": "https://www.facebook.com"
}

الإنشاء

لا يمكنك إجراء تلك العملية على نقطة النهاية هذه.

التحديث

يمكنك تحديث عنوان URL.

المتطلبات

الأمثلة

للحصول على معلومات حول عنوان URL تم نشره في منشور أو تعليق، أرسل طلب POST إلى https://graph.facebook.com مع تعيين المعلمة id على عنوان URL، وتعيين المعلمة scrape على true، وأي fields حول عنوان URL ورمز الوصول الذي تم طلبه من المستخدم أو الصفحة التي نشرت المنشور أو التعليق.

يعمل المثال التالي على تحديث عنوان URL، وهو https://www.facebook.com/my-update الذي تمت مشاركته بواسطة المستخدم الذي يمثله رمز وصول المستخدم.

curl -i -X POST \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com/my-update
    &scrape=true
    &access_token={user-access-token}"

عند نجاح العملية، يتلقى تطبيقك عدد تسجيلات التفاعل التالية لعنوان URL الذي تمت مشاركته:

{
  "success": true
}  

معلمات سلسلة الاستعلام

يمكن تضمين معلمات سلسلة الاستعلام التالية لدعم الطلب.

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

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

مثال على الاستجابة

{
  "success": true
}

الحذف

لا يمكنك إجراء تلك العملية على نقطة النهاية هذه.