Auflisten der veröffentlichten Apps aus dem Microsoft Teams-App-KatalogList the published apps from the Microsoft Teams app catalog

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Auflisten von apps aus dem Microsoft Teams-App-Katalog.List apps from the Microsoft Teams app catalog. Dies umfasst Apps aus dem Microsoft Teams Store sowie Apps aus dem App-Katalog Ihres Unternehmens (dem Mandanten-App-Katalog).This includes apps from the Microsoft Teams store, as well as apps from your organization's app catalog (the tenant app catalog). Um Apps nur aus dem App-Katalog Ihrer Organisation abzurufen, Organization geben Sie als distributionMethod in der teamsCatalogApp -Ressource an.To get apps from your organization's app catalog only, specify Organization as the distributionMethod in the teamsCatalogApp resource.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Hinweis: Diese API kann nur von globalen Administratoren aufgerufen werden.Note: Only global administrators can call this API.

BerechtigungstypPermission Type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) AppCatalog.ReadWrite.AllAppCatalog.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported
AnwendungApplication Nicht unterstütztNot supported

HTTP-AnforderungHTTP request

GET /appCatalogs/teamsApps

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter $filter, $select und $expand zur Anpassung der Antwort.This method supports the $filter, $select, and $expand OData query parameters to help customize the response.

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Keine.None.

Hinweis: Sie können nach einem der Felder des teamsCatalogApp -Objekts filtern, um die Ergebnisliste zu verkürzen.Note: You can filter on any of the fields of the teamsCatalogApp object to shorten the list of results. Sie können einen der folgenden Filter Vorgänge verwenden: gleich, ungleich, and, or und Not.You can use any of the following filter operations: Equal, not-equal, and, or, and not.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 200 OK werden der Antwortcode und eine Liste von teamsCatalogApp -Objekten im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and a list of teamsCatalogApp objects in the response body.

BeispieleExamples

Beispiel 1: Auflisten aller AnwendungenExample 1: List all applications

Im folgenden Beispiel werden alle Anwendungen aufgelistet, die für Ihren mandantenspezifisch sind.The following example lists all applications that are specific to your tenant.

AnforderungRequest

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

AntwortResponse

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"
    }
  ]
}

Beispiel 2: Auflisten von Anwendungen mit einer bestimmten IDExample 2: List applications with a given ID

Im folgenden Beispiel werden Anwendungen mit einer bestimmten ID aufgelistet.The following example lists applications with a given ID.

AnforderungRequest

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

AntwortResponse

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"
    }
  ]
}