Лента Страницы

С помощью этой конечной точки можно получать и размещать публикации Страницы. Лента Страницы охватывает все виды взаимодействия со страницей Facebook, в том числе записи и ссылки, опубликованные этой страницей и посетителями на этой странице, а также общедоступные публикации, в которых эта страница была отмечена.

См. также

• Конечная точка /{page-post-id} позволяет обновить публикацию Страницы.
• Конечная точка /{page-id}/taggedвозвращает все общедоступные публикации, в которых отмечена эта Страница.

Чтение

Публикации Страницы Facebook.

Новая версия Страниц

Этот API поддерживается для новой версии Страниц.

Требования

Человек, запрашивающий маркер доступа, должен иметь право выполнять следующие задачи на этой Странице:

• CREATE_CONTENT — публиковать контент на Странице от ее имени.
• MANAGE — назначать задачи на Странице и управлять ими.
• MODERATE:

  • отвечать на комментарии к публикациям Страницы от ее имени;
  • удалять комментарии к публикациям Страницы;
  • публиковать контент в Instagram из Facebook, отвечать на комментарии и удалять их, отправлять сообщения в Direct, синхронизировать контактную информацию компании и создавать рекламу, если со Страницей связан аккаунт Instagram.

У приложения должны быть следующие разрешения:

• разрешение pages_read_engagement;
• разрешение pages_read_user_content.

Если вы не являетесь владельцем Страницы и не можете ею управлять, вам понадобится:

• доступ к общедоступному контенту Страницы.

Пример запроса

GET /v19.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
}];

Пример ответа 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..."
  }
}

Ограничения

• Публикации с истекшим сроком давности. Если срок давности публикации истек, вы не сможете просмотреть этот контент с помощью Graph API.
• Максимальное количество публикаций

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

Ограничение: в конечную точку ленты будут попадать все публикации (размещенные и неразмещенные). Разница заключается в том, что неразмещенные публикации будут отсутствовать в списке физической ленты. При этом к конечной точке /feed можно добавить поле is_published, по которому разработчики смогут определить, размещена публикация в конечной точке /feed или нет.

Поля

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"
    },
...

Публикация

Для публикации на Страницах используйте эту границу контекста. Необходимо указать link или message.

Новая версия Страниц

Этот API поддерживается для новой версии Страниц.

Требования

Если вы можете выполнять задачу CREATE_CONTENT, вам понадобятся:

• маркер доступа к Странице;
• разрешение pages_manage_posts;
• разрешение pages_read_engagement;
• разрешение pages_show_list.

Публикации будут размещаться от имени Страницы.

Разрешения

• Маркер доступа к Странице, запрошенный пользователем, который может выполнять действие

  Задача CREATE_CONTENT

  на запрашиваемой Странице

• Разрешение pages_manage_posts.

Примечание. Если URL ссылки (link) не виден пользователю или приложению, разместить публикацию не удастся.

POST /v19.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
}];

Ответ

{"id":"post-id"}

Эта конечная точка поддерживает чтение после записи и может сразу возвращать любые поля, возвращаемые операциями чтения.

Пример использования инструмента Graph Explorer

Проверка в инструменте Graph Explorer с использованием POST {page-id}/feed:

Поля

POST /v19.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
}];

Неразмещенные публикации Страницы

Поддерживаются неразмещенные публикации Страницы перечисленных ниже типов.

Неразмещенные публикации Страницы аналогичны размещенным, однако они не отображаются в ленте (/feed).

Чтобы просмотреть список неразмещенных публикаций Страницы, запросите поле 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();

Чтобы просмотреть публикацию на сайте Facebook.com, обычно нужно перейти по ссылке https://www.facebook.com/{post-id} или получить поле actions данной публикации, содержащее URL, по которому для нее можно оставлять отметки "Нравится" и комментарии.

Параметр call_to_action публикации Страницы

В публикации Страницы со ссылками можно добавлять кнопки призыва к действию. В новые публикации Страницы со ссылкой можно добавлять описанное ниже поле call_to_action.

Пользовательское изображение в публикации Страницы со ссылкой

Вы можете опубликовать на Странице ссылку с пользовательским изображением. Во вложении новости отображается изображение, полученное по ссылке. В настоящее время это изображение можно переопределить, указав необязательный параметр picture с URL нового изображения. Параметр thumbnail работает аналогичным образом. Основная разница в том, что он принимает локальный файл изображения, загруженный на Facebook в вызове API.

Разрешения

• Требуется маркер доступа к Странице.
• Ссылка должна принадлежать Странице, с которой производится публикация.

Ограничения

• Параметр thumbnail доступен только в публикациях со ссылками на Страницах Facebook.
• Параметр thumbnail имеет приоритет перед параметром picture. Если указаны оба, параметр picture не используется.
• Параметр thumbnail принимает изображения с расширениями .jpg, .jpeg, .gif и .png.
• В пакетных запросах параметр thumbnail не поддерживается.

Публикация ссылки на Странице

Чтобы опубликовать ссылку на Странице, отправьте запрос POST к границе контекста /page/feed. Установите для параметра publish значение 1, чтобы сразу же разместить публикацию, или 0, чтобы создать неразмещенную публикацию и опубликовать ее позже.

Пример запроса

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();

Пример ответа

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

Публикация Страницы со ссылкой и призывом к действию

В поле call_to_action задается соответствующее действие и ссылка. Ссылка должна совпадать со значением параметра link публикации Страницы. В этом вызове поля title, description, caption и picture не являются обязательными. Если они не указаны, Facebook берет соответствующие свойства из метаданных Open Graph ссылки. Если веб-страница по ссылке не содержит метаданных Open Graph, Facebook попытается определить эти свойства, анализируя контент веб-страницы.

Пример запроса

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();

Пример ответа

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

Публикация со ссылкой и загруженным пользовательским изображением

С использованием локального файла:

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

Возвращаемое значение

{"id":"post-id"}

С использованием изображения по 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

Возвращаемое значение

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

Публикация Страницы с фото

Подробные сведения см. в справочной статье об узле фото.

Публикация Страницы с видео

Подробные сведения см. в справочной статье по видео Страницы.

Статистика публикаций Страницы

Подробные сведения см. в справочной статье по статистике публикаций Страницы.

Обновление

Обновлять публикации с использованием этой границы контекста нельзя, однако для обновления можно использовать узел /{post-id}.

Удаление

Удалять публикации с использованием этой границы контекста нельзя, однако для удаления можно использовать узел /{post-id}.