applicationTemplate: categories

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