Версия API Graph

Page Published Posts

Чтение

All published posts by the page.

New Page Experience

This endpoint is supported for 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 Graph, ознакомьтесь с нашим руководством по API Graph.

Ограничения

  • Максимальное количество публикаций:
    • API возвращает примерно 600 ранжированных размещенных публикаций за год.
    • С помощью поля limit можно прочесть до 100 публикаций в ленте. При попытке прочесть больше выдается соответствующее сообщение об ошибке.
  • Сообщения с призывом к действию. Для доступа к публикациям с сообщениями, содержащими призыв к действию, нельзя использовать маркер доступа к другой Странице, так как Страницы не могут обмениваться сообщениями.
  • Публичная информация, идентифицирующая личность. Ответы не будут содержать информацию о пользователе, если в запросе не используется маркер доступа к Странице.
  • Репосты публикаций. Публикация Страницы, которая является репостом публикации другой Страницы или человека, может быть недоступна, если исходную публикацию нельзя просмотреть с использованием этого маркера доступа.
  • Отмеченные публикации. Если для показа публикаций, в которых отмечена эта Страница, используется /{page-id}/tagged, результаты включают публикации с других Страниц, только если эти Страницы являются подлинными.
  • Пользовательские агенты. Пользовательские агенты, разрешенные для этих вызовов API Graph, могут меняться без уведомления. В случае проблем попробуйте обновить версию своего пользовательского агента.
  • Видеопубликации. Поле source для /page/feed и /page/posts для принадлежащего Странице видео возвращается, только если запрос отправлен администратором этой Страницы.

Параметры

Эта конечная точка не содержит параметров.

Поля

При чтении с данной границы контекста будет возвращен результат в формате JSON:

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

data

Список узлов «PagePost».

paging

Для получения дополнительных сведений о пагинации смотрите Руководство по API Graph.

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

Error Codes

ОшибкаОписание
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

Создание

Нельзя выполнить эту операцию в этой конечной точке.

Обновление

Нельзя выполнить эту операцию в этой конечной точке.

Удаление

Нельзя выполнить эту операцию в этой конечной точке.