المجموعة

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

يمثل مجموعة Workplace. تعمل العقدة /{group-id} على إرجاع مجموعة فردية.

المجموعات متعددة الشركات

هناك اعتبارات محددة يجب مراعاتها عند الوصول إلى المجموعات متعددة الشركات:

• يمكن قراءة محتوى المجموعة بواسطة أي تطبيق دمج مثبت في شركة تُعد جزءًا من مجموعة متعددة الشركات
• يتم إدراج المجموعات متعددة الشركات في المجتمعات أو المجموعات إلى جانب المجموعات العادية

  • يمكن استخدام حقل الغرض لتحديد المجموعات متعددة الشركات. ويمكن تعيين هذه القيمة على WORK_MULTI_COMPANY
• يمكن أيضًا الاستعلام عن أعضاء المجموعة، ولكن لن يتم عرض سوى id وname وpicture إذا كان التطبيق تابعًا إلى شركة مختلفة عن الشركة التي ينتمي إليها المستخدم
• يمكن لعمليات الدمج التي تحتوي على إذن إدارة المجموعة إضافة أعضاء المجموعات متعددة الشركات وإزالتهم

  • لا يمكن لعمليات الدمج سوى إضافة المستخدمين الذين هم أعضاء في المجتمع الذي تم تثبيت الدمج عليه وإزالتهم
  • لا يمكن لعمليات الدمج إضافة المستخدمين وإزالتهم إلا عندما يكون أحد مسؤولي المجموعة عضوًا في المجتمع الذي يتم تثبيت الدمج عليه
• يمكن لعملية الدمج التي تحتوي على إذن إدارة محتوى المجموعة حذف المحتوى الموجود داخل مجموعة متعددة الشركات محددة إذا توفر ما يلي:

  • كان المحتوى ينتمي إلى أحد أعضاء مجتمع التطبيق أو
  • كان عضو مجتمع التطبيق هو مسؤول المجموعة
• لا تتوفر إمكانية النشر في مجموعات متعددة الشركات حاليًا
• يمكن تحديد المجموعات متعددة الشركات في إعداد نطاق المجموعة لعمليات الدمج
• لا يمكن تنفيذ عمليات ذكر البرامج التلقائية في المجموعات متعددة الشركات

القراءة

يمكنك قراءة معلومات حول أي مجموعة من خلال إجراء طلب GET في واجهة Graph API إلى /{group-id}.

الأذونات

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

الحقول

النشر

لا يمكنك النشر باستخدام عنصر الربط هذا. لإنشاء مجموعة، قم بنشرها على عنصر الربط /community/groups.

الحذف

لا يمكنك حذف مجموعة باستخدام هذه العقدة. ستؤدي إزالة آخر عضو في المجموعة إلى حذف تلك المجموعة تلقائيًا.

التحديث

يمكنك تحديث المجموعة عن طريق إجراء طلب POST في واجهة Graph API إلى /{group-id} وإدخال قيم الحقول التي سيتم تحديثها في نص الطلب.

الأذونات

يتطلب إجراء التحديثات على عقدة المجموعة الحصول على إذن إدارة المجموعات.

عناصر الربط

أمثلة

الحصول على معرف المجموعة واسمها وحالة الأرشفة والخصوصية:

GET graph.facebook.com
  /{group-id}?fields=id,name,archived,privacy

أرشفة مجموعة:

POST graph.facebook.com
  /{group-id}?archive=true

الحصول على أعضاء المجموعة بالاسم والمعرف وتاريخ الانضمام:

GET graph.facebook.com
  /{group-id}/members?fields=name,id,joined

الحصول على مسؤولي ومشرفي المجموعة ضمن استدعاء واحد:

GET graph.facebook.com
  /{group-id}?fields=admins,moderators

الحصول على مستندات المجموعة:

GET graph.facebook.com
  /{group-id}/docs

الحصول على منشورات المجموعة:

GET graph.facebook.com
  /{group-id}/feed

الحصول على منشورات المجموعة بآخر ترتيب محدّث:

GET graph.facebook.com
  /{group-id}/feed?sorting_setting=RECENT_ACTIVITY

المعلمات

sorting_setting

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

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

GET graph.facebook.com
  /{group-id}/feed?fields=attachments

الحصول على قائمة بأعضاء المجموعة، بجانب تاريخ الانضمام:

GET graph.facebook.com
  /{group-id}/members?fields=name,joined

إضافة عضو للمجموعة عن طريق المعرف:

POST graph.facebook.com
  /{group-id}/members/{member-id}

إضافة عضو لأي مجموعة بالبريد الإلكتروني:

POST graph.facebook.com
  /{group-id}/members?email=michael%40example.com

إزالة عضو من المجموعة عن طريق المعرف:

