Bảng feed dành cho Trang

Sử dụng điểm cuối này để lấy và đăng dữ liệu lên Trang. Bảng feed dành cho Trang bao gồm mọi hoạt động tương tác với Trang Facebook, trong đó có: bài viết và liên kết do Trang này đăng, khách truy cập Trang này và bài viết công khai có gắn thẻ Trang.

Xem thêm

• Với điểm cuối /{page-post-id}, bạn có thể cập nhật một bài viết cụ thể trên Trang.
• Điểm cuối /{page-id}/taggedchỉ truy xuất những bài viết công khai có gắn thẻ Trang này.

Đọc

Bài viết của một Trang Facebook.

Trải nghiệm Trang mới

API này được hỗ trợ cho Trải nghiệm Trang mới.

Yêu cầu

Người yêu cầu mã truy cập phải có khả năng thực hiện một trong những tác vụ sau đây trên Trang:

• CREATE_CONTENT - Đăng nội dung lên Trang với vai trò Trang
• MANAGE - Chỉ định và quản lý các tác vụ trên Trang
• MODERATE

  • Phản hồi bình luận về bài viết trên Trang với vai trò Trang
  • Xóa các bình luận về bài viết trên Trang
  • Đăng nội dung lên Instagram từ Facebook, phản hồi và xóa bình luận, gửi tin nhắn Direct, đồng bộ thông tin liên hệ của doanh nghiệp và tạo quảng cáo nếu có một tài khoản Instagram được kết nối với Trang.

Đồng thời đã cấp cho ứng dụng các quyền sau đây:

• Quyền pages_read_engagement
• Quyền pages_read_user_content

Nếu không sở hữu hoặc quản lý Trang, bạn cần có:

• Tính năng Quyền truy cập nội dung công khai trên Trang

Yêu cầu mẫu

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

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/feed",
    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}/feed"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Phản hồi mẫu ở định dạng JSON

{
  "data": [
    {
      "created_time": "2019-05-17T16:24:04+0000",
      "message": "Become a Facebook developer!",
      "id": "{page-id}_2191966997525824"
    },
    {
      "created_time": "2019-02-26T21:35:42+0000",
      "message": "Hello world!",
      "id": "{page-id}_2072371269485398"
    },
...
    {
      "created_time": "2018-01-26T20:57:22+0000",
      "message": "Friday Funday!",
      "id": "{page-id}_1569752556413941"
    }
  ],
  "paging": {
    "cursors": {
      "before": "Q2c4U1pXNT...",
      "after": "Q2c4U1pXNT..."
    },
    "next": "https://graph.facebook.com/vX.X/{page-id}/feed?access_token={your-page-access-token}&pretty=0&limit=25&after=Q2c4U1pXNT..."
  }
}

Giới hạn

• Bài viết đã hết hạn - Nếu một Bài viết đã hết hạn, bạn sẽ không thể xem nội dung Bài viết đó bằng API Đồ thị nữa.
• Số bài viết tối đa

  • API sẽ trả về khoảng 600 bài viết được xếp hạng và đăng mỗi năm.
  • Bạn chỉ có thể đọc tối đa 100 bài viết trên bảng tin với trường limit. Nếu cố đọc nhiều hơn số lượng này thì bạn sẽ nhận được thông báo lỗi không được vượt quá 100.
