Диалог ленты

Вы можете добавить в свое приложение диалог ленты, позволяющий людям публиковать в своей хронике отдельные истории с комментариями.

Для публикации историй через диалог ленты не требуется никаких расширенных разрешений.

Интеграция

Этот диалог можно вызвать через Facebook SDK for Javascript, через Facebook SDK для iOS или Android, а также выполнив полное перенаправление на определенный URL. Ниже приведены примеры фрагментов кода, вызывающих этот диалог.

JavaScript

Чтобы открыть диалог ленты, вызовите функцию FB.ui и передайте в параметре method значение feed.

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

iOS

Ознакомьтесь с руководством по диалогу "Поделиться" в iOS, который также позволяет публиковать новости Open Graph.

Android

Ознакомьтесь с документацией о диалоге "Поделиться" в Android, который также позволяет публиковать истории Open Graph.

Перенаправление на URL

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

Примечание

Если у пользователя для параметра "Кто может размещать публикации в вашем профиле?" выбрано значение "Только я" и другой человек попытается опубликовать что-то в его хронике с помощью диалога ленты, он увидит сообщение о том, что это сделать невозможно.

Параметры

Примечание. Если в публикации приложения содержатся ссылки на iTunes или Google Play либо на профиль или страницу Facebook, мы не размещаем изображения и описания, заданные вами при публикации с помощью указанных ниже параметров. Вместо этого мы размещаем информацию о приложении, полученную краулером Webcrawler напрямую из магазина приложений либо со страницы Facebook. В этой информации могут отсутствовать изображения. Чтобы предварительно просмотреть публикуемую ссылку на iTunes или Google Play, введите URL в отладчике репостов.

Параметр	Описание
`app_id`	Уникальный идентификатор приложения. Обязательный параметр.
`redirect_uri`	URL, на который будет перенаправлен человек, когда нажмет кнопку в диалоге. Обязательный параметр, если используется перенаправление на URL.
`display`	Определяет, как отображается диалог. Если вы используете диалог перенаправления на URL, на Facebook.com будет показана вся страница полностью. Такой тип отображения называется `page`. Если для вызова диалога используется Facebook SDK для iOS или Android, этот параметр задается автоматически, после чего выбирается подходящий для устройства тип отображения. Если используется Facebook SDK for Javascript, то для людей, вошедших в приложение, по умолчанию выбирается модальный тип `iframe`, для игр на Facebook.com — тип `async`, а для всех остальных — окно `popup`. Кроме того, если вы используете Facebook SDK for Javascript, при необходимости можно принудительно выбрать тип `popup` или `page`. В мобильных веб-приложениях по умолчанию всегда используется тип отображения `touch`.
`from`	ID пользователя, публикующего сообщение. Если он не указан, по умолчанию задается текущий пользователь. Если он указан, это должен быть ID пользователя или страницы, которую он администрирует.
`to`	ID профиля, в котором будет опубликована эта история. Если он не указан, по умолчанию используется значение `from`. Этот ID должен быть идентификатором друга, который также использует ваше приложение.
`link`	Ссылка, прикрепленная к публикации.
`source`	URL медиафайла (в формате SWF или MP3), который требуется прикрепить к этой публикации. Для формата SWF необходимо также с помощью параметра `picture` задать миниатюру видео.
`ref`	Этот аргумент представляет собой список с разделителями-запятыми, в который входят до 5 различных элементов. Каждый из них может содержать от 1 до 15 символов из набора "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_". Каждая категория используется в Статистике Facebook для измерения результативности различных видов публикаций.

Упраздненные параметры

Параметр	Описание
`post_id`	ID размещенной истории, если пользователь решил опубликовать ее в своей хронике.
`properties`	Объект JSON в виде пар "ключ — значение", который отображается в прикрепленной трансляции под описанием (каждое свойство — в отдельной строке). Ключи должны быть строками, а значения — строками или объектами JSON с ключами `text` и `href`.
`actions`	Массив JSON, содержащий один объект с описанием ссылки на действие, которая будет отображаться рядом со ссылками "Комментировать" и "Нравится" под публикациями. У этого объекта должны быть ключи `name` и `link`.
`picture`	URL изображения, которое нужно прикрепить к публикации. Размер изображения должен быть не менее 200 × 200 пикселей. Дополнительные сведения о размерах см. в наших советах и рекомендациях по публикации.
`name`	Имя вложения ссылки.
`caption`	Текст ссылки (отображается под ее именем). Если это поле не задано, в него автоматически подставляется URL ссылки.
`description`	Описание ссылки (отображается под ее текстом). Если этот параметр не задан, автоматически указывается информация, полученная из ссылки во время скрапинга (обычно это заголовок страницы).
`thumbnail`	Локальный файл загружаемого изображения (`.jpg`, `.jpeg`, `.gif` или `.png`).