Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Rufen Sie die Liste der unterstützten Kategorien ab, die in der categories Eigenschaft eines applicationTemplate angezeigt werden können. Jeder Eintrag enthält den von der API zugrunde liegenden Wert und einen lokalisierbaren Anzeigenamen, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Nicht unterstützt | Nicht unterstützt |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | Nicht unterstützt | Nicht unterstützt |
Zum Aufrufen dieser API sind keine zusätzlichen Berechtigungen erforderlich, solange Ihre Anwendung über ein gültiges Zugriffstoken zum Aufrufen von Microsoft Graph verfügt.
HTTP-Anforderung
GET /applicationTemplates/microsoft.graph.categories
Optionale Abfrageparameter
Diese Methode unterstützt die $selectAbfrageparameter , $filter, $orderby, $topund $skip OData, um die Antwort anzupassen. Serverseitiges Paging wird nicht unterstützt, daher enthält die Antwort keine @odata.nextLink Eigenschaft. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Accept-Language | Sprachcode. Optional. Wenn Sie diesen Header mit einem unterstützten Sprachcode cs wie or de-DEversehen, werden die displayName-Werte in diese Sprache lokalisiert, sofern verfügbar. Wenn die Kopfzeile nicht angegeben ist oder die angeforderte Sprache nicht verfügbar ist, werden die Werte für displayName in Englisch zurückgegeben. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt diese Funktion einen 200 OK Antwortcode und eine applicationTemplateCategory-Auflistung im Antworttext zurück.
Beispiele
Beispiel 1: Abrufen der Liste der unterstützten Kategorien
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/applicationTemplates/microsoft.graph.categories
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.applicationTemplateCategory)",
"value": [
{
"value": "contentSharing",
"displayName": "Content Sharing"
},
{
"value": "collaboration",
"displayName": "Collaboration"
},
{
"value": "health",
"displayName": "Health"
},
{
"value": "crm",
"displayName": "CRM"
},
{
"value": "productivity",
"displayName": "Productivity"
}
]
}
Beispiel 2: Abrufen der Liste der unterstützten Kategorien mit lokalisierten Anzeigenamen
Im folgenden Beispiel wird der Accept-Language Header verwendet, um displayName-Werte anzufordern, die ins Tschechische lokalisiert sind.
Anforderung
GET https://graph.microsoft.com/beta/applicationTemplates/microsoft.graph.categories
Accept-Language: cs
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.applicationTemplateCategory)",
"value": [
{
"value": "contentSharing",
"displayName": "Sdílení obsahu"
},
{
"value": "collaboration",
"displayName": "Spolupráce"
},
{
"value": "health",
"displayName": "Zdraví"
},
{
"value": "crm",
"displayName": "CRM"
},
{
"value": "productivity",
"displayName": "Produktivita"
}
]
}