1. フェッチ ジョブの作成

フェッチ ジョブの作成

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

REST API を使用して、フェッチ ジョブを作成できます。フェッチ ジョブを作成すると、参照されるファイルがダウンロードされ、参照される M.Asset リソースのファイル履歴に追加されます。要求のリストの最後のファイルが新しいマスター ファイルになります。

フェッチ ジョブが、既に既存のファイルが添付されているアセットをターゲットにする場合:

  • アセットに既に関連付けられているファイルは、ファイル履歴に移動します。既定では、ファイル履歴はプレビュー サムネイルの下のペインに表示されます。
  • 新しくアップロードされたファイルがマスター ファイルになり、プレビューに表示されます。
  • フェッチ ジョブのファイル配列に複数のファイルがある場合、最後に提供されたファイルがマスター ファイルになります。他のファイルは代替ファイルになります。

フェッチ ジョブを作成するには、次のエンドポイントにリクエストを送信する必要があります。

POST https://<hostname>/api/fetchjobs

本文パラメーター

新しいフェッチジョブの作成をリクエストするには、次の必須ボディ パラメーターでフェッチ ジョブ作成要求オブジェクトを使用します。

パラメータータイプ説明
state_description文字列ジョブの現在の状態の説明。このパラメーターは設定する必要がありますが、空にすることができます ("")。
assetリンクファイルを受信するアセット エンティティへのリンク。
files配列アセットに追加するファイルを取得する場所を示すファイル オブジェクトの配列。要求のリストの最後のファイルが新しいマスター ファイルになります。

本文の例

リクエストの本文で次のサンプル コードを使用できます。

{
"state_description": "",
"asset": {
"href": "https://<hostname>/api/entities/23"
},
"files": [
{
"type": "Web",
"href": "https://www.gstatic.com/webp/gallery/5.jpg"
}
]
}

応答

フェッチ ジョブが成功すると、次の応答が返されます。

応答説明
201 Created新しく作成されたリソースの URL を含むロケーション ヘッダーを提供します。

可能な応答の完全なリストは、応答コードで入手できます。

応答の例

フェッチ ジョブの応答は、次の例のようになります。

HTTP/1.1 201 Created
Location: /api/fetchjobs/6448
この記事を改善するための提案がある場合は、 お知らせください!