ファイル分類要求の作成
適用された文書理解モデルを使用して 1 つ以上のファイルを分類する要求を作成します。 (詳細については、例を参照してください。)
SharePoint Online (および SharePoint 2016 以降のオンプレミス) のREST サービスでは、複数の要求の組み合わせがサポートされています。 要求は、OData $batch クエリ オプションを使用して、サービスへの 1 回の呼び出しに結合されます。 この方法を使用すると、一度に数百のドキュメントの分類作業項目をキューに入れられます。
HTTP 要求
POST /_api/machinelearning/workItems HTTP/1.1
URI パラメーター
なし
要求ヘッダー
ヘッダー | 値 |
---|---|
Accept | application/json;odata=verbose |
Content-Type | application/json;odata=verbose;charset=utf-8 |
x-requestdigest | 現在のサイトの適切なダイジェスト |
要求本文
名前 | 型 | 説明 |
---|---|---|
_metadata | 文字列 | SPO でオブジェクト メタを設定します。 常に値 {"type": "Microsoft.Office.Server.ContentCenter.SPMachineLearningWorkItemEntityData"} を使用します。 |
TargetSiteId | guid | 分類するファイルが配置されているサイトの ID。 これは、TargetSiteUrl に値がある場合は省略できます。 |
TargetSiteUrl | 文字列 | 分類するファイルが配置されているサイトの完全な URL。 TargeSiteId に値がある場合、これは省略できます。 |
TargetWebId | guid | 分類するファイルが配置されている Web の ID。 TargetWebServerRelativeUrl に値がある場合は、これを省略できます。 |
TargetWebServerRelativeUrl | 文字列 | 分類するファイルが配置されている Web のサーバー相対 URL。 TargetWebId に値がある場合は、これを省略できます。 |
TargetUniqueId | guid | 分類するフォルダーの ID。 TargetServerRelativeUrl に値がある場合は、これを省略できます。 |
TargetServerRelativeUrl | string | 分類するファイルのサーバー相対 URL が表示されます。 TargetUniqueId に値がある場合は、これを省略できます。 |
応答
名前 | 型 | 説明 |
---|---|---|
201 Created | 応答はカスタマイズされます。 エラーが発生した場合でも、201 Created を返す可能性があります。 呼び出し元は、応答本文をさらに調べ、正確な結果を判断する必要があります。 |
例
ID "e6cff8b7-c90c-4564-b5b8-033449090932" のファイルを分類するための要求をキューに入れる
要求の例
{
"__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"
}
応答のサンプル
状態コード : 201
{
"ErrorMessage": null,
"StatusCode": 201
}
{
"ErrorMessage": null,
"StatusCode": 201
}