إصدار ‏‎Graph API‎‏

المجموعة

مجموعة Facebook.

القراءة

تعرض معلومات عن كائن مجموعة فردية. للحصول على قائمة بالمجموعات التي يديرها المستخدم، استخدم عن /user/groups بدلاً من ذلك.

مستكشف Graph API
GET /v19.0/{group-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{group-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{group-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

الأذونات

  • groups_access_member_info — تتيح للتطبيق تلقي البيانات الخاصة بالأعضاء على محتوى المجموعة.
  • publish_to_groups — تتيح لتطبيقك نشر محتوى في إحدى المجموعات نيابة عن المستخدم.

للمجموعات العامة والمغلقة

رمز وصول مستخدم

للمجموعات السرية

رمز وصول مستخدم لمسؤول المجموعة

تنبيهات

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

الحقول

اسم الخاصية الوصف النوع

id

معرف المجموعة

string

cover

معلومات عن صورة غلاف المجموعة.

CoverPhoto

id

معرف الصورة التي تمثل صورة الغلاف هذه.

string

source

عنوان URL للصورة التي تمثل صورة الغلاف هذه.

string

offset_y

الإزاحة الرأسية بالبيكسل للصورة الموجودة في الجانب السفلي.

int

offset_x

الإزاحة الأفقية بالبكسل للصورة الموجودة في الجانب الأيسر.

int

description

وصف وجيز للمجموعة.

string

email

عنوان البريد الإلكتروني لتحميل المحتوى إلى المجموعة. يقتصر استخدام هذا على أعضاء المجموعة الحاليين فقط.

string

icon

عنوان URL لأيقونة المجموعة.

string

member_count

عدد الأعضاء في المجموعة.

int

member_request_count

عدد طلبات الأعضاء قيد الانتظار. يتطلب رمز الوصول لأحد مسؤولي المجموعة. لا يُعرض العدد إلا إذا تجاوز عدد طلبات الأعضاء قيد الانتظار 50.

int

name

اسم المجموعة.

string

owner

تم إيقاف الاستخدام في الإصدار 9.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من 9 فبراير 2021.

User | Page

parent

أصل هذه المجموعة، في حالة وجوده.

Group|Page

permissions

الأذونات التي يمتلكها المستخدم للتطبيق المثبت في المجموعة.

string

privacy

إعدادات الخصوصية للمجموعة. القيم الممكنة هي CLOSED وOPEN وSECRET يتطلب رمز الوصول لأحد مسؤولي المجموعة.

string

updated_time

آخر تحديث للمجموعة (بما في ذلك تغيير خصائص المجموعة والمنشورات والتعليقات). يتطلب رمز الوصول لأحد مسؤولي المجموعة.

datetime

الإنشاء

هذه العملية غير مدعومة.

التحديث

هذه العملية غير مدعومة.

الحذف

هذه العملية غير مدعومة.

عناصر الربط

الاسم الوصف

/admins

تم إيقاف استخدام عنصر الربط هذا في الرابع من أبريل 2018.

/albums

ألبومات الصور المملوكة للمجموعة.

/docs

المستندات المملوكة للمجموعة.

/events

الأحداث المملوكة للمجموعة.

/feed

أخبار المنشورات المملوكة للمجموعة.

/files

الملفات المملوكة للمجموعة.

/live_videos

مقاطع فيديو البث المباشر المملوكة للمجموعة.

/members

تم إيقاف استخدام عنصر الربط هذا في الرابع من أبريل 2018.

/photos

الصور المملوكة للمجموعة.

/videos

مقاطع الفيديو المملوكة للمجموعة.