Freigeben über

Erstellen von qna

  • Artikel

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.

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/qnas

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 qna-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen eines qna verfügbar sind.

Eigenschaft Typ Beschreibung
availabilityEndDateTime DateTimeOffset Datum und Uhrzeit, zu dem die QnA nicht mehr als Suchergebnis angezeigt wird. Legen Sie als null für always available fest. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
availabilityStartDateTime DateTimeOffset Datum und Uhrzeit, zu dem die QnA als Suchergebnis angezeigt wird. Legen Sie als null für always available fest. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
description String Antwort, die in Suchergebnissen angezeigt wird. Geerbt von searchAnswer.
displayName String 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, um in Suchergebnissen angezeigt zu werden.
languageTags String collection Eine Liste mit geografisch spezifischen Sprachnamen, in denen diese QnA angezeigt werden kann. Jeder Sprachtagwert folgt dem Muster {language}-{region}. Beispielsweise ist Englisch, en-us wie in der USA verwendet. Eine Liste der möglichen Werte finden Sie unter Unterstützte Sprachtags.
Plattformen microsoft.graph.devicePlatformType-Sammlung Liste der Geräte und Betriebssysteme, die diese QnA anzeigen können. Mögliche Werte: android, androidForWork, ios, macOS, windowsPhone81, windowsPhone81AndLater, windows10AndLater, androidWorkProfile, unknown, androidASOP, androidMobileApplicationManagement, iOSMobileApplicationManagement, unknownFutureValue.
state microsoft.graph.search.answerState Status der QnA. Mögliche Werte: published, draft, excluded, unknownFutureValue
targetedVariations microsoft.graph.search.answerVariant-Sammlung Variationen einer QnA für verschiedene Länder oder Geräte. Verwenden Sie diese Option, wenn Sie benutzern je nach Gerät, Land/Region oder beidem unterschiedliche Inhalte anzeigen müssen. Die Datums- und Gruppeneinstellungen gelten für alle Variationen.
webUrl String 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 die 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"
}