Pubblicare un'app personalizzata inviata tramite l'API Teams per l'invio di appPublish a custom app submitted through the Teams App Submission API

PanoramicaOverview

Nota

Quando si pubblica un'app Teams personalizzata, questa è disponibile per gli utenti nell'app store dell'organizzazione.When you publish a custom Teams app, it's available to users in your organization's app store. Esistono due modi per pubblicare un'app personalizzata e il modo in cui si usa dipende da come si ottiene l'app.There are two ways to publish a custom app and the way that you use depends on how you get the app. Questo articolo illustra come approvare e pubblicare un'app personalizzata che uno sviluppatore invia tramite l'API Teams di invio delle app.This article focuses on how to approve and publish a custom app that a developer submits through the Teams App Submission API. L'altro metodo, il caricamento di un'app personalizzata, viene usato quando uno sviluppatore invia un pacchetto dell'app in .zip formato.The other method, uploading a custom app, is used when a developer sends you an app package in .zip format. Per altre informazioni su questo metodo, vedere Pubblicare un'app personalizzata caricando un pacchetto dell'app.To learn more about that method, see Publish a custom app by uploading an app package. Il widget approva app non è disponibile nei tenant GCC app.The approve app widget isn't available in GCC tenants.

Importante

Questo metodo non è attualmente disponibile per gli GCC locali.This method is not currently available for GCC environments. È necessario usare il metodo di caricamento di un'app personalizzata.You must use the uploading a custom app method.

Questo articolo fornisce indicazioni end-to-end su come portare l'app Teams dallo sviluppo alla distribuzione all'individuazione.This article provides end-to-end guidance for how to take your Teams app from development to deployment to discovery. Si otterrà una panoramica delle esperienze connesse che Teams offre nel ciclo di vita dell'app per semplificare lo sviluppo, la distribuzione e la gestione di app personalizzate nell'app store dell'organizzazione.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.

Verranno esaminati tutti i passaggi del ciclo di vita, incluso il modo in cui gli sviluppatori possono usare l'API di invio delle app di Teams per inviare app personalizzate direttamente all'interfaccia di amministrazione di Microsoft Teams per poterle rivedere e approvare, come impostare criteri per gestire le app per gli utenti dell'organizzazione e come vengono individuate dagli utenti in 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.

Panoramica dell'app dallo sviluppo alla distribuzione

Questa guida è incentrata sugli aspetti Teams'app ed è destinata agli amministratori e ai professionisti IT.This guidance focuses on the Teams aspects of the app and is intended for admins and IT pros. Per informazioni sullo sviluppo di Teams, vedere la documentazione Teams per sviluppatori.For information about developing Teams apps, see the Teams developer documentation.

SviluppoDevelop

Creare l'appCreate the app

La Microsoft Teams per sviluppatori consente agli sviluppatori di integrare facilmente le proprie app e servizi per migliorare la produttività, prendere decisioni più velocemente e creare collaborazione su contenuti e flussi di lavoro esistenti.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. Le app create sulla piattaforma Teams sono ponti tra il client di Teams e i servizi e i flussi di lavoro, portandoli direttamente nel contesto della piattaforma di collaborazione.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. Per altre informazioni, vedere la documentazione Teams per sviluppatori.For more information, go to the Teams developer documentation.

Inviare l'appSubmit the app

Quando l'app è pronta per l'uso nell'ambiente di produzione, lo sviluppatore può inviare l'app usando l'API di invio dell'app Teams, che può essere chiamata dall'API Graph, da un ambiente di sviluppo integrato (IDE) come Visual Studio Code o da una piattaforma come Power Apps e Power Virtual Agents.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. In questo modo l'app sarà disponibile nella pagina Gestisci app dell'interfaccia di amministrazione di Microsoft Teams, in cui l'amministratore potrà rivedirla e approvarla.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

L'API di invio delle app di Teams, basata su Microsoft Graph,consente all'organizzazione di svilupparsi sulla piattaforma scelta e automatizza il processo di invio all'approvazione per le app personalizzate in 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.

Ecco un esempio dell'aspetto di questo passaggio di invio dell'app in Visual Studio Code:Here's an example of what this app submission step looks like in Visual Studio Code:

invio di un'app in Visual Studio Code

