Публикация пользовательского приложения, добавленного с помощью API-приложения TeamsPublish a custom app submitted through the Teams App Submission API

ОбзорOverview

Примечание

Публикуемое приложение Teams доступно пользователям в магазине приложений вашей организации.When you publish a custom Teams app, it's available to users in your organization's app store. Существует два способа публикации пользовательского приложения и способа его использования зависит от способа получения приложения.There are two ways to publish a custom app and the way that you use depends on how you get the app. В этой статье рассматептуетсяо том, как утвердить и опубликовать пользовательское приложение, которое отправляет разработчик, с помощью API отправки приложения Teams.This article focuses on how to approve and publish a custom app that a developer submits through the Teams App Submission API. Другой способ: добавление пользовательского приложения используется при отправке пакета приложения в формате ZIP.The other method, uploading a custom app, is used when a developer sends you an app package in .zip format. Чтобы узнать больше об этом способе, опубликуйте пользовательское приложение, передав пакет приложения.To learn more about that method, see Publish a custom app by uploading an app package.

В этой статье приводятся краткие руководства по использованию приложения Teams от разработки до разработки до обнаружения.This article provides end-to-end guidance for how to take your Teams app from development to deployment to discovery. В нем представлен обзор подключенных возможностей Teams в различных циклах приложений, чтобы упростить разработку, развертывание и управление пользовательскими приложениями в магазине приложений вашей организации.You'll get an overview of the connected experiences that Teams provides across the app lifecycle to streamline how to develop, deploy, and manage custom apps in your organization's app store.

Мы рассмотрим все этапы жизненного цикла, в том числе о том, как разработчики могут использовать API отправки пользовательских приложений напрямую в Центр администрирования Microsoft Teams, чтобы просматривать и утверждать, настраивать политики для управления приложениями в организации и как пользователи их находит в Teams.We'll cover each step of the lifecycle, including how developers can use the Teams App Submission API to submit custom apps directly to the Microsoft Teams admin center for you to review and approve, how to set policies to manage apps for users in your organization, and how your users discover them in Teams.

Обзор приложения от разработки до развертывания

В этом руководстве описаны аспекты Teams и предназначены для администраторов и ИТ-специалистов.This guidance focuses on the Teams aspects of the app and is intended for admins and IT pros. Сведения о разработке приложений Teams см. в документации для разработчиков Teams.For information about developing Teams apps, see the Teams developer documentation.

РазработкаDevelop

Создание приложенияCreate the app

Платформа разработчиков Microsoft Teams позволяет разработчикам интегрировать свои приложения и службы для повышения производительности, ускорения решений и создания существующего контента и рабочих процессов.The Microsoft Teams developer platform makes it easy for developers to integrate your own apps and services to improve productivity, make decisions faster, and create collaboration around existing content and workflows. Приложения, созданные на платформе Teams, являются мостями между клиентом Teams, службами и рабочими процессами, которые переводят их непосредственно в контекст платформы для совместной работы.Apps built on the Teams platform are bridges between the Teams client and your services and workflows, bringing them directly into the context of your collaboration platform. Дополнительные сведения см. в документации для разработчиков Teams.For more information, go to the Teams developer documentation.

Отправка приложенияSubmit the app

Когда приложение будет готово к использованию в производстве, разработчик может отправить приложение с помощью API-файла отправки приложений Teams, который можно вызывать из API Graph API,интегрированной среде разработки (IDE) или Visual Studio платформы, например Power Apps и виртуальные агенты PowerPoint.When the app is ready for use in production, the developer can submit the app using the Teams App Submission API, which can be called from Graph API, an integrated development environment (IDE) such as Visual Studio Code, or a platform such as Power Apps and Power Virtual Agents. В результате приложение станет доступно на странице "Управление приложениями" Центра администрирования Microsoft Teams, где вы, администратор, сможете проверить и утвердить его.этоDoing this makes the app available on the Manage apps page of the Microsoft Teams admin center, where you, the admin, can review and approve it.this

API отправки приложения Teams, опубликованный в Microsoft Graph,позволяет разрабатывать на платформе выбранного приложения, а отправка пользовательских приложений в Teams выполняется автоматически.The Teams App Submission API, built on Microsoft Graph, allows your organization to develop on the platform of your choice and automates the submission-to-approval process for custom apps on Teams.

Вот как выглядит эта функция отправки приложения Visual Studio Код:Here's an example of what this app submission step looks like in Visual Studio Code:

Снимок экрана: отправка приложения в Visual Studio Код

Помните, что при этом приложение еще не опубликовано в магазине приложений вашей организации.Keep in mind that this doesn't publish the app to your organization's app store yet. Этот шаг отправляет приложение в Центр администрирования Microsoft Teams, где вы можете утвердить его для публикации в магазине приложений вашей организации.This step submits the app to the Microsoft Teams admin center where you can approve it for publishing to your organization's app store.

