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

Тип ресурса channel

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

Методы

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

Свойства

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

значения channelMembershipType

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

Значения migrationMode

Member Описание
Inprogress Канал или чат перешел в режим миграции.
Завершена Канал или чат выходит из режима миграции.
unknownFutureValue Изменяемое значение перечисления sentinel. Не используйте.

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

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

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

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

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

Связи

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

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

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

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)",
  "isFavoriteByDefault": true,
  "email": "string",
  "webUrl": "string",
  "membershipType": "String",
  "migrationMode": "String",
  "layoutType": "string",
  "isArchived": false,
  "createdDateTime": "string (timestamp)",
  "originalCreatedDateTime": "String (timestamp)",
  "moderationSettings": { "@odata.type": "microsoft.graph.channelModerationSettings" }
}

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

  • Last updated on