Phiên bản API Đồ thị

Page Published Posts

Đọc

All published posts by the page.

New Page Experience

This endpoint is supported for New Page Experience.

Feature Permissions

TênMô tả
Quyền truy cập nội dung công khai trên TrangThis feature permission may be required.

Ví dụ

Graph API Explorer
GET /v21.0/{page-id}/published_posts 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}/published_posts',
    '{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}/published_posts",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/published_posts",
    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}/published_posts"
                                      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.

Các giới hạn

  • 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 thêm 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 đã 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 – Trường source cho /page/feed/page/posts sẽ chỉ được trả về cho video của Trang khi Người dùng gửi yêu cầu chính là quản trị viên của Trang sở hữu.

Thông số

Điểm cuối này không có bất kỳ thông số nào.

Trường

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

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

data

Danh sách nút PagePost.

paging

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

summary

Thông tin tổng hợp về cạnh, chẳng hạn số lượng. Hãy chỉ định các trường để tìm nạp trong thông số tóm tắt (như summary=total_count).

TrườngMô tả
total_count
unsigned int32

The approximate total number of published posts within the specified time window, requires since parameter to be specified

Mã lỗi

LỗiMô tả
80001There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
200Permissions error
100Invalid parameter
190Invalid OAuth 2.0 Access Token
210User not visible
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
104Incorrect signature
3001Invalid query
2500Error parsing graph query

Tạo

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

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 không thể thực hiện thao tác này trên điểm cuối này.