Документация для разработчиков
Темная тема

sonet_group.create

Scope: sonet_group Права на выполнение: для всех

Описание

Создает группу соцсети, используя метод API CSocNetGroup::CreateGroup(), указывая владельцем группы текущего пользователя.

Запрос:

https://mydomain.bitrix24.ru/rest/sonet_group.create.json?auth=803f65e30340ff39703f8061c8b63a10&NAME=Test%20sonet%20group&VISIBLE=Y&OPENED=N&INITIATE_PERMS=K

Ответ:

{"result":11}

Параметры

Параметр Описание С версии
arFields Массив параметров новой группы. Допустимые ключи массива:
NAME - название группы (обязательное поле),
DESCRIPTION - описание группы,
VISIBLE - флаг Y/N - видна ли группа в списке групп,
OPENED - флаг Y/N - открыта ли группа для свободного вступления,
KEYWORDS - ключевые слова,
INITIATE_PERMS - кто имеет право на приглашение пользователей в группу (обязательное поле):
  • A - только владелец группы,
  • E - владелец группы и модераторы группы,
  • K - все члены группы.

CLOSED - флаг Y/N - является ли группа архивной,
SPAM_PERMS - кто имеет право на отправку сообщений в группу (обязательное поле). Значения аналогичны параметру INITIATE_PERMS.
PROJECT - флаг Y/N - является ли группа проектом или нет. по умолчанию - не является. (С версии 18.0.0)
PROJECT_DATE_FINISH - задаётся окончание проекта. (С версии 18.0.0)
PROJECT_DATE_START - задаётся начало проекта. (С версии 18.0.0)
SCRUM_MASTER_ID - если заполнен идентификатором пользователя, то этот проект станет скрамом. (С версии 22.300)
bAutoSubscribe Автоподписывание на созданную тему. Необязательный параметр. По умолчанию имеет значение True. 10.0.0

В случае успешного создания группы, возвращает ее ID, иначе - текст ошибки.


Примечание: Создавать экстранет-группы с помощью REST API пока нельзя.

Пример

// Создадим видимую и открытую для вступления группу соцсети с именем 'Test sonet group' с правом приглашать новых членов группы для всех текущих членов группы

BX24.callMethod('sonet_group.create', {
	'NAME': 'Test sonet group',
	'VISIBLE': 'Y',
	'OPENED': 'N',
	'INITIATE_PERMS': 'K'
});


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024