• Nút kêu gọi hành động nhắn tin - Không thể truy cập các bài viết có nút kêu gọi hành động nhắn tin bằng mã truy cập của Trang khác, vì các Trang không thể nhắn tin cho nhau.
• Thông tin có thể nhận dạng công khai - Thông tin về người dùng sẽ không được đưa vào phản hồi trừ khi bạn gửi yêu cầu bằng mã truy cập Trang.
• Bài viết đã đăng - Hệ thống sẽ trả về bài viết đã đăng và chưa đăng khi truy vấn điểm cuối "/{page-id}/feed". Sử dụng trường "is_published" để chỉ trả về bài viết đã đăng.
• Bài viết được chia sẻ - Bài viết trên Trang chia sẻ bài viết từ một Trang hay người khác có thể không hiển thị nếu bài viết gốc không hiển thị với mã truy cập đã sử dụng.
• Bài viết được gắn thẻ – Khi bạn sử dụng /{page-id}/tagged để hiển thị các bài viết đã gắn thẻ Trang này, kết quả sẽ bao gồm các bài viết của Trang khác chỉ khi những Trang đó là xác thực.
• Tác nhân người dùng – Các tác nhân người dùng hiện có và được phép thực hiện những lệnh gọi API Đồ thị này có thể thay đổi mà không cần thông báo. Nếu gặp vấn đề, bạn nên chuyển sang một phiên bản mới hơn của tác nhân người dùng cụ thể.
• Bài viết có video - Để lấy danh sách bài viết có video, người gửi yêu cầu phải là quản trị viên Trang.
• Thước phim Để lấy danh sách Thước phim đã đăng lên Trang của bạn, hãy sử dụng cạnh VideoReels trên Trang.

Giới hạn: Tất cả bài viết (đã đăng và chưa đăng) sẽ được kéo vào điểm cuối bảng feed. Điểm khác biệt duy nhất là bài viết chưa đăng sẽ không được liệt kê trong bảng feed thực. Tuy nhiên, bạn có thể thêm trường is_published vào điểm cuối /feed để cho nhà phát triển biết bài viết nêu trong điểm cuối /feed đã được đăng hay chưa

Trường

