グラフAPIバージョン

Page Published Posts

読み取り

All published posts by the page.

New Page Experience

このエンドポイントは新デザインのページに対応しています。

Feature Permissions

名前説明
ページの公開コンテンツへのアクセスThis feature permission may be required.

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は、1年に公開された、ランク付けされた投稿を約600件返します。
    • limitフィールドでは、最大100件のフィード投稿のみを読み取ることができます。100件を超えるフィード投稿を読み取ろうとすると、100件を超えてはならない旨のエラーメッセージが表示されます。
  • メッセージCTA - メッセージCTAがある投稿に、他のページのアクセストークンを使用してアクセスすることはできません。ページは他のページにメッセージを送信できないからです。
  • 公的に特定できる情報 - ページアクセストークンを使用してリクエストしない限り、応答にユーザー情報は含まれません。
  • 共有された投稿 - 別のページやユーザーからの投稿をシェアするページ投稿は、使用中のアクセストークンで元の投稿が表示されない場合、表示できないことがあります。
  • タグ付けされた投稿 - /{page-id}/taggedを使用して当該ページをタグ付けする投稿を表示するとき、他のページからの投稿は、それらのページが信頼できる場合にのみ結果に含まれます。
  • ユーザーエージェント - これらのグラフAPI呼び出しで許可される利用可能なユーザーエージェントは、予告なしに変更されることがあります。問題が発生した場合、特定のユーザーエージェントを新しいバージョンに変更すると解決することもあります。
  • 動画投稿 - ページ所有の動画では、そのページの管理者である利用者からのリクエストでない限り、/page/feedおよび/page/postssourceフィールドが返されなくなりました。

パラメーター

このエンドポイントにはパラメーターがありません。

項目

このエッジからの読み込むではJSONフォーマットの結果が返されます:

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

data

PagePostノードの一覧です。

paging

ページネ―ションについて詳しくは、グラフAPIガイドをご覧ください。

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

作成

このエンドポイントではこの操作を実行できません。

更新中…

このエンドポイントではこの操作を実行できません。

削除中です

このエンドポイントではこの操作を実行できません。