Тип ресурса channel

Пространство имен: microsoft.graph

Команды состоят из каналов, являющихся беседами с сотрудниками. Каждый канал предназначен для определенной темы, отдела или проекта. Каналы — это место, где фактически выполняется работа. В них проходят командные обсуждения с помощью текста, аудио и видео, а также выполняется обмен файлами и добавление вкладок.

Методы

Метод	Возвращаемый тип	Описание
Перечисление каналов	Коллекция channel	Получение списка каналов в команде.
Создание канала	channel	Создание нового канала путем добавления отображаемого имени и описания.
Получение канала	channel	Чтение свойств и связей канала.
Обновление канала	channel	Обновление свойств канала.
Удаление канала	Нет	Удаление канала.
Получение дельты сообщения	chatMessage	Получение добавочных сообщений в канале.
Перечисление сообщений в каналах	chatMessage	Получение сообщений в канале
Получение всех сообщений в канале	Коллекция channel	Получайте все сообщения каналов, в которые входит пользователь.
Создание сообщения канала	chatMessage	Отправка сообщения в канал.
Создание ответа на сообщение канала	chatMessage	Ответ на сообщение в канале.
Получение папки с файлами	driveItem	Получение сведений о папке SharePoint, в которой хранятся файлы канала.
Перечисление вкладок	teamsTab	Перечисление вкладок, закрепленных в канале.
Перечисление участников канала	Коллекция conversationMember	Получение списка участников канала.
Добавление участника канала	conversationMember	Добавление участника в канал. Поддерживается только для channel с типом членства private.
Получение участника канала	Коллекция conversationMember	Получение участника канала.
Обновление роли участника канала	conversationMember	Обновление свойства участника канала. Поддерживается только для канала с типом членства private.
Удаление участника канала	Нет	Удаление участника канала. Поддерживается, только если параметру channelType присвоено значение private.
Завершение миграции	channel	Удаление режима миграции из канала, после чего канал становится доступным для публикации и чтения сообщений пользователями.
Перечисление вкладок в канале	teamsTab	Перечисление вкладок, закрепленных на канале.
Добавление вкладки в канал	teamsTab	Добавление (закрепление) вкладки на канал.
Получение вкладки на канале	teamsTab	Получение определенной вкладки, закрепленной на канале.
Вкладка "обновление" на канале	teamsTab	Обновляет свойства вкладки на канале.
Удаление вкладки из канала	Нет	Удаление (открепление) вкладки из канала.
Подготовка адреса электронной почты канала	provisionChannelEmailResult	Подготовка адреса электронной почты для канала.
Удаление адреса электронной почты канала	Нет	Удаление адреса электронной почты канала.

Свойства

Свойство	Тип	Описание
description	String	Необязательное текстовое описание канала.
displayName	String	Имя канала, отображаемое для пользователя в Microsoft Teams.
id	String	Уникальный идентификатор канала. Только для чтения.
isFavoriteByDefault	Логический	Указывает, должен ли канал автоматически помечаться как "Избранное" для всех участников команды. Задается только программными средствами с помощью Создания группы. Значение по умолчанию: false.
email	String	Адрес электронной почты для отправки сообщений в канал. Только для чтения.
webUrl	String	Гиперссылка, ведущая к каналу в Microsoft Teams. Это URL-адрес, получаемый при щелчке правой кнопкой мыши по каналу в Microsoft Teams и выборе пункта "Получить ссылку на канал". Этот URL-адрес должен обрабатываться как непрозрачный BLOB-объект и не должен анализироваться. Только для чтения.
membershipType	channelMembershipType	Тип канала. Можно настроить во время создания и нельзя изменить. Возможные значения: standard — канал наследует список участников родительской команды; private — в канале могут быть участники, которые являются подмножеством всех участников родительской команды.
createdDateTime	dateTimeOffset	Только для чтения. Метка времени создания канала.

Атрибуты экземпляра

Атрибуты экземпляра — это свойства с особым поведением. Эти свойства — временные и а) определяют поведение выполнения службы; или б) предоставляют краткосрочные значения свойств, например URL-адрес скачивания элемента, у которого истекает срок действия.

Имя свойства	Тип	Описание
@microsoft.graph.channelCreationMode	Строка	Указывает, что канал находится в состоянии миграции и в настоящее время используется для миграции. Принимает одно значение: migration.

Примечание: channelCreationMode – перечисление, принимающее значение migration.

Пример запроса POST см. в разделе Запрос (создание канала в состоянии миграции).

Связи

Связь	Тип	Описание
messages	Коллекция chatMessage	Коллекция всех сообщений в канале. Свойство навигации. Допускается значение NULL.
tabs	Коллекция teamsTab	Коллекция всех вкладок в канале. Свойство навигации.
members	Коллекция conversationMember	Коллекция записей участников, сопоставленных с каналом.
filesFolder	driveItem	Метаданные для расположения, в котором хранятся файлы канала.
operations	Коллекция teamsAsyncOperation	Асинхронные операции, которые выполнялись или выполняются для этой команды.

Представление JSON

Ниже указано представление ресурса в формате JSON.

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)",
  "isFavoriteByDefault": true,
  "email": "string",
  "webUrl": "string",
  "membershipType": "channelMembershipType",
  "createdDateTime": "string (timestamp)"
}