الدلائل

يصف هذا الدليل الاستخدامات الشائعة لواجهة API المجموعات.

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

يمكنك إجراء عملية GET في عنصر الربط /{group-id}/feed للحصول على المنشورات لمجموعة ما.

لن يتم افتراضيًا تضمين معلومات تحديد الهوية الشخصية في الاستجابة. ولتضمين معلومات المؤلف المتوفرة للعامة في الاستجابة، يجب أن يمنحك مؤلف المنشور الإذن groups_access_member_info.

عينة من الطلب

curl -i -X GET \ 
  "https://graph.facebook.com/{group-id}/feed?limit=5&access_token=EAACEdEos0..."

عينة من الاستجابة

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

{
  "data": [
    {
      "message": "I love this group!",
      "updated_time": "2018-06-28T23:31:49+0000",
      "id": "554611227955614_1708186035931455"  //Post ID
    },
    {
      "message": "I like how linked groups look on mobile!",
      "updated_time": "2018-06-14T23:19:02+0000",
      "id": "554611227955614_1687969857953073"  //Post ID
    }
  ]
}

عينة من الاستجابة

عينة من الاستجابة حيث منح مؤلف المنشور تطبيقك الإذن groups_access_member_info.

{
  "data": [
    {
      "from": {
        "name": "Himanshu Sharma",
        "id": "512130107215"
      },
      "message": "I love this group!",
      "id": "554611227955614_1708186035931455"
    },
    {
      "from": {
        "name": "Ronak Patel",
        "id": "512130107214"
      },
      "message": "Just testing how linked groups look like on mobile!",
      "id": "554611227955614_1687969857953073"
    }
  ]
}

التقييدات

• لن تُرجع الاستدعاءات بيانات إلى من جانب المنشورات التي تم إنشاؤها خلال آخر 90 يومًا فقط.

الحصول على المستخدمين الذين يشاركون الحقول العامة

يمكنك إجراء عملية GET في عنصر الربط /{group-id}/opted_in_members للحصول على قائمة بالمستخدمين الموجودين ضمن أعضاء المجموعة الذين منحوا تطبيقك الإذن groups_access_member_info. هؤلاء هم أعضاء المجموعة الذين اختاروا مشاركة معلوماتهم المتوفرة للعامة مع التطبيقات المثبّتة في المجموعة.

عينة من الطلب

curl -i -X GET \ 
  "https://graph.facebook.com/{group-id}/opted_in_members&access_token=EAACEdEos0..."

عينة من الاستجابة

{
  "data": [
    {
      "name": "Himanshu Sharma",
      "id": "510765591715"
    },
    {
      "name": "Ronak Patel",
      "id": "410662391314"
    }
  ]
}

الحصول على أحداث Webhooks للمجموعات التي تثبت/تلغي تثبيت تطبيقك

يمكنك الاشتراك في الحقل group_installفي الكائن Application لتلقي إشعار webhook عندما يقوم أحد أعضاء المجموعة بتثبيت تطبيقك أو إلغاء تثبيته في مجموعة ما.

عينة من الإشعار

{
  "field": "group_install",
  "value": {
    "group_id": "954704787945183",
    "update_time": "1527459824",
    "verb": "add",
    "actor_id": "499619301"
  }
}