Настройка встроенных типов вкладок в Microsoft Teams

  • Статья

Чтобы создать или настроить вкладку Microsoft Teams с помощью API Graph Майкрософт, необходимо знать teamsAppId приложение, а entityIdтакже , contentUrlremoveUrl, и websiteUrl предоставить для этого типа приложения. В этой статье объясняется, как получить эти значения для встроенных типов вкладок.

Настраиваемые вкладки

Чтобы использовать Microsoft Graph для настройки вкладки, связанной с поставщиком вкладок, которого вы записали, определите значения entityId, contentUrl, removeUrl и websiteUrl, предоставляемые интерфейсом конфигурации приложения для Microsoft Teams, и передайте эти же значения entityId, contentUrl, removeUrl и websiteUrl в Microsoft Graph.

Объект teamsAppId аналогичен id в схеме манифеста приложения для Microsoft Teams.

Вкладки веб-сайтов

Для вкладок веб-сайтов объекту teamsAppId соответствует com.microsoft.teamspace.tab.web. Ниже приведена конфигурация.

Свойство Тип Описание
entityId string NULL
contentUrl строка URL-адрес веб-сайта
removeUrl строка NULL
websiteUrl строка URL-адрес веб-сайта

Вкладки Word, Excel, PowerPoint и PDF

В таблице ниже указаны teamsAppId для каждого приложения.

Приложение teamsAppId Тип (расширение)
Word com.microsoft.teamspace.tab.file.staticviewer.word docx
Excel com.microsoft.teamspace.tab.file.staticviewer.excel xlsx
PowerPoint com.microsoft.teamspace.tab.file.staticviewer.powerpoint pptx
PDF com.microsoft.teamspace.tab.file.staticviewer.pdf pdf

Ниже приведена конфигурация.

Свойство Тип Описание
entityId string Идентификатор sourceDoc для файла. Вы найдете его, открыв файл в SharePoint и посмотрев на адресную строку — URL-адрес будет иметь предложение sourcedoc=%7B{sourceDocId}%7D. Вы также можете получить эти данные из webUrl адреса элемента диска SharePoint для документа. Дополнительные сведения см.GET /groups/{group-id}/drive/items/{item-id}.
contentUrl string URL-адрес документ в формате {folder-webUrl}/{item-name}. {folder-webUrl} - это webUrl адрес папки SharePoint, содержащей файл, который можно найти путем открытия файла в SharePoint и просмотра адресной строки, либо с помощью свойства webUrl из GET /groups/{group-id}/drive/items/{folder-item-id}. {item-name} соответствует имени файла (например, file.docx), которое является свойством name в GET /groups/{group-id}/drive/items/{item-id}.
removeUrl строка NULL
websiteUrl string Null

Пример: создание настроенной вкладки Word

Приведенный ниже пример создает настроенную вкладку Word.

POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/tabs
{
  "displayName": "word",
  "teamsApp@odata.bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/com.microsoft.teamspace.tab.file.staticviewer.word",
  "configuration": {
     "entityId": "115A90F4-AC9C-4F79-9837-36D1EFB3BE08",
     "contentUrl": "https://m365x165177.sharepoint.com/sites/4NewCloneWithClonableParts/Shared%20Documents/General/Employee Handbook.docx",
     "removeUrl": null,
     "websiteUrl": null
  }
}

Вкладки библиотеки документов

Для вкладок библиотеки документов объекту teamsAppId соответствует com.microsoft.teamspace.tab.files.sharepoint. Ниже приведена конфигурация.

Свойство Тип Описание
entityId string Пустая строка ("")
contentUrl string URL-адрес корневой папки библиотеки документов. Этот URL-адрес можно найти, открыв папку SharePoint в браузере, скопировав URL-адрес и удалив "/Forms/AllItems.aspx" и все после этого.
removeUrl строка NULL
websiteUrl string Null

Пример. Создание настроенной вкладки библиотеки документов

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

POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/tabs
{
    "displayName": "Document%20Library1",
    "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/com.microsoft.teamspace.tab.files.sharepoint",
    "configuration": {
        "entityId": "",
        "contentUrl": "https://microsoft.sharepoint.com/teams/WWWtest/Shared%20Documents",
        "removeUrl": null,
        "websiteUrl": null
    }
}

Вкладки вики-сайта

Для вкладок вики-сайта объекту teamsAppId соответствует com.microsoft.teamspace.tab.wiki. Вики-вкладки не поддерживают настройку с помощью Microsoft Graph. Обратите внимание, однако, что настроить не так много. На ненастроенной вики-вкладке первый пользователь должен просто выбрать вкладку Настройка , чтобы настроить ее.

Вкладки Планировщика

Для Планировщик вкладок teamsAppId имеет значение com.microsoft.teamspace.tab.planner. Конфигурация не поддерживается.

Вкладки Microsoft Stream

Для вкладок Microsoft Stream объекту teamsAppId соответствует com.microsoftstream.embed.skypeteamstab. Конфигурация не поддерживается.

Вкладки Microsoft Forms

Для вкладок Microsoft Forms объекту teamsAppId соответствует 81fef3a6-72aa-4648-a763-de824aeafb7d. Конфигурация не поддерживается.

Вкладки OneNote

Для вкладок OneNote объекту teamsAppId соответствует 0d820ecd-def2-4297-adad-78056cde7c78. Конфигурация не поддерживается.

Вкладки Power BI

Для вкладок Power BI объекту teamsAppId соответствует com.microsoft.teamspace.tab.powerbi. Конфигурация не поддерживается.

Вкладки страниц и списков SharePoint

Для вкладок страниц и списков SharePoint объекту teamsAppId соответствует 2a527703-1f6f-4559-a332-d8a7d288cd88. Конфигурация не поддерживается.

вкладки на основе SharePoint Framework

Пользовательские вкладки, созданные с помощью SharePoint Framework, можно создать с помощью Microsoft Graph, но конфигурация не поддерживается.

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