curl -i -X GET \
 "https://graph.facebook.com/{your-page-id}/feed
    ?fields=is_eligible_for_promotion,promotable_id
        &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{your-page-id}/feed",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "is_eligible_for_promotion,promotable_id");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"fields": @"is_eligible_for_promotion,promotable_id",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'GET',
  {"fields":"is_eligible_for_promotion,promotable_id"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{your-page-id}/feed?fields=is_eligible_for_promotion,promotable_id',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

{
  "data": [
    {
      "is_eligible_for_promotion": true,
      "promotable_id": "1353269864728879_1943344825721377",
      "id": "1353269864728879_1943344825721377"
    },
    {
      "is_eligible_for_promotion": true,
      "promotable_id": "1353269864728879_1943313139057879",
      "id": "1353269864728879_1943378089051384"
    },
    {
      "is_eligible_for_promotion": false,
      "promotable_id": "1353269864728879_1942095249179668",
      "id": "1353269864728879_1942095249179668"
    },
...

Đăng

Bạn có thể đăng lên Trang bằng cạnh này. Bạn phải cung cấp link hoặc message.

Trải nghiệm Trang mới

API này được hỗ trợ cho Trải nghiệm Trang mới.

Yêu cầu

Nếu có thể thực hiện tác vụ CREATE_CONTENT, bạn cần có:

• Mã truy cập Trang
• Quyền pages_manage_posts
• Quyền pages_read_engagement
• Quyền pages_show_list

Bài viết sẽ hiển thị với tư cách Trang đó.

Quyền

• Mã truy cập Trang do người có thể thực hiện

  tác vụ CREATE_CONTENT

  trên Trang được truy vấn yêu cầu

• Quyền pages_manage_posts

Lưu ý: Nếu người xem hoặc ứng dụng không thể nhìn thấy URL của link, bài viết sẽ không thành công.

POST /v21.0/{page-id}/feed HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+message

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{page-id}/feed',
    array (
      'message' => 'This is a test message',
    ),
    '{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}/feed",
    "POST",
    {
        "message": "This is a test message"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test message");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/feed",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test message",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/feed"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Phản hồi

{"id":"post-id"}

Điểm cuối này hỗ trợ đọc sau khi ghi và có thể trả về ngay bất kỳ trường nào do thao tác đọc trả về.

Ví dụ về Công cụ khám phá đồ thị

Thử nghiệm trong Công cụ khám phá đồ thị bằng POST {page-id}/feed:

Trường

POST /v21.0/page-id/feed HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+activity&og_action_type_id=383634835006146&og_object_id=136050896551329&og_icon_id=609297155780549

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/page-id/feed',
    array (
      'message' => 'This is a test activity',
      'og_action_type_id' => '383634835006146',
      'og_object_id' => '136050896551329',
      'og_icon_id' => '609297155780549',
    ),
    '{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/feed",
    "POST",
    {
        "message": "This is a test activity",
        "og_action_type_id": "383634835006146",
        "og_object_id": "136050896551329",
        "og_icon_id": "609297155780549"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test activity");
params.putString("og_action_type_id", "383634835006146");
params.putString("og_object_id", "136050896551329");
params.putString("og_icon_id", "609297155780549");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/page-id/feed",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test activity",
  @"og_action_type_id": @"383634835006146",
  @"og_object_id": @"136050896551329",
  @"og_icon_id": @"609297155780549",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/page-id/feed"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Bài viết chưa đăng trên Trang

Chúng tôi hỗ trợ những loại bài viết chưa đăng trên Trang sau đây:

Ngoại trừ việc không hiển thị trong /feed, bài viết không đăng trên Trang được xử lý giống như bài viết đã đăng trên Trang.

Để xem danh sách bài viết không đăng trên Trang, hãy truy vấn trường is_published.

curl -i -X GET \
 "https://graph.facebook.com/{page-id}/feed
 ?fields=is_published
 &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{page-id}/feed",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "is_published");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{page-id}/feed"
           parameters:@{ @"fields": @"is_published",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{page-id}/feed',
  'GET',
  {"fields":"is_published"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{page-id}/feed?fields=is_published',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Để xem một bài viết trên Facebook.com, bạn có thể truy cập https://www.facebook.com/{post-id} đối với hầu hết các loại bài viết, hoặc truy xuất trường actions của bài viết. Trường này chứa URL để Người dùng có thể thích hoặc bình luận về bài viết.

Trường call_to_action của bài viết trên Trang

Bạn có thể cải thiện bài viết trên Trang có liên kết bằng các nút kêu gọi hành động. Sau đây là trường call_to_action mà bạn có thể thêm vào bài viết trên Trang có liên kết mới.

Hình ảnh trong bài viết trên Trang có liên kết tùy chỉnh

Đăng liên kết đến Trang có hình ảnh từ liên kết tùy chỉnh. Nội dung đính kèm của tin sẽ hiển thị một hình ảnh được truy xuất từ liên kết đó. Hiện tại, bạn có thể ghi đè hình ảnh đó bằng cách cung cấp một thông số picture tùy chọn cùng với URL đến hình ảnh mới. Thông số thumbnail cũng cung cấp chức năng tương tự với điểm khác biệt chính là thông số này chấp nhận file hình ảnh cục bộ được tải lên Facebook bằng lệnh gọi API.

Quyền

• Cần có mã truy cập Trang.
• Liên kết phải thuộc sở hữu của Trang đăng.

Giới hạn

• Thông số thumbnail chỉ dùng được cho bài viết có liên kết trên Trang Facebook.
• Thông số thumbnail được ưu tiên hơn so với thông số picture. Nếu cung cấp cả hai thông số thì thông số picture sẽ không được sử dụng.
• Thông số thumbnail chấp nhận hình ảnh có đuôi file .jpg, .jpeg, .gif hoặc .png.
• Thông số thumbnail không được hỗ trợ trong các yêu cầu hàng loạt.

Đăng liên kết đến Trang

Hãy đăng liên kết đến Trang bằng cách gửi yêu cầu POST đến cạnh /page/feed. Đặt thông số publish thành 1 để đăng ngay bài viết hoặc thành 0 để tạo bài viết chưa đăng rồi đăng sau.

Yêu cầu mẫu

curl -i -X POST "https://graph.facebook.com/{your-page-id}/feed
  ?message=Become%20a%20Facebook%20developer!
  &link=https%3A%2F%2Fdevelopers.facebook.com
  &published=1
  &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-page-id}/feed",
  new JSONObject("{\"message\":\"Become a Facebook developer!\",\"link\":\"https://developers.facebook.com\",\"published\":\"1\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"message": @"Become a Facebook developer!",@"link": @"https://developers.facebook.com",@"published": @"1",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'POST',
  {"message":"Become a Facebook developer!","link":"https://developers.facebook.com","published":"1"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-page-id}/feed',
    array (
      'message' => 'Become a Facebook developer!',
      'link' => 'https://developers.facebook.com',
      'published' => '1'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Phản hồi mẫu

{"id":"{post-id}"}

Bài viết có liên kết trên Trang cùng nút kêu gọi hành động

Trường call_to_action chỉ định hành động thích hợp và liên kết liên quan. Liên kết này phải giống với thông số link của bài viết trên Trang. Trong lệnh gọi này, title, description, caption và picture là các thuộc tính tùy chọn. Khi không được cung cấp, Facebook sẽ đọc các thuộc tính tương tự từ siêu dữ liệu Open Graph của liên kết. Nếu trang web được liên kết không có siêu dữ liệu Open Graph, Facebook sẽ tìm cách đoán những thuộc tính này bằng cách trích xuất nội dung của trang web đó.

Yêu cầu mẫu

curl -i -X POST "https://graph.facebook.com/{your-page-id}/feed
  ?message=Become a Facebook developer!
  &link=https://developers.facebook.com
  &call_to_action={"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}
  &published=1
  &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-page-id}/feed",
  new JSONObject("{\"message\":\"Become a Facebook developer!\",\"link\":\"https://developers.facebook.com\",\"published\":\"1\",\"call_to_action\":\"{\\\"type\\\":\\\"SIGN_UP\\\",\\\"value\\\":{\\\"link\\\":\\\"https://developers.facebook.com\\\"}}\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"message": @"Become a Facebook developer!",@"link": @"https://developers.facebook.com",@"published": @"1",@"call_to_action": @"{"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'POST',
  {"message":"Become a Facebook developer!","link":"https://developers.facebook.com","published":"1","call_to_action":"{\"type\":\"SIGN_UP\",\"value\":{\"link\":\"https://developers.facebook.com\"}}"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-page-id}/feed',
    array (
      'message' => 'Become a Facebook developer!',
      'link' => 'https://developers.facebook.com',
      'published' => '1',
      'call_to_action' => '{"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Phản hồi mẫu

{"id":"{post-id}"}

Bài viết có liên kết cùng hình ảnh tải lên tùy chỉnh

Sử dụng một file cục bộ:

curl -F 'link=http://www.example.com' \
     -F 'thumbnail=@/local/path/to/file/on/hard/drive/image.jpg' \
     -F 'access_token=page-access-token'\
  https://graph.facebook.com/v2.11/page-id/feed

Giá trị trả về

{"id":"post-id"}

Sử dụng hình ảnh qua URL:

curl -F 'link=http://www.example.com' \
     -F 'picture=https://www.example.com/path/to/image.jpg' \
     -F 'access_token=page-access-token'\
  https://graph.facebook.com/v2.11/page-id/feed

Giá trị trả về

{"id":"post-id>"}

Bài viết có ảnh trên Trang

Vui lòng xem Tài liệu tham khảo về nút ảnh của chúng tôi để biết thêm thông tin.

Bài viết có video trên Trang

Vui lòng xem Tài liệu tham khảo về video trên Trang của chúng tôi để biết thêm thông tin.

Bài viết thông tin chi tiết trên Trang

Vui lòng xem Tài liệu tham khảo về thông tin chi tiết bài viết trên Trang để biết thêm thông tin.

Cập nhật

Bạn không thể cập nhật bằng cạnh này. Tuy nhiên, bạn có thể cập nhật bài viết bằng nút /{post-id}.

Xóa

Bạn không thể xóa bằng cạnh này. Tuy nhiên, bạn có thể xóa bài viết bằng nút /{post-id}.