Tenere presente che non è ancora possibile pubblicare l'app nell'app store dell'organizzazione.Keep in mind that this doesn't publish the app to your organization's app store yet. Questo passaggio invia l'app all'Microsoft Teams di amministrazione, dove è possibile approvarla per la pubblicazione nell'app store dell'organizzazione.This step submits the app to the Microsoft Teams admin center where you can approve it for publishing to your organization's app store.

Per altre informazioni sull'uso dell'API Graph per inviare app, vedere qui.For more information about using the Graph API to submit apps, see here.

ConvalidaValidate

La pagina Gestisci app nell'interfaccia di amministrazione di Microsoft Teams (nel riquadro di spostamento sinistro passare Teams app Gestisci app) offre una visualizzazione in tutte le app Teams per l'organizzazione. > 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. Il widget Approvazione in sospeso nella parte superiore della pagina indica quando un'app personalizzata viene inviata per l'approvazione.The Pending approval widget at the top of the page lets you know when a custom app is submitted for approval.

Nella tabella, un'app appena inviata mostra automaticamente lo stato Di pubblicazione inviato e lo stato Bloccato.In the table, a newly submitted app automatically shows a Publishing status of Submitted and Status of Blocked. È possibile ordinare la colonna Stato pubblicazione in ordine decrescente per trovare rapidamente l'app.You can sort the Publishing status column in descending order to quickly find the app.

stato di pubblicazionepublishing status

Fare clic sul nome dell'app per passare alla pagina dei dettagli dell'app.Click the app name to go to the app details page. Nella scheda Informazioni è possibile visualizzare i dettagli sull'app, tra cui descrizione, stato, mittente e ID app.On the About tab, you can view details about the app, including description, status, submitter, and app ID.

Pagina dei dettagli dell'app per un'app inviata

Per altre informazioni sull'uso dell'API Graph per controllare lo stato di pubblicazione, vedere qui.For more information about using the Graph API to check the Publishing status, see here.

PubblicaPublish

Quando si è pronti per rendere disponibile l'app agli utenti, pubblicare l'app.When you're ready to make the app available to users, publish the app.

  1. Nel riquadro di spostamento sinistro dell'interfaccia di amministrazione di Microsoft Teams, passare ad App di Teams > Gestisci app.In the left navigation of the Microsoft Teams admin center, go to Teams apps > Manage apps.

  2. Fare clic sul nome dell'app per passare alla pagina dei dettagli dell'app e quindi nella casella Stato pubblicazione selezionare Pubblica.Click the app name to go to the app details page, and then in the Publishing status box, select Publish.

    Dopo la pubblicazione dell'app, lo stato della pubblicazione viene modificato in Pubblicato e lo stato viene automaticamente modificato in Consentito.After you publish the app, the Publishing status changes to Published and the Status automatically changes to Allowed.

Configurare e gestireSet up and manage

Controllare l'accesso all'appControl access to the app

Per impostazione predefinita, tutti gli utenti dell'organizzazione possono accedere all'app nell'app store dell'organizzazione.By default, all users in your organization can access the app in your organization's app store. Per limitare e controllare gli utenti autorizzati a usare l'app, è possibile creare e assegnare criteri di autorizzazione per l'app.To restrict and control who has permission to use the app, you can create and assign an app permission policy. Per altre informazioni, vedere Gestire i criteri di autorizzazione delle app in teams.To learn more, see Manage app permission policies in Teams.

Aggiungere e installare l'app per consentire agli utenti di individuarePin and install the app for users to discover

Per impostazione predefinita, gli utenti possono trovare l'app che devono accedere all'app store dell'organizzazione e cercarla o cercarla.By default, for users to find the app they have to go to your organization's app store and browse or search for it. Per consentire agli utenti di accedere facilmente all'app, è possibile aggiungere l'app alla barra dell'app in Teams.To make it easy for users to get to the app, you can pin the app to the app bar in Teams. A questo scopo, creare un criterio di configurazione dell'app e assegnarlo agli utenti.To do this, create an app setup policy and assign it to users. Per altre informazioni, vedere Gestire i criteri di configurazione delle app in teams.To learn more, see Manage app setup policies in Teams.

Cercare nel log di controllo gli Teams dell'appSearch the audit log for Teams app events

