Freigeben über


Akronym erstellen

Namespace: microsoft.graph.search

Erstellen Sie ein neues Akronymobjekt .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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) SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All

HTTP-Anforderung

POST /search/acronyms

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Akronymobjekts an.

Die folgende Tabelle zeigt die Eigenschaften, die verfügbar sind, wenn Sie ein Akronym erstellen.

Eigenschaft Typ Beschreibung
description Zeichenfolge Eine kurze Beschreibung des Akronyms, das Benutzern weitere Informationen über das Akronym und dessen Bedeutung bietet. Geerbt von searchAnswer.
displayName Zeichenfolge Die tatsächliche Kurzform oder das Akronym. Geerbt von searchAnswer.
standsFor Zeichenfolge Wofür das Akronym steht.
state microsoft.graph.search.answerState Status des Akronyms. Mögliche Werte: published, draft, excluded, unknownFutureValue
webUrl Zeichenfolge Die URL der Seite oder Website, auf der Benutzer weitere Informationen zum Akronym erhalten können. Geerbt von searchAnswer.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode mit der ID des erstellten Akronyms zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/search/acronyms
Content-Type: application/json

{
  "displayName": "DNN",
  "standsFor": "Deep Neural Network",
  "description": "A deep neural network is a neural network with a certain level of complexity, a neural network with more than two layers.",
  "webUrl": "http://microsoft.com/deep-neural-network",
  "state": "draft"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "733b26d5-af76-4eea-ac69-1a0ce8716897"
}