Справка

Публикация

Путь /{POST-id}

Представляет публикацию в Workplace. Узел /{post-id} возвращает одну публикацию.

Чтение

Возвращает один объект Post, представляющий публикацию в группе, мероприятии или профиле пользователя.

Разрешения

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

Поля

Имя поляОписаниеТип

id

ID публикации.

string

created_time

Изначальное время размещения публикации.

datetime

formatting

Указывает, была ли публикация создана с использованием языка разметки. Язык указывается в возвращаемом значении. Workplace поддерживает Markdown и обычный текст.

enum {MARKDOWN|PLAINTEXT}

from

Информация о человеке или профиле, опубликовавшем сообщение.

Profile

icon

Ссылка на значок, соответствующий типу публикации.

URL

link

Ссылка, прикрепленная к публикации.

URL

message

Сообщение о статусе в публикации.

string

name

Имя link, если она прикреплена к публикации.

string

object_id

ID загруженного фото или видео, прикрепленного к публикации.

string

permalink_url

URL страницы, на которую ведет постоянная ссылка публикации.

URL

picture

Изображение, скрапированное по любой link из публикации.

URL

place

Информация о местоположении, прикрепленная к публикации.

Place

poll

Если публикация представляет собой опрос, в этом поле возвращается прикрепленный объект Question, в котором можно просмотреть options и votes пользователей для варианта ответа.

Question

properties

Список свойств прикрепленного видео (продолжительность и т. д.).

object[]

status_type

Тип обновления статуса.

enum {mobile_status_update, created_note, added_photos, added_video, shared_story, created_group, created_event, wall_post, app_created_story, published_story, tagged_in_photo}

story

Текст истории, не создаваемый пользователями намеренно.

string

to

Профили, упомянутые в публикации или включенные в ее таргетинг.

Profile[]

type

Строка, указывающая на тип объекта для этой публикации.

enum{link, status, photo, video}

updated_time

Время создания публикации, ее последнего редактирования или комментирования.

datetime

with_tags

Профили, имеющие метку "с" с указанием автора публикации.

Объект JSON с полем data , в котором содержится список объектов Profile.

Публикация

Эту границу контекста нельзя использовать для публикаций. Чтобы разместить новую публикацию в группе, используйте границу контекста /group/feed .

Удаление

Удалить публикацию можно с помощью Graph API. Для этого сделайте вызов DELETE к конечной точке /{post_id}.

Разрешения

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

Обновление

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

Границы контекста

Имя границыОписание

/attachments

Все медиафайлы, прикрепленные к этой публикации.

/comments

Комментарии к публикации. Поддерживает поле summary для получения общего количества.

/likes

Люди, поставившие этой публикации отметку "Нравится". Поддерживает поле summary для получения общего количества.

/reactions

Люди, отреагировавшие на публикацию. Поддерживает поле summary для получения общего количества.

/seen

Люди, просмотревшие публикацию. Поддерживает поле summary для получения общего количества.

Поддерживаемый синтаксис Markdown

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

ФорматированиеСинтаксис

Полужирное начертание

**Bold**

Курсив

*Emphasize*

Ссылка

[Link](https://workplace.fb.com)

Встроенный код

`Inline code`
блок кода
``` code block ```
  • Список
* List
  1. Нумерованный список
1. Нумерованный список

Цитата

> Quote

Заголовок 1

# Heading 1

Заголовок 2

## Heading 2

Примеры

Получение ID, source и story публикации

GET graph.facebook.com
  /{post-id}?fields=id,source,story

Получение комментариев к публикации

GET graph.facebook.com
  /{post-id}/comments

Получение состояния просмотра публикации, включая общее количество просмотров

GET graph.facebook.com
  /{post-id}/comments?
  summary=true

Публикация в группе

POST graph.facebook.com
  /{group-id}/feed?
  message=Hello+World&
  link=https://developers.facebook.com/docs/workplace/custom-integrations/apps

Отметка пользователя в публикации в группе

POST graph.facebook.com
  /{group-id}/feed?
  message=Hi+@[100013325822531]

Публикация в группе с форматированием Markdown

POST graph.facebook.com
  /{group-id}/feed?
  message=This+is+a+**formatted**+*post*&
  formatting=MARKDOWN

Получение информации о вариантах ответов в публикации с опросом и отданных голосах с использованием расширения полей

GET graph.facebook.com
  /{post-id}?
  fields=message,poll{options{name,vote_count,votes}}