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.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.
Aktualisieren Sie die Eigenschaften eines QnA-Objekts .
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
PATCH /search/qnas/{qnaId}
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext nur die Werte für die zu aktualisierenden Eigenschaften an. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.
In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.
Hinweis: Aktualisierungen der Eigenschaften einer Sammlung, z. B. Schlüsselwörter, ersetzen die gesamte Sammlung.
| 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
Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
PATCH https://graph.microsoft.com/beta/search/qnas/733b26d5-af76-4eea-ac69-1a0ce8716897
Content-Type: application/json
{
"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."
}
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 204 No Content