1. ジョブのフェッチ

フェッチ ジョブを作成する

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

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

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

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

  • アセットに既に関連付けられているファイルは、ファイル履歴に移動します。デフォルトでは、ファイル履歴はプレビューサムネイルの下のペインに表示されます。

  • 新しくアップロードされたファイルがマスターファイルになり、プレビューに表示されます。

  • フェッチ・ジョブのファイル配列に複数のファイルがある場合、最後に指定されたファイルがマスター・ファイルになります。他のファイルは代替ファイルになります。

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

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

ボディパラメータ

新しいフェッチジョブの作成を要求するには、次の必須の本文パラメーターを指定してcreate fetch jobリクエストオブジェクト を使用します。

パラメーター

種類

形容

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を含むlocationヘッダーを提供します。

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

応答の例

フェッチ・ジョブのレスポンスは、次の例のようになります。

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