Дополнительные сведения об отправке приложений с помощью API Graph см. здесь.For more information about using the Graph API to submit apps, see here.

ПроверкаValidate

Страница "Управление приложениями" в Центре администрирования Microsoft Teams (в левой области навигации перейдите в приложения TeamsНа > панелиуправления приложениями), служит для просмотра всех приложений Teams для организации.The Manage apps page in the Microsoft Teams admin center (in the left navigation, go to Teams apps > Manage apps), gives you a view into all Teams apps for your organization. Мини-приложение ожидается в верхней части страницы сообщает, когда оно отправляется на утверждение.The Pending approval widget at the top of the page lets you know when a custom app is submitted for approval.

В таблице новое приложение автоматически укажет Publishing status состояние публикации с запросом "Отправлен" и Status "Состояние Submitted заблокированных". BlockedIn the table, a newly submitted app automatically shows a Publishing status of Submitted and Status of Blocked. Чтобы быстро найти приложение, можно отсортировать столбец состояния публикации в порядке убывания.You can sort the Publishing status column in descending order to quickly find the app.

Снимок экрана: страница "Управление приложениями", на которой показаны запросы ожиданиях и состояние приложенияScreenshot of Manage apps page showing pending requests and app status

Щелкните имя приложения, чтобы перейти на страницу сведений о приложении.Click the app name to go to the app details page. На вкладке "О программе" можно просмотреть сведения о приложении, включая описание, состояние, отправку и идентификатор приложения.On the About tab, you can view details about the app, including description, status, submitter, and app ID.

Снимок экрана: страница сведений о приложении для добавленного приложения

Дополнительные сведения об использовании API Graph для проверки состояния публикациисм. в этой статье.For more information about using the Graph API to check the Publishing status, see here.

ОпублиPublish

Когда приложение будет готово к старому доступу, опубликуйте его.When you're ready to make the app available to users, publish the app.

  1. В левой области навигации Центра администрирования Microsoft Teams перейдите в раздел "Управление > приложениями Teams".In the left navigation of the Microsoft Teams admin center, go to Teams apps > Manage apps.

  2. Щелкните имя приложения, чтобы перейти на страницу сведений о приложении, а затем в окне состояния публикации выберите "Опубликовать".Click the app name to go to the app details page, and then in the Publishing status box, select Publish.

    После публикации приложения состояние публикации изменится на "Опубликованное", а состояние автоматически изменится на "Разрешено".After you publish the app, the Publishing status changes to Published and the Status automatically changes to Allowed.

Настройка и управлениеSet up and manage

Управление доступом к приложениюControl access to the app

По умолчанию доступ к приложению могут получить все пользователи в организации в магазине приложений вашей организации.By default, all users in your organization can access the app in your organization's app store. Чтобы ограничить использование приложения и назначать политику разрешений на использование приложения, можно создать и назначить политику разрешений.To restrict and control who has permission to use the app, you can create and assign an app permission policy. Дополнительные сведения см. в разделе "Управление политиками разрешений приложений" в Teams.To learn more, see Manage app permission policies in Teams.

Закрепите и установите приложение для обнаружения пользователейPin and install the app for users to discover

По умолчанию пользователям нужно найти приложение, которое должно зайти в магазин приложений вашей организации, а затем найти или найти его.By default, for users to find the app they have to go to your organization's app store and browse or search for it. Чтобы упростить доступ пользователей к приложению, закрепите приложение на панели приложения в Teams.To make it easy for users to get to the app, you can pin the app to the app bar in Teams. Для этого создайте политику настройки приложений и назначьте ее пользователям.To do this, create an app setup policy and assign it to users. Дополнительные сведения см. в разделе "Управление политиками настройки приложений в Teams".To learn more, see Manage app setup policies in Teams.

Поиск событий приложения Teams в журнале аудитаSearch the audit log for Teams app events

В журнале аудита можно выполнять поиск в журнале аудита, чтобы просмотреть действия в приложениях Teams в вашей организации.You can search the audit log to view Teams apps activity in your organization. Дополнительные сведения о поиске в журнале аудита и просмотре списка действий Teams, регистрируемых в журнале аудита, см. в журнале аудита, в журнале аудита.To learn more about how to search the audit log and to see a list of Teams activities that are logged in the audit log, see Search the audit log for events in Teams.

Чтобы можно было выполнять поиск в журнале аудита, необходимо сначала включить аудит в Центре безопасности & Безопасности.Before you can search the audit log, you have to first turn on auditing in the Security & Compliance Center. Дополнительные сведения см. в статье "Включение и отключение поиска в журнале аудита".To learn more, see Turn audit log search on or off. Помните, что данные аудита доступны только в том месте, когда вы включили аудит.Keep in mind that audit data is only available from the point at which you turned on auditing.

