Publicar aplicativos no catálogo de aplicativos da sua organizaçãoPublish apps to your organization's app catalog

Importante

As /beta APIs na versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported.

Publicar um aplicativo no catálogo de aplicativos do Microsoft Teams.Publish an app to the Microsoft Teams apps catalog. Especificamente, essa API publica o aplicativo no catálogo da sua organização (o catálogo de aplicativos do locatário); o recurso distributionMethod = organizationcriado terá.Specifically, this API publishes the app to your organization's catalog (the tenant app catalog); the created resource will have distributionMethod = organization.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Observação: Somente os administradores globais podem chamar esta API.Note: Only global administrators can call this API.

Tipo de permissãoPermission Type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) AppCatalog.ReadWrite.AllAppCatalog.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporteNot supported
AplicativoApplication Sem suporteNot supported

Solicitação HTTPHTTP request

POST /appCatalogs/teamsApps

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type aplicativo/zipapplication/zip

Corpo da solicitaçãoRequest body

Carga do manifesto zip do teams.Teams Zip Manifest Payload. Para o arquivo zip do aplicativo do Teams, consulte criar um pacote de aplicativos.For Teams application zip file see Create an app package. Você não pode criar um aplicativo para uma organização que tenha a mesma ID de manifesto que outro aplicativo da organização.You can't create an app for an organization that has the same manifest ID as another app in that organization.

RespostaResponse

Se tiver êxito, este método retornará 200 OK um código de resposta e um objeto teamsCatalogApp .If successful, this method returns a 200 OK response code and a teamsCatalogApp object.

ExemploExample

SolicitaçãoRequest

POST https://graph.microsoft.com/beta/appCatalogs/teamsApps
Content-type: application/zip
Content-length: 244

[Zip file containing a Teams app package]

Para obter informações sobre como criar um arquivo zip do aplicativo do Microsoft Teams, consulte criar um pacote de aplicativos.For information about how to create a Microsoft Teams application zip file, see Create an app package.

RespostaResponse

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "e3e29acb-8c79-412b-b746-e6c39ff4cd22",
  "externalId": "b5561ec9-8cab-4aa3-8aa2-d8d7172e4311",
  "name": "Test App",
  "version": "1.0.0",
  "distributionMethod": "organization"
}