그래프 API 버전

Page Published Posts

읽기

All published posts by the page.

새로운 페이지 환경

This endpoint is supported for 새로운 페이지 환경.

Feature Permissions

이름설명
페이지 전체 공개 콘텐츠 액세스기능 권한이 필요할 수도 있습니다.

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
}];
그래프 API를 사용하는 방법을 알아보려면 그래프 API 사용 가이드를 읽어보세요.

제한 사항

  • 최대 게시물
    • API는 순위가 지정된 공개 게시물을 매년 약 600개 반환합니다.
    • limit 필드로 최대 100개의 피드 게시물만 읽을 수 있습니다. 그 이상으로 피드 게시물을 읽으려고 시도할 경우 100개를 초과할 수 없다는 오류 메시지가 나타납니다.
  • 메시지 CTA - 페이지는 다른 페이지로 메시지를 전송할 수 없으므로 메시지 CTA를 포함한 게시물은 다른 페이지의 액세스 토큰을 사용하여 액세스할 수 없습니다.
  • 공개적으로 식별 가능한 정보 - 페이지 액세스 토큰으로 요청하지 않는 한 사용자 정보는 응답에 포함되지 않습니다.
  • 공유된 게시물 - 액세스 토큰을 사용했을 때 원래 게시물이 보이지 않는다면 다른 페이지 또는 사람의 게시물을 공유하는 페이지 게시물이 보이지 않을 수 있습니다.
  • 태그된 게시물 - /{page-id}/tagged를 사용하여 이 페이지를 태그한 게시물을 표시할 경우 페이지가 인증되었을 때만 다른 페이지의 게시물이 결과에 포함됩니다.
  • 사용자 에이전트 - 이러한 그래프 API 호출에 허용되는 이용 가능한 사용자 에이전트는 사전 통지 없이 변경될 수 있습니다. 문제가 발생하는 경우 해당 사용자 에이전트를 최신 버전으로 변경하는 것이 좋습니다.
  • 동영상 게시물 - /page/feed/page/posts에 대한 source 필드는 요청을 보내는 사용자가 소유 페이지의 관리자일 경우에만 페이지에서 소유한 동영상에 대해 반환됩니다.

매개변수

이 엔드포인트는 매개변수가 없습니다.

필드

이 에지로부터 읽는 경우 JSON 형식의 결과를 반환합니다:

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

data

PagePost 노드 리스트.

paging

페이지 매김에 대한 자세한 정보는 그래프 API 가이드를 확인하세요.

summary

수치 등 에지에 관해 집계된 정보입니다. 요약 매개변수에 가져오려면 해당 필드를 지정하세요(예: summary=total_count).

필드설명
total_count
unsigned int32

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

오류 코드

오류설명
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

만들기

이 엔드포인트에서 수행할 수 없는 작업입니다.

업데이트 중

이 엔드포인트에서 수행할 수 없는 작업입니다.

삭제 중

이 엔드포인트에서 수행할 수 없는 작업입니다.