Тип ресурса 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)"
}