Workplace

Публикация

Путь /{POST-id}

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

Чтение

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

Разрешения

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

Поля

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

id

ID публикации в формате {group-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

Публикация

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

Удаление

Чтобы удалить публикацию с помощью API Graph, выполните запрос DELETE к границе контекста /{post_id}.

Разрешения

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

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

Обновление

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

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

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

/attachments

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

/comments

Комментарии к публикации. Их общее количество можно получить с помощью поля summary.

/reactions

Люди, отреагировавшие на публикацию. Их общее количество можно получить с помощью поля summary. С помощью полей since=unix_timstamp и until=unix_timestamp можно получить количество реакций за период времени.

/seen

Люди, просмотревшие публикацию. Их общее количество можно получить с помощью поля summary. С помощью полей since=unix_timstamp и until=unix_timestamp можно получить количество просмотров за период времени.


Обратите внимание на ограничения, перечисленные в этой статье.

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

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

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

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

**Bold**

Курсив

*Emphasize*

Ссылка

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

Inline code

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

Цитата

> 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
  /{group-id}_{post-id}/seen?
  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}}

Удаление публикации

DELETE graph.facebook.com
  /{post-id}

Реакции и просмотры за период времени

GET graph.facebook.com
  /{post-id}/seen?
        since=1577836800&
        until=1593561600