QnA erstellen

Namespace: microsoft.graph.search

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.

Erstellen Sie ein neues QnA-Objekt .

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

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

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) SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All

HTTP-Anforderung

POST /search/qnas

Anforderungsheader

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

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des qna-Objekts an.

Die folgende Tabelle zeigt die Eigenschaften, die beim Erstellen einer QnA verfügbar sind.

Eigenschaft Typ Beschreibung
availabilityEndDateTime DateTimeOffset Datum und Uhrzeit, zu der die QnA nicht mehr als Suchergebnis angezeigt wird. null Als "immer verfügbar" festlegen. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
VerfügbarkeitStartDatumUhrzeit DateTimeOffset Datum und Uhrzeit, zu dem die QnA als Suchergebnis angezeigt wird. null Als "immer verfügbar" festlegen. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
description Zeichenfolge Antwort, die in den Suchergebnissen angezeigt wird. Geerbt von searchAnswer.
displayName Zeichenfolge Frage, die in den Suchergebnissen angezeigt wird. Geerbt von searchAnswer.
groupIds Zeichenfolgenauflistung Die Liste der Sicherheitsgruppen, die diese QnA anzeigen können.
"keywords" microsoft.graph.search.answerKeyword Schlüsselwörter, die diese QnA auslösen, damit sie in Suchergebnissen angezeigt werden.
languageTags String collection Eine Liste der geografisch spezifischen Sprachnamen, in denen diese QnA angezeigt werden kann. Jeder Wert eines Sprachtags folgt dem Muster {language}-{region}. Beispielsweise ist Englisch, en-us wie es in den USA verwendet wird. Die Liste der möglichen Werte finden Sie unter Unterstützte Sprachtags.
Plattformen microsoft.graph.devicePlatformType-Auflistung Liste der Geräte und Betriebssysteme, die diese QnA anzeigen können. Die möglichen Werte sind: android, androidForWork, ios, macOS, windowsPhone81, windowsPhone81AndLaterandroidWorkProfileiOSMobileApplicationManagementandroidASOPunknownFutureValuewindows10AndLaterunknownandroidMobileApplicationManagement.
state microsoft.graph.search.answerState Zustand der QnA. Mögliche Werte sind: published, draft, excluded, unknownFutureValue.
targetedVariations microsoft.graph.search.answerVariant-Auflistung Variationen einer QnA für verschiedene Länder/Regionen oder Geräte. Verwenden Sie diese Option, wenn Sie Benutzern je nach Gerät, Land/Region unterschiedlich Inhalte anzeigen müssen. Die Datums- und Gruppeneinstellungen gelten für alle Variationen.
webUrl Zeichenfolge Der URL-Link für die QnA. Wenn Benutzer diese QnA aus den Suchergebnissen auswählen, werden sie an die angegebene URL weitergeleitet. Geerbt von searchAnswer.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode mit der ID der erstellten Frage und Antwort zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/search/qnas
Content-Type: application/json

{
  "displayName": "Global Country Holidays",
  "webUrl": "http://www.contoso.com/",
  "description": "The dates that Contoso offices will be closed to observe holidays. These dates may differ from the actual date of the holiday in cases where the holiday falls on a weekend.    <table>    <thead>    <tr>    <td><strong>2021 Dates</strong></td>    <td><strong>Holiday</strong></td>    </tr>    </thead>    <tbody>    <tr>        <td>January 1, 2021</td>        <td>New Year's Day</td>    </tr>        <tr>        <td>January 18, 2021</td>        <td>Martin Luther King Day</td>    </tr>        <tr>        <td>February 15, 2021</td>        <td>Presidents Day</td>    </tr>        <tr>        <td>May 31, 2021</td>        <td>Memorial Day</td>    </tr>        <tr>        <td>July 5, 2021</td>        <td>Independence Day</td>    </tr>        <tr>        <td>September 6, 2021</td>        <td>Labor Day</td>    </tr>        <tr>        <td>November 25, 2021 - November 26, 2021</td>        <td>Thanksgiving Day and Day after Thanksgiving</td>    </tr>    <tr>        <td>December 23, 2021 - December 24, 2021</td>        <td>Christmas Eve and Christmas Day</td>    </tr>    </tbody>    </table>",
  "keywords":  {
    "keywords": ["new years day", "martin luther king day", "presidents day", "memorial day", "independence day", "labor day", "thanksgiving", "christmas"],
    "reservedKeywords": ["holidays", "paid days off"],
    "matchSimilarKeywords": true
  },
  "availabilityStartDateTime": "2020-09-21T20:01:37Z",
  "availabilityEndDateTime": "2021-12-31T20:01:37Z",
  "languageTags": ["en-us"],
  "platforms": ["ios"],
  "state": "published"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 201 Created
Location: /733b26d5-af76-4eea-ac69-1a0ce8716897
Content-Type: application/json

{
  "id": "733b26d5-af76-4eea-ac69-1a0ce8716897"
}
  • Zuletzt aktualisiert um