إصدار ‏‎Graph API‎‏

Page Assigned Users

قراءة

Business and system users assigned to this page.

Requirements

A Page access token requested by a person who can perform the MANAGE task on the Page.
The pages_manage_metadata permission

If you do not own or can not perform any task on the Page, use the Page Public Content Access feature and a User access token. عند استخدام ميزة الوصول إلى المحتوى العام للصفحة، استخدم رمز وصول مستخدم النظام لتجنب مشكلات تقييد معدلات الاستدعاء.

‎Feature Permissions‎

الاسم	الوصف
الوصول إلى محتوى الصفحة العام	‎This ‎feature permission‎ may be required.‎

مثال

Graph API Explorer

GET /v21.0/{page-id}/assigned_users 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(
    '/{page-id}/assigned_users',
    '{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(
    "/{page-id}/assigned_users",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/assigned_users",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/assigned_users"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

إذا كنت تريد التعرف على كيفية استخدام واجهة Graph API، يرجى قراءة ‏دليل استخدام واجهة Graph API‏.

المعلمات

معلمة الوصف

معلمة	الوصف
`business` numeric string or integer	The business associated with this Page. Example query: `GET {page-id}/assigned_users?business={business-id}` مطلوب

business

numeric string or integer

The business associated with this Page. Example query: GET {page-id}/assigned_users?business={business-id}

مطلوب

الحقول

ستؤدي القراءة من عنصر الربط هذا إلى نتيجة بتنسيق JSON:

{
    "data": [],
    "paging": {},
    "summary": {}
}

`data`

قائمة عُقد ‏‎AssignedUser‎‏.

ستتم إضافة الحقول التالية إلى كل عقدة تمت إعادتها:

الحقل الوصف

الحقل	الوصف
`permitted_tasks` list<string>	Tasks that are assignable on this object
`tasks` list<string>	All unpacked roles/tasks of this particular user on this object افتراضي

permitted_tasks

list<string>

Tasks that are assignable on this object

tasks

list<string>

All unpacked roles/tasks of this particular user on this object

افتراضي

`paging`

لمزيد من التفاصيل عن تقسيم الصفحات، يرجى الاطلاع على ‏دليل Graph API‏.

`summary`

المعلومات المجمعة عن عنصر الربط، مثل الأعداد. يرجى تحديد الحقول المطلوب استدعاؤها في معلمة الملخص (مثل ‏summary=‏‎total_count‎‏‏).

الحقل الوصف

الحقل	الوصف
`total_count` unsigned int32	Total number of business and system users assigned to this page

total_count

unsigned int32

Total number of business and system users assigned to this page

‎Error Codes‎

خطأ	الوصف
100	Invalid parameter
190	Invalid OAuth 2.0 Access Token
368	The action attempted has been deemed abusive or is otherwise disallowed
200	Permissions error

إنشاء

لا يمكنك تنفيذ هذه العملية في نقطة النهاية هذه.

جارٍ التحديث

‎You can update a Page by making a POST request to /{page_id}/assigned_users.‎

المعلمات

معلمة الوصف

معلمة	الوصف
`tasks` array<enum {MANAGE, CREATE_CONTENT, MODERATE, MESSAGING, ADVERTISE, ANALYZE, MODERATE_COMMUNITY, MANAGE_JOBS, PAGES_MESSAGING, PAGES_MESSAGING_SUBSCRIPTIONS, READ_PAGE_MAILBOXES, VIEW_MONETIZATION_INSIGHTS, MANAGE_LEADS, PROFILE_PLUS_FULL_CONTROL, PROFILE_PLUS_MANAGE, PROFILE_PLUS_FACEBOOK_ACCESS, PROFILE_PLUS_CREATE_CONTENT, PROFILE_PLUS_MODERATE, PROFILE_PLUS_MODERATE_DELEGATE_COMMUNITY, PROFILE_PLUS_MESSAGING, PROFILE_PLUS_ADVERTISE, PROFILE_PLUS_ANALYZE, PROFILE_PLUS_REVENUE, PROFILE_PLUS_MANAGE_LEADS, CASHIER_ROLE}>	Page permission tasks to assign this user
`user` UID	Business user id or system user id مطلوب

tasks

array<enum {MANAGE, CREATE_CONTENT, MODERATE, MESSAGING, ADVERTISE, ANALYZE, MODERATE_COMMUNITY, MANAGE_JOBS, PAGES_MESSAGING, PAGES_MESSAGING_SUBSCRIPTIONS, READ_PAGE_MAILBOXES, VIEW_MONETIZATION_INSIGHTS, MANAGE_LEADS, PROFILE_PLUS_FULL_CONTROL, PROFILE_PLUS_MANAGE, PROFILE_PLUS_FACEBOOK_ACCESS, PROFILE_PLUS_CREATE_CONTENT, PROFILE_PLUS_MODERATE, PROFILE_PLUS_MODERATE_DELEGATE_COMMUNITY, PROFILE_PLUS_MESSAGING, PROFILE_PLUS_ADVERTISE, PROFILE_PLUS_ANALYZE, PROFILE_PLUS_REVENUE, PROFILE_PLUS_MANAGE_LEADS, CASHIER_ROLE}>

Page permission tasks to assign this user

user

UID

Business user id or system user id

مطلوب

‎Return Type‎

‎This endpoint supports ‎read-after-write‎ and will read the node to which you POSTed.‎

Struct {

success: bool,

}

‎Error Codes‎

خطأ	الوصف
100	Invalid parameter
200	Permissions error
368	The action attempted has been deemed abusive or is otherwise disallowed

جارٍ الحذف

‎You can dissociate a Page from a Page by making a DELETE request to /{page_id}/assigned_users.‎

Remove a business scoped user from this page. Example query: DELETE {page-id}/assigned_users?user={business-scoped-user-id}

المعلمات

معلمة الوصف

معلمة	الوصف
`user` UID	Business scoped user id مطلوب

user

UID

Business scoped user id

مطلوب

‎Return Type‎

Struct {

success: bool,

}

‎Error Codes‎

خطأ	الوصف
368	The action attempted has been deemed abusive or is otherwise disallowed
200	Permissions error
100	Invalid parameter