Phiên bản API Đồ thị

Users or Pages Blocked from a Page

This edge is for managing the set of people or pages blocked from a page. All of these methods require a Page Access Token.

Đọc

Returns a list of people who have been blocked from the Page

New Page Experience

This endpoint is supported for New Page Experience.

Ví dụ

Graph API Explorer
GET /v19.0/{page-id}/blocked 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}/blocked',
    '{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}/blocked",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/blocked",
    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}/blocked"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Nếu bạn muốn tìm hiểu cách sử dụng API Đồ thị, hãy đọc Hướng dẫn sử dụng API Đồ thị của chúng tôi.

Thông số

Thông sốMô tả
uid
int

The ID for the person who has been blocked from the Page

user
int

The person who has been blocked from the Page

Trường

Đọc từ cạnh này sẽ trả về một kết quả JSON đã định dạng:

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

data

Danh sách nút Profile.

paging

Để biết thêm chi tiết về chia trang, hãy xem hướng dẫn về API Đồ thị.

Mã lỗi

LỗiMô tả
210User not visible
100Invalid parameter
190Invalid OAuth 2.0 Access Token
200Permissions error
283That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata

Tạo

Bạn có thể tạo yêu cầu POST đến cạnh blocked từ các đường dẫn sau:
When posting to this edge, no Graph object will be created.

Thông số

Thông sốMô tả
asid
list<numeric string or integer>

List of App Scoped User IDs to block

psid
array<UID>

List of Page Scoped User IDs to block

uid
list<numeric string or integer>

Deprecated. Same as user

user
list<numeric string or integer>

List of User or Page IDs to block. This or uid is required

Kiểu trả về

Điểm cuối này hỗ trợ đọc sau khi ghi và sẽ đọc nút mà bạn đã đăng vào đó.
Map {
numeric string: bool
}

Mã lỗi

LỗiMô tả
100Invalid parameter
200Permissions error
3802User cannot reblock target so soon after unblocking target
3801User has already blocked the maximum number of people
368The action attempted has been deemed abusive or is otherwise disallowed
190Invalid OAuth 2.0 Access Token
104Incorrect signature

Cập nhật

Bạn không thể thực hiện thao tác này trên điểm cuối này.

Xóa

Bạn có thể hủy liên kết a User khỏi a Page bằng cách thực hiện yêu cầu DELETE đến /{page_id}/blocked.

Thông số

Thông sốMô tả
asid
user/page ID

App Scoped User ID to unblock

psid
UID

Page Scoped User ID to unblock

uid
UID

Deprecated. Same as user

user
UID

List of User or Page IDs to unblock. This or uid is required

Kiểu trả về

Struct {
success: bool,
}

Mã lỗi

LỗiMô tả
100Invalid parameter
200Permissions error
190Invalid OAuth 2.0 Access Token