Обнаружение и адаптацияDiscover and adopt

Пользователи с разрешениями на это приложение могут найти его в магазине приложений вашей организации.Users who have permissions to the app can find it in your organization's app store. Найдите **пользовательские Your Organization Name ** приложения своей организации на странице "Приложения".Go to Built for Your Organization Name on the Apps page to find your organization's custom apps.

Снимок экрана: страница "Приложения" с опубликованным приложениемScreenshot of Apps page showing published app

Если вы создали и назначили политику настройки приложения, оно закрепляется на панели приложения Teams для удобного доступа пользователей, которым была назначена политика.If you created and assigned an app setup policy, the app is pinned to the app bar in Teams for easy access for those users who were assigned the policy.

ОбновлениеUpdate

Чтобы обновить приложение, разработчикам нужно продолжать выполнять действия, описанные в разделе "Разработка".To update an app, developers should continue to follow the steps in the Develop section.

Когда разработчик отправляет обновление опубликованному пользовательскому приложению, вы получите уведомление на странице "Управление приложениями". Pending approvalWhen the developer submits an update to a published custom app, you'll get notified in the Pending approval widget of the Manage apps page. В таблице состояние публикации приложения будет настроено на обновление.In the table, the Publishing status of the app will be set to Update submitted.

Снимок экрана: страница "Управление приложениями", на которой показаны запросы ожиданиях и состояние приложенияScreenshot of Manage apps page showing pending requests and app status

Чтобы просмотреть и опубликовать обновление приложения, сделайте вот что:To review and publish an app update:

  1. В левой области навигации Центра администрирования Microsoft Teams перейдите в раздел "Управление > приложениями Teams".In the left navigation of the Microsoft Teams admin center, go to Teams apps > Manage apps.

  2. Щелкните имя приложения, чтобы перейти на страницу сведений о приложении, и выберите "Обновить доступное обновление", чтобы просмотреть сведения об обновлении.Click the app name to go to the app details page, and then select Update available to review details of the update.

    Снимок экрана: страница "Управление приложениями", на которой показаны запросы ожиданиях и состояние приложенияScreenshot of Manage apps page showing pending requests and app status

  3. Когда будете готовы, нажмите кнопку "Опубликовать", чтобы опубликовать обновление.When you're ready, select Publish to publish the update. При этом будет заменено существующее приложение, обновляется номер версии и изменяет состояние публикации на "Опубликованные".Doing this replaces the existing app, updates the version number, and changes the Publishing status to Published. Все политики разрешений приложений и политики настройки приложений остаются принудительно применяемыми к обновленному приложению.All app permission policies and app setup policies remain enforced for the updated app.

    Если отклонить обновление, более ранняя версия приложения останется опубликованной.If you reject the update, the earlier version of the app remains published.

Обратите особое описанное ниже.Keep in mind the following:

  • При утверждении приложения любой пользователь может отправить обновление приложению.When an app is approved, any one can submit an update to the app. Это означает, что другие разработчики, включая разработчик, который изначально отправил приложение, может отправить обновление приложению.This means other developers, including the developer who originally submitted the app, can submit an update to the app.
  • Когда разработчик отправляет приложение и ожидается, только этот разработчик может отправить обновление приложению.When a developer submits an app and the request is pending, only that same developer can submit an update to the app. Другие разработчики могут отправить обновление только после утверждения приложения.Other developers can submit an update only after the app is approved.

Дополнительные сведения об обновлении приложений Graph Graph см. здесь.For more information about using the Graph API to update apps, see here.

Обновление интерфейса для пользователейUpdate experience for users

В большинстве случаев после публикации обновления приложения новая версия автоматически появляется для пользователей.In most cases, after you publish an app update, the new version automatically appears for users. Однако для манифеста Microsoft Teams есть некоторые обновления, которые требуют принять пользователю прием.However, there are some updates to the Microsoft Teams manifest that require user acceptance to complete:

  • Бот добавлен или удаленA bot was added or removed
  • Изменено свойство "botId"An existing bot's "botId" property changed
  • Изменено свойство "isNotificationOnly"An existing bot's "isNotificationOnly" property changed
  • Изменено свойство "supportsFiles"The bot's "supportsFiles" property changed
  • Расширение для сообщенияA messaging extension was added or removed
  • Добавлена новая соединительная линияA new connector was added
  • Добавлена новая статическая вкладкаA new static tab was added
  • Добавлена новая вкладка с настраиваемой вкладкойA new configurable tab was added
  • Свойства внутри веб-приложения "WebApplicationInfo"Properties inside "webApplicationInfo" changed

Снимок экрана: приложения с доступной новой версией

Снимок экрана: параметры обновления приложения