Erstellen einer Dateiklassifizierungsanforderung
Erstellt eine Anforderung zur Klassifizierung einer oder mehrere Dateien unter Verwendung des angewendeten Dokumentverständnismodells. (Weitere Informationen finden Sie in diesem Beispiel.)
Der REST-Dienst von SharePoint Online (und lokalem SharePoint 2016 und höher) unterstützt das Kombinieren mehrerer Anforderungen. Anforderungen werden in einem einzelnen Dienstaufruf mithilfe der OData-Abfrageoption „$batch“ kombiniert. Diese Methode kann verwendet werden, um Arbeitselemente für Klassifizierungen für Hunderte von Dokumenten gleichzeitig in die Warteschlange zu stellen.
HTTP-Anforderung
POST /_api/machinelearning/workItems HTTP/1.1
URI-Parameter
Keine
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Annehmen | application/json;odata=verbose |
| Content-Type | application/json;odata=verbose;charset=utf-8 |
| x-requestdigest | Die entsprechende Digest für die aktuelle Website |
Anforderungstext
| Name | Typ | Beschreibung |
|---|---|---|
| _metadata | Zeichenfolge | Festlegen der Objekt-Metadaten auf dem SPO. Verwenden Sie immer den Wert: {"type": "Microsoft.Office.Server.ContentCenter.SPMachineLearningWorkItemEntityData"}. |
| TargetSiteId | GUID | Die ID der Website, auf der sich die zu klassifizierende Datei befindet. Diese kann weggelassen werden, wenn TargetSiteUrl einen Wert aufweist. |
| TargetSiteUrl | Zeichenfolge | Die vollständige URL der Website, auf der sich die zu klassifizierende Datei befindet. Diese kann weggelassen werden, wenn TargeSiteId einen Wert aufweist. |
| TargetWebId | GUID | Die ID des Web, auf der sich die zu klassifizierende Datei befindet. Diese kann weggelassen werden, wenn TargetWebServerRelativeUrl einen Wert aufweist. |
| TargetWebServerRelativeUrl | Zeichenfolge | Die relative Server-URL des Webs, in dem sich die zu klassifizierende Datei befindet. Diese kann weggelassen werden, wenn TargetWebId einen Wert aufweist. |
| TargetUniqueId | GUID | Die ID des zu klassifizierenden Ordners. Diese kann weggelassen werden, wenn TargetServerRelativeUrl einen Wert aufweist. |
| TargetServerRelativeUrl | Zeichenfolge | Die relative Server-URL an der sich die zu klassifizierenden Datei befindet. Diese kann weggelassen werden, wenn TargetUniqueId einen Wert aufweist. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 201 Erstellt | Die Antwort ist benutzerdefiniert. Wenn ein Fehler auftritt, könnte trotzdem „201 Erstellt“ zurückgegeben werden. Der Aufrufer sollte den Antworttext weiter überprüfen, um das genaue Ergebnis zu ermitteln. |
Beispiele
Eine Anforderung für die Klassifizierung einer Datei mit ID „e6cff8b7-c90c-4564-b5b8-033449090932“ in die Warteschlange stellen
Beispielanfrage
{
"__metadata": {
"type": "Microsoft.Office.Server.ContentCenter.SPMachineLearningWorkItemEntityData"
},
"TargetSiteId": "f686e63b-aba7-48e5-97c7-68c4c1df292f",
"TargetWebId": "66d6b64d-6f88-4dd9-b3db-47e6f00c53e8",
"TargetUniqueId": "e6cff8b7-c90c-4564-b5b8-033449090932"
}
Beispielantwort
Statuscode: 201
{
"ErrorMessage": null,
"StatusCode": 201
}
{
"ErrorMessage": null,
"StatusCode": 201
}