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 einer applicationTemplate angezeigt werden können. Jeder Eintrag enthält den zugrunde liegenden Wert, der von der API verwendet wird, 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 $selectOData-Abfrageparameter , $filter$orderby, $top, und $skip zum Anpassen der Antwort. Serverseitiges Paging wird nicht unterstützt, sodass die Antwort keine -Eigenschaft enthält @odata.nextLink . 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 dieser Header mit einem unterstützten Sprachcode wie cs oder de-DEbereitgestellt wird, werden die displayName-Werte zurückgegeben, die in diese Sprache lokalisiert sind, sofern verfügbar. Wenn der Header nicht angegeben ist oder die angeforderte Sprache nicht verfügbar ist, werden displayName-Werte in Englisch zurückgegeben. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Funktion erfolgreich verläuft, werden der 200 OK Antwortcode und eine applicationTemplateCategory-Auflistung im Antworttext zurückgegeben.
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 auf Tschechisch 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"
}
]
}