/{member-id}
Представляет объект пользователя как участника сообщества или группы Workplace.
/community/members
Возвращает список всех аккаунтов текущих пользователей. Требуется разрешение на управление рабочими профилями.
external_id
Чтобы отфильтровать пользователей по внешним идентификаторам, передайте в параметре external_ids
разделенный запятыми список внешних идентификаторов нужных пользователей.
/community/organization_members
Возвращает список пользователей. Требуется разрешение на чтение данных об участии в группах. По умолчанию возвращается список активных аккаунтов пользователей. Чтобы получить вместо них отключенные аккаунты пользователей, используйте в URL параметр inactive=1
.
Возвращает отдельный объект User, представляющий пользователя Workplace. Для доступа можно использовать Workplace ID пользователя или адрес электронной почты, используемый участником для входа в Workplace.
/{member_id}
/{email_address}
Для чтения информации об участнике требуется разрешение на чтение рабочих профилей или управление аккаунтами. Если интеграция использует разрешение на управление аккаунтами и предназначена для работы с какими-то конкретными группами, она не сможет получить доступ к некоторым полям объекта Member.
Имя поля | Описание | Тип |
---|---|---|
| ID аккаунта пользователя, принадлежащего этому человеку. |
|
| Имя человека. |
|
| Фамилия человека. |
|
| Основной электронный адрес человека, который также используется как его имя пользователя в Workplace. |
|
| Должность человека в Workplace, если она указана с помощью API Account Management. |
|
| Организация человека в Workplace, если она указана с помощью API Account Management. |
|
| Подразделение человека в Workplace, если оно указано с помощью API Account Management. |
|
| Отдел человека в Workplace, если он указан с помощью API Account Management. |
|
| Основной номер телефона человека. Соответствует записи |
|
| Основной адрес человека. Соответствует записи |
|
| Фото профиля человека. |
|
| Ссылка на профиль человека. |
|
| Локаль человека. |
|
| Полное имя человека. |
|
| Имя человека, отформатированное для правильной обработки порядка слов на китайском, японском и корейском языках. |
|
| Время обновления. |
|
| Время приглашения в аккаунт, в формате UTC. |
|
| Время утверждения аккаунта, в формате UTC. |
|
| Время деактивации аккаунта в формате UTC. |
|
| Идентификатор участника, назначенный клиентом. Каждый участник МОЖЕТ иметь непустой идентификатор external_id, заданный с помощью API Account Management. Workplace никогда не назначает атрибут external_id. |
|
| Дата и время поступления человека на работу в компании, если они указаны с помощью API Account Management. |
|
| Биография человека. |
|
| Название центра затрат. |
|
| Маркер доступа участника, который позволяет интеграции совершать вызовы от имени определенного человека. Разрешение выдавать себя за другого пользователя устарело. Не используйте его ни в каких новых функциях. Это разрешение доступно только пользовательским интеграциям, для которых оно включено. |
|
| Содержит ссылку, перейдя по которой, пользователь может утвердить свой аккаунт Workplace (только для неутвержденных пользователей). |
|
| Предоставляет код доступа, с помощью которого пользователь может утвердить свой аккаунт Workplace (только для неутвержденных пользователей). |
|
| Локаль пользователя. Это локаль, которую Workplace будет использовать для этого пользователя в отсутствие другого способа определить локаль пользователя (например, через настройку языка браузера или устройства). |
|
| Информация о статусе неофисной работы пользователя. |
|
| Признак активности аккаунта пользователя. |
|
См. документацию по API Account Management (Graph).
См. документацию по API Account Management (Graph).
Имя границы | Описание |
---|---|
События для этого человека. По умолчанию сюда не входят события, которые человек отклонил или на которые не ответил. | |
Лента публикаций (в том числе обновления статуса) и ссылок, опубликованных человеком. | |
| Сообщения человека или страницы бота в Workplace. Для просмотра переписок человека требуется разрешение на чтение всех сообщений. |
| Один или несколько руководителей человека. |
| Подчиненные человека. |
Фото профиля участника. | |
| Группы, связанные с участником. |
| Номера телефонов, связанные с участником. |
| Навыки участника. |
| Значки, которыми награжден пользователь. |
| Выход пользователя из Workplace. Только для запросов |
Удаление информации профиля для отключенного пользователя. Только для запросов |
GET /{member_id}?fields=email,name HTTP/1.1
Host: graph.facebook.com
GET /{email_address} HTTP/1.1
Host: graph.facebook.com
GET /community/members?external_ids=12356,abc123 HTTP/1.1
Host: graph.facebook.com
GET /community/organization_members?inactive=1 HTTP/1.1
Host: graph.facebook.com
GET graph.facebook.com
/{member-id}/events
GET /{member_id}/reports HTTP/1.1
Host: graph.facebook.com
GET /{member_id}/managers HTTP/1.1
Host: graph.facebook.com
Требуется маркер пользовательской интеграции с разрешением на чтение всех сообщений.
GET graph.facebook.com
/{member-id}/conversations?fields=messages{message,attachments,from}
Требуется маркер пользовательской интеграции с разрешением на чтение всех сообщений.
GET graph.facebook.com
/{member-id}/conversations
Требуется маркер пользовательской интеграции с разрешением на чтение всех сообщений.
GET graph.facebook.com
/{thread-id}/messages?user={user-id}
GET graph.facebook.com
/me/conversations?fields=messages{message,attachments}
При использовании маркера пользовательской интеграции псевдоним /me
указывает на страницу бота.
Требуется маркер пользовательской интеграции с разрешением на удаление сообщений чата.
DELETE graph.facebook.com
/{message-id}?user={user-id}
Сообщение удаляется только из представления участника, указанного в запросе. Чтобы сообщение удалилось полностью, необходимо удалить его представление у каждого пользователя.
Требуется маркер пользовательской интеграции с разрешением на управление аккаунтами.
GET graph.facebook.com
/{member-id}?fields=account_invite_time,account_claim_time
Эти поля присутствуют, только если пользователь был приглашен в аккаунт или утвердил его.
Требуется маркер пользовательской интеграции с разрешением на управление аккаунтами.
GET graph.facebook.com
/{member-id}?fields=account_deactivate_time
Эти поля присутствуют, только если аккаунт пользователя деактивирован.
Требуется маркер доступа с разрешением на выход.
POST graph.facebook.com
/{member-id}/logout
Требуется маркер доступа с разрешением на управление рабочими профилями. Запрос поддерживает как передачу URL файла, так и его загрузку.
POST graph.facebook.com
/{member-id}/profile_pictures?
image_url={...}&
caption={...}
POST graph.facebook.com
/{member-id}/profile_pictures?
caption={...}
Content-Type: multipart/form-data;
Content-Disposition: form-data; name="image_data"; filename="/profile_picture.png
Требуется маркер доступа с разрешением на управление рабочими профилями.
POST graph.facebook.com
/{member-id}/phones?
type={...}&
primary={...}&
number={...}
Требуется маркер доступа с разрешением на чтение рабочего профиля.
GET graph.facebook.com
/{member-id}/skills
Требуется маркер доступа с разрешением на управление рабочими профилями.
POST graph.facebook.com
/{member-id}/skills?name={...}
Требуется маркер доступа с разрешением на управление рабочими профилями.
DELETE graph.facebook.com
/{member-id}/skills?name={...}
Требуется маркер доступа с разрешением на чтение рабочего профиля.
GET graph.facebook.com
/{member-id}/badges?fields=id,name,description,icon,category
Требуется маркер доступа с разрешением на управление значками. Список доступных значков и их идентификаторов см. в документации сообщества.
POST graph.facebook.com
/{member-id}/badges?badge=workplace_champion
Требуется маркер доступа с разрешением на управление значками. Список доступных значков и их ID см. в документации сообщества. Обратите внимание, что содержащийся в URL знак "#" должен быть в кодировке URL.
POST graph.facebook.com
/{member-id}/badges?badge=workplace_custom#{badge_id}
Требуется маркер доступа с разрешением на подготовку аккаунтов пользователей.
POST graph.facebook.com
/{member-id}?active=false
Требуется маркер доступа с разрешением на подготовку аккаунтов пользователей.
DELETE graph.facebook.com
/{member-id}
Удалить можно только неутвержденных участников.
GET graph.facebook.com
/{user-id}?fields=frontline
{
"frontline": {
"is_frontline": true
},
"id": "100038142594104"
}