‏المرجع‏

المنشور

المسار /{POST-id}

يُمثِّل منشور Workplace. تعمل العقدة /{post-id} على إرجاع منشور واحد.

القراءة

تُرجِع كائن لمنشور واحد والذي يمثل منشورًا في مجموعة أو حدث أو في ملف تعريف المستخدم.

الأذونات

تتطلَّب قراءة عقدة منشور إذن قراءة محتوى من المجموعة.

الحقول

اسم الحقلالوصفالنوع

id

يمثل مُعرّف المنشور.

string

created_time

يمثل وقت نشر المنشور لأول مرة.

datetime

formatting

يشير إلى ما إذا تم إنشاء المنشور باستخدام لغة ترميز للتنسيق. تشير قيمة الإرجاع إلى لغة الترميز التي تم استخدامها. Workplace يدعم Markdown والنص العادي.

enum {MARKDOWN|PLAINTEXT}

from

يمثل معلومات حول الشخص أو الملف الشخصي الذي نشر الرسالة.

Profile

icon

يمثل رابطًا ينقلك إلى أيقونة تمثل نوع هذا المنشور.

url

link

يمثل الرابط المرفق بهذا المنشور.

url

message

يمثل رسالة الحالة في المنشور.

string

name

يمثل اسم link، إذا كان مرفقًا بالمنشور.

string

object_id

يمثل معرف أي صورة تم تحميلها أو مقطع فيديو مرفق بالمنشور.

string

permalink_url

يمثل عنوان URL لصفحة الرابط الثابت للمنشور.

url

picture

يمثل الصورة المستخلصة من أي link مضمّن مع المنشور.

url

place

يمثل أي معلومات تخص الموقع مرفقة بالمنشور.

Place

poll

إذا كان المنشور استطلاع رأي، فسيُعيد هذا الحقل كائن السؤال المرفق، مما يتيح لك رؤية options وvotes التي أعطاها المستخدمون للخيار.

Question

properties

يمثل قائمة تضم خصائص أي فيديو مرفق، على سبيل المثال، مدة الفيديو.

object[]

status_type

يمثل وصف نوع تحديث الحالة.

enum {mobile_status_update, created_note, added_photos, added_video, shared_story, created_group, created_event, wall_post, app_created_story, published_story, tagged_in_photo}

story

يمثل نصًا من قصص لم يتم إنشاؤها عن قصد من قبل المستخدمين.

string

to

يمثل الملفات الشخصية المذكورة أو المستهدفة في هذا المنشور.

Profile[]

type

يمثل سلسلة تشير إلى نوع كائن هذا المنشور.

enum{link, status, photo, video}

updated_time

يمثل وقت إنشاء المنشور أو آخر تعديل له أو وقت آخر تعليق تم تركه على المنشور.

datetime

with_tags

يمثل الملفات الشخصية التي تمت الإشارة إليها باعتبارها "مع" ناشر المنشور.

كائن JSON مع حقل data الذي يحتوي على قائمة تضم كائنات Profile.

النشر

لا يمكنك النشر باستخدام عنصر الربط هذا. لإنشاء رسالة جديدة في مجموعة، استخدم عنصر ربط /group/feed.

الحذف

يمكن حذف المنشور عبر Graph API عن طريق إنشاء طلب DELETE على المسار /{post_id}.

الأذونات

يتطلّب حذف عقدة منشور ما، إذن النشر في مجموعات وإذن قراءة كل المحتوى أو قراءة المحتوى المفتوح فقط، اعتمادًا على المجموعة التي نُشِر فيها المنشور.

التحديث

لا يمكن تحديث إلا المنشورات التي تم إنشاؤها بواسطة برنامج تلقائي، لكن لا يمكن تحديث تلك المنشورة نيابة عن مستخدم بـ impersonate_token. يمكن تحرير منشور ما عن طريق تقديم طلب POST بشأن عنصر ربط /{post-id} مع message محدّثة في المتن.

عناصر الربط

اسم عنصر الربطالوصف

/attachments

يمثل جميع مرفقات الوسائط المرتبطة بهذا المنشور.

/comments

يمثل التعليقات على هذا المنشور. يدعم حقل summary للحصول على عدد إجمالي.

/likes

يمثل الأشخاص الذين أعجبهم هذا المنشور. يدعم حقل summary للحصول على عدد إجمالي.

/reactions

يمثل الأشخاص الذين تفاعلوا مع هذا المنشور. يدعم حقل summary للحصول على عدد إجمالي.

/seen

يمثل الأشخاص الذين رأوا هذا المنشور. يدعم حقل summary للحصول على عدد إجمالي.

بناء Markdown مدعوم

بناء Markdown التالي يكون مدعومًا عند نشر منشور على Workplace:

التنسيقاتبناء الجملة

غامق

**Bold**

التأكيد

*Emphasize*

رابط

[Link](https://workplace.fb.com)

Inline code

`Inline code`
code block
``` code block ```
  • القائمة
* List
  1. قائمة مُرقمة
1. Numbered list

اقتباس

> Quote

العنوان 1

# Heading 1

العنوان 2

## Heading 2

أمثلة

الحصول على ID وsource وstory لمنشور ما

GET graph.facebook.com
  /{post-id}?fields=id,source,story

الحصول على التعليقات من منشور ما

GET graph.facebook.com
  /{post-id}/comments

الحصول على الحالة مرئي لمنشور ما، بما في ذلك ملخص العدد الإجمالي

GET graph.facebook.com
  /{post-id}/comments?
  summary=true

النشر في مجموعة

POST graph.facebook.com
  /{group-id}/feed?
  message=Hello+World&
  link=https://developers.facebook.com/docs/workplace/custom-integrations/apps

الإشارة إلى مستخدم في منشور مجموعة

POST graph.facebook.com
  /{group-id}/feed?
  message=Hi+@[100013325822531]

النشر في مجموعة باستخدام تنسيقات Markdown

POST graph.facebook.com
  /{group-id}/feed?
  message=This+is+a+**formatted**+*post*&
  formatting=MARKDOWN

اقرأ خيارات أسئلة استطلاع الرأي وقم بالتصويت على منشور استطلاع رأي، باستخدام توسيع الحقل

GET graph.facebook.com
  /{post-id}?
  fields=message,poll{options{name,vote_count,votes}}