ファイル分類要求の作成

[アーティクル]
04/08/2023

適用された文書理解モデルを使用して 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
}

Share via