Поделиться через

Тип ресурса channel

  • Статья

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

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

Методы

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

Свойства

Свойство Тип Описание
createdDateTime dateTimeOffset Только для чтения. Метка времени создания канала.
description String Необязательное текстовое описание канала.
displayName String Имя канала, отображаемое для пользователя в Microsoft Teams. Максимальная длина — 50 символов.
email String Адрес электронной почты для отправки сообщений в канал. Только для чтения.
id String Уникальный идентификатор канала. Только для чтения.
isArchived Boolean Указывает, архивирован ли канал. Только для чтения.
isFavoriteByDefault Логический Указывает, следует ли пометить канал как рекомендуемый, чтобы все участники команды отображались в списке каналов. Заметка: Все рекомендуемые каналы автоматически отображаются в списке каналов для образовательных и внешних рабочих пользователей. Свойство можно задать только программным способом с помощью метода Create team . Значение по умолчанию — false.
membershipType channelMembershipType Тип канала. Можно настроить во время создания и нельзя изменить. Допустимые значения: standard, private, unknownFutureValue, shared. Значение по умолчанию — standard. Обратите внимание, что требуется использоваться заголовок запроса Prefer: include-unknown-enum-members, чтобы получить следующее значение в этом расширяемом перечислении: shared.
tenantId string Идентификатор клиента Microsoft Entra.
webUrl String Гиперссылка, ведущая к каналу в Microsoft Teams. Это URL-адрес, получаемый при щелчке правой кнопкой мыши по каналу в Microsoft Teams и выборе пункта "Получить ссылку на канал". Этот URL-адрес должен обрабатываться как непрозрачный BLOB-объект и не должен анализироваться. Только для чтения.
summary channelSummary Содержит сводную информацию о канале, включая количество владельцев, участников, гостей и индикатор для участников из других клиентов. Свойство summary будет возвращено только в том случае, если оно указано в предложении $select метода Get channel .

значения channelMembershipType

Member Описание
стандарт Канал наследует список членов родительская команда.
частный В канале могут быть члены, которые являются подмножеством всех членов на родительская команда.
unknownFutureValue Изменяемое значение перечисления sentinel. Не следует использовать.
общие Участники могут быть напрямую добавлены в канал, не добавляя их в команду.

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

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

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

Примечание. channelCreationMode — это перечисление, которое принимает значение migration.

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

Связи

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

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

В следующем представлении JSON показан тип ресурса.

{
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "email": "String",
  "id": "String (identifier)",
  "isArchived": "Boolean",
  "isFavoriteByDefault": "Boolean",
  "membershipType": "String",
  "webUrl": "String"
}

Связанные материалы