‏‎Workplace‎‏

Post

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

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

القراءة

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

الأذونات

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

الحقول

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

id

معرف المنشور، باستخدام التنسيق {group-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

إذا كان المنشور استطلاع رأي، فسيعمل هذا الحقل على إرجاع الكائن Question المرتبط، مما يسمح لك بمراجعة 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

النشر

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

الحذف

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

الأذونات

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

يتطلب حذف المنشور من صفحة يوميات المستخدم إذن إدارة يوميات المستخدم.

التحديث

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

عناصر الربط

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

/attachments

كل مرفقات الوسائط المرتبطة بهذا المنشور.

/comments

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

/reactions

الأشخاص الذين تفاعلوا على هذا المنشور. يدعم الحقل summary للحصول على إجمالي العدد. يدعم الحقلين since=unix_timstamp وuntil=unix_timestamp للحصول على عدد التفاعلات في إطار زمني.

/seen

الأشخاص الذين شاهدوا هذا المنشور. يدعم الحقل summary للحصول على إجمالي العدد. يدعم الحقلين since=unix_timstamp وuntil=unix_timestamp للحصول على عدد المشاهدات ضمن إطار زمني معين.


لاحظ أن هذا يخضع للتقييدات ذاتها الموضحة هنا

بنية 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
  /{group-id}_{post-id}/seen?
  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}}

حذف منشور

DELETE graph.facebook.com
  /{post-id}

Reactions/SeenBy ضمن إطار زمني معين

GET graph.facebook.com
  /{post-id}/seen?
        since=1577836800&
        until=1593561600