Listar os aplicativos publicados do catálogo de aplicativos do Microsoft TeamsList the published apps from the Microsoft Teams 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.

Listar aplicativos do catálogo de aplicativos do Microsoft Teams.List apps from the Microsoft Teams app catalog. Isso inclui os aplicativos do Microsoft Teams Store, bem como os aplicativos do catálogo de aplicativos da sua organização (o catálogo de aplicativos do locatário).This includes apps from the Microsoft Teams store, as well as apps from your organization's app catalog (the tenant app catalog). Para obter aplicativos apenas do catálogo de aplicativos da sua organização, Organization especifique como DistributionMethod no recurso teamsCatalogApp .To get apps from your organization's app catalog only, specify Organization as the distributionMethod in the teamsCatalogApp resource.

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

GET /appCatalogs/teamsApps

Parâmetros de consulta opcionaisOptional query parameters

Este método dá suporte aos Parâmetros de consulta OData $filter, $select e $expand para ajudar a personalizar a resposta.This method supports the $filter, $select, and $expand OData query parameters to help customize the response.

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.

Corpo da solicitaçãoRequest body

Nenhum.None.

Observação: Você pode filtrar em qualquer um dos campos do objeto teamsCatalogApp para diminuir a lista de resultados.Note: You can filter on any of the fields of the teamsCatalogApp object to shorten the list of results. Você pode usar qualquer uma das seguintes operações de filtro: igual, não igual, e, ou, e não.You can use any of the following filter operations: Equal, not-equal, and, or, and not.

RespostaResponse

Se tiver êxito, este método retornará 200 OK um código de resposta e uma lista de objetos teamsCatalogApp no corpo da resposta.If successful, this method returns a 200 OK response code and a list of teamsCatalogApp objects in the response body.

ExemplosExamples

Exemplo 1: listar todos os aplicativosExample 1: List all applications

O exemplo a seguir lista todos os aplicativos específicos do seu locatário.The following example lists all applications that are specific to your tenant.

SolicitaçãoRequest

GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=distributionMethod eq 'organization'

RespostaResponse

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "b1c5353a-7aca-41b3-830f-27d5218fe0e5",
      "externalId": "f31b1263-ba99-435a-a679-911d24850d7c",
      "name": "Test App",
      "version": "1.0.1",
      "distributionMethod": "Organization"
    }
  ]
}

Exemplo 2: listar aplicativos com uma determinada IDExample 2: List applications with a given ID

O exemplo a seguir lista os aplicativos com uma determinada ID.The following example lists applications with a given ID.

SolicitaçãoRequest

GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=id%20eq%20'b1c5353a-7aca-41b3-830f-27d5218fe0e5'

RespostaResponse

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "b1c5353a-7aca-41b3-830f-27d5218fe0e5",
      "externalId": "f31b1263-ba99-435a-a679-911d24850d7c",
      "name": "Test App",
      "version": "1.0.1",
      "distributionMethod": "Organization"
    }
  ]
}