DELETE graph.facebook.com
  /{group-id}/members/{member-id}

إزالة عضو من المجموعة بالبريد الإلكتروني:

DELETE graph.facebook.com
  /{group-id}/members?email=michael%40example.com

ترقية عضو إلى مسؤول عن المجموعة:

POST graph.facebook.com
  /{group-id}/admins/{user-id}

خفض تصنيف أي مسؤول إلى عضو في المجموعة:

DELETE graph.facebook.com
  /{group-id}/admins/{user-id}

إنشاء مناسبة جديدة في مجموعة:

POST graph.facebook.com
  /{group-id}/events
  ?name=New+Event
  &start_time=2017-03-02T14:00:04+00:00
  &end_time=2017-03-02T15:00:04+00:00
  &description=Test+Description
  &location=Boardroom

تحميل صورة جديدة (عبر binary) إلى مجموعة:

POST graph.facebook.com
  /{group-id}/photos?source={image-data}

تحميل صورة جديدة (عبر عنوان url) إلى مجموعة:

POST graph.facebook.com
  /{group-id}/photos?url={image-data}

إنشاء منشورات المجموعة مع مرفقات الصور ومقاطع الفيديو:

POST graph.facebook.com
  /{group-id}/feed?attached_media=[{"media_fbid":"{photo-id}"},{"media_fbid":"{photo-id}"}]

المعلمات

attached_media

تُستخدم للصور ومقاطع الفيديو، مصفوفة من media_fbids المحاطة بأقواس. وتدعم تنسيقات الصور التالية: .jpeg، .bmp، .png، .gif، .tiff. يمكن العثور على المزيد من المعلومات حول تنسيقات الصور هنا. يمكن العثور على ملفات الفيديو المدعومة هنا. للحصول على media_fbids للصور، يُرجى نشر الصور غير المنشورة على https://graph.facebook.com/me/photos أولاً، كما هو موضح في الوثائق هنا. للحصول على media_fbids لمقاطع الفيديو (بما في ذلك صور GIF المتحركة)، يُرجى نشر مقاطع الفيديو أولاً على https://graph.facebook.com/me/videos?no_story=true.

إنشاء منشورات المجموعة مع مرفقات الملفات:

POST graph.facebook.com
  /{group-id}/feed?files=[{file-id},{file-id}]

المعلمات

files

تُستخدم للملفات، مصفوفة من file_ids، (لاحظ أنها غير محاطة بالأقواس). تعيين إصدار الملفات غير مدعوم حاليًا. ولتحديث الملفات، يُرجى إزالة الملف الأصلي من مرفقات المنشورات وإعادة تحميل مرفق ملف جديد. تدعم تنسيقات الملفات التالية:

• المستندات: .pdf و.csv و.tsv و.docx و.pptx و.xlsx
• الصور: .jpeg و.png
• مقاطع الفيديو: .mp4
• الأرشيفات: .rar و.zip

للحصول على file_ids، يُرجى نشر الملفات على https://graph.facebook.com/group_file_revisions أولاً. يمكنك نشر ملفات المصدر محليًا من جهاز الكمبيوتر لديك.

تحديث أذونات النشر وإعدادات الانضمام والغرض وإعدادات الموافقة على المنشورات

POST graph.facebook.com
  /{group-id}/?post_permissions=NONE&join_setting=ADMIN_ONLY&purpose=WORK_SOCIAL&post_requires_admin_approval=false

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

GET graph.facebook.com
  /{group-id}/pinned_posts?fields=reactions,comments

تحديد ما إذا كانت المجموعة تمثل مجتمعًا أيضًا

GET graph.facebook.com
  /{group-id}?fields=is_community

احصل على قواعد العضوية في مجموعة محددة

GET graph.facebook.com
  /{group-id}/auto_membership_rules

عينة من الاستجابة (JSON):

{
  "data": [
    {
      "conditions": [
        {
          "field": "TITLE",
          "operator": "CONTAINS",
          "values": [
            "sales"
          ]
        }
      ],
      "id": RULE_ID
    }
  ],
  ...
}

حذف قاعدة العضوية التلقائية لمجموعة محددة

DELETE graph.facebook.com
  /RULE_ID

تطبيق قاعدة العضوية على مجموعة محددة

POST graph.facebook.com
  /{group-id}/auto_membership_rules

مثال على حمولة البيانات:

{
    "conditions": [
        {
            "field": "LOCATION",
            "operator": "CONTAINS",
            "values": ["London", "San Francisco"]
        }
    ]
  }

الحصول على معرف المجموعة وحالة المجموعة الرسمية:

GET graph.facebook.com
  /{group-id}?fields=id,is_official_group

تحديث حالة المجموعة الرسمية:

POST graph.facebook.com
  /{group-id?is_official_group={FALSE | TRUE}