Сообщество

Путь: /community

Дополнительный путь: /company

Представляет сообщество Workplace. Узел /community (или взаимозаменяемый с ним узел /company) возвращает один объект сообщества типа группа. Чтобы вам было удобнее работать с API, корневой объект сообщества можно представить как корневую группу для других групп или сообществ.

Чтобы найти ID сообщества, выполните вызов GET к конечной точке graph.facebook.com/community и укажите маркер доступа пользовательской интеграции.

В некоторых случаях корневое сообщество может содержать другие сообщества. Они будут отображаться на границе контекста /groups корневого сообщества. Дочерние сообщества корневого сообщества можно отличить от дочерних групп по полю is_community.

Если в корневом сообществе есть одно или несколько других сообществ, это означает, что в экземпляре Workplace включены сообщества.

Чтобы получить группы внутри этого сообщества, можно запросить дочерние сообщества на их границе контекста /groups. Во всех случаях граница контекста /groups показывает только прямые зависимости сообщества. Рекурсия не выполняется.

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

Чтение

GET graph.facebook.com
  /community

Разрешения

Узлу сообщества необходимо разрешение на чтение контента группы или управление группами.

Публикация

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

Удаление

Удаление сообществ Workplace через этот узел не поддерживается.

Обновление

Обновление сообществ Workplace через этот узел не поддерживается.

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

Примеры

Создание группы

Создать группу сообщества можно с помощью запроса POST к границе контекста /community/groups. Ответ будет содержать ID новой группы. Обратите внимание: чтобы в группе отображались пользователи, необходимо добавить по крайней мере одного участника и сделать его администратором.

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Получение списка всех групп и сообществ корневого сообщества:

GET graph.facebook.com
  /community/groups?fields=is_community

Получение списка участников корневого сообщества:

GET graph.facebook.com
  /community/members

Получение списка участников корневого сообщества с фильтрацией по external_id:

GET /community/members?
  external_ids=12356,abc123

Отправка жалобы на контент (эта граница контекста упразднена 30 апреля 2019 г.):

POST graph.facebook.com
  /community/reported_content?
    content_id={...}

Добавление новой группы в корневое сообщество:

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Добавление новой группы в некорневое сообщество:

POST graph.facebook.com
  /{community-id}/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Подготовка аккаунта:

POST graph.facebook.com
  /community/accounts?
    name={...}&
    email={...}&
    department={...}&
    division={...}&
    organization={...}&
    title={...}&
    manager={...}&
    hire_date={...}&
    invite={...}&
    active={...}

Список доступных значков:

GET graph.facebook.com
  /community/badges?fields=id,name,description,icon,category

Список категорий корневого уровня:

GET graph.facebook.com
  /community/knowledge_library_categories

Публикация новой категории корневого уровня:

POST graph.facebook.com
  /community/knowledge_library_categories?
  title={...}&
  icon={...}&
  color={...}&
  json_content={...}

Список ссылок на часто используемые инструменты и другие ресурсы в Библиотеке знаний:

GET graph.facebook.com
        /community/knowledge_quick_links?fields=title,link

Чтение определенной быстрой ссылки в Библиотеке знаний:

GET graph.facebook.com
        /{quick_link_id}?fields=title,link

Добавление новой быстрой ссылки в Библиотеке знаний:

POST graph.facebook.com
        /community/knowledge_quick_links?
        title={...}&
        link={...}

Обновление определенной быстрой ссылки в Библиотеке знаний:

POST graph.facebook.com
        /{quick_link_id}?
        title={...}&
        link={...}

Удаление определенной быстрой ссылки в Библиотеке знаний:

DELETE graph.facebook.com
        /{quick_link_id}