È possibile eseguire ricerche nel log di controllo per visualizzare Teams attività delle app nell'organizzazione.You can search the audit log to view Teams apps activity in your organization. Per altre informazioni su come eseguire ricerche nel log di controllo e visualizzare un elenco delle attività di Teams registrate nel log di controllo, vedere Cercare eventi nel log di controllo in 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.

Prima di poter eseguire ricerche nel log di controllo, è necessario attivare il controllo nel Centro sicurezza e conformità.Before you can search the audit log, you have to first turn on auditing in the Security & Compliance Center. Per altre informazioni, vedere Attivare o disattivare la ricerca nel log di controllo.To learn more, see Turn audit log search on or off. Tenere presente che i dati di controllo sono disponibili solo dal momento in cui è stato attivato il controllo.Keep in mind that audit data is only available from the point at which you turned on auditing.

Scopri e adottaDiscover and adopt

Gli utenti che hanno le autorizzazioni per l'app possono trovarla nell'app store dell'organizzazione.Users who have permissions to the app can find it in your organization's app store. Passare a Creato per il nome dell'organizzazione nella pagina App per trovare le app personalizzate dell'organizzazione.Go to Built for Your Organization Name on the Apps page to find your organization's custom apps.

Pagina Delle app che mostra l'app pubblicataApps page showing published app

Se sono stati creati e assegnati criteri di configurazione dell'app, l'app viene aggiunta alla barra dell'app in Teams per un facile accesso per gli utenti a cui è stato assegnato il criterio.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.

AggiornamentoUpdate

Per aggiornare un'app, gli sviluppatori devono continuare a seguire i passaggi della sezione Sviluppo.To update an app, developers should continue to follow the steps in the Develop section.

Quando lo sviluppatore invia un aggiornamento a un'app personalizzata pubblicata, si otterrà una notifica nel widget Approvazione in sospeso della pagina Gestisci app.When the developer submits an update to a published custom app, you'll get notified in the Pending approval widget of the Manage apps page. Nella tabella lo stato di pubblicazione dell'app sarà impostato su Aggiorna inviato.In the table, the Publishing status of the app will be set to Update submitted.

Pagina Gestisci app con le richieste in sospeso e lo stato dell'appManage apps page showing pending requests and app status

Per rivedere e pubblicare un aggiornamento dell'app:To review and publish an app update:

  1. Nel riquadro di spostamento sinistro dell'interfaccia di amministrazione di Microsoft Teams, passare ad App di Teams > Gestisci app.In the left navigation of the Microsoft Teams admin center, go to Teams apps > Manage apps.

  2. Fare clic sul nome dell'app per passare alla pagina dei dettagli dell'app e quindi selezionare Aggiorna disponibile per esaminare i dettagli dell'aggiornamento.Click the app name to go to the app details page, and then select Update available to review details of the update.

    pagina dei dettagli dell'app

  3. Al termine, selezionare Pubblica per pubblicare l'aggiornamento.When you're ready, select Publish to publish the update. In questo modo l'app esistente viene sostituita, il numero di versione viene aggiornato e lo stato di pubblicazione viene modificato in Pubblicato.Doing this replaces the existing app, updates the version number, and changes the Publishing status to Published. Tutti i criteri di autorizzazione delle app e i criteri di configurazione delle app rimangono applicati per l'app aggiornata.All app permission policies and app setup policies remain enforced for the updated app.

    Se si rifiuta l'aggiornamento, la versione precedente dell'app rimane pubblicata.If you reject the update, the earlier version of the app remains published.

Tenere presente quanto segue:Keep in mind the following:

  • Quando un'app viene approvata, qualsiasi utente può inviare un aggiornamento all'app.When an app is approved, any one can submit an update to the app. Questo significa che altri sviluppatori, incluso lo sviluppatore che ha originariamente inviato l'app, possono inviare un aggiornamento all'app.This means other developers, including the developer who originally submitted the app, can submit an update to the app.
  • Quando uno sviluppatore invia un'app e la richiesta è in sospeso, solo lo stesso sviluppatore può inviare un aggiornamento all'app.When a developer submits an app and the request is pending, only that same developer can submit an update to the app. Gli altri sviluppatori possono inviare un aggiornamento solo dopo l'approvazione dell'app.Other developers can submit an update only after the app is approved.

Per altre informazioni sull'uso dell'API Graph per aggiornare le app, vedere qui.For more information about using the Graph API to update apps, see here.