edit-icon download-icon

画像の追加(旧)

最終更新日: May 24, 2019

説明

この操作は、指定された Image Search インスタンスに画像を追加します。この操作を呼び出すには、instanceName パラメーターでインスタンスを指定し、関連するパラメーターで POST ボディの内容を構成する必要があります。

リクエストパス

/item/add

リクエストパラメーター

URL パラメーター

名前 データタイプ 必須かどうか 説明
instanceName String はい 画像を追加するインスタンスの名前。

Body パラメーター

名前 データタイプ 必須かどうか 説明
item_id String はい 商品または画像の ID。
cat_id String 商品検索でのみ必要 カテゴリー ID.
cust_content String はい カスタムコンテンツ。
pic_list List はい 画像名リスト。
pic_map Map はい 追加する画像名と、それに対応する内容。

Body の構造

Body の構造は次の通りです:

  1. key1,key1_start_offset,key1_end_offset#...#keyn,keyn_start_offset,keyn_end_offset^key1_content...keyn_content

POST Body には、画像メタデータと画像コンテンツが含まれており、それらはサーカムフレックスアクセント (^) で区切られています。メタデータはキーのセットです。すべてのキーは、番号記号 (#) で区切られています。各キーは、キー名、開始オフセット値および終了オフセット値からなり、コンマ (,) で区切られています。開始オフセット値および終了オフセット値は、画像コンテンツにおけるカットアウトの開始位置および終了位置です。pic_list パラメーターは画像名のリストで、Base64 でエンコードする必要があります。画像名はコンマ (,) で区切ります。pic_map パラメーターは画像コンテンツで、Base64 でエンコードする必要があります。pic_map パラメーターに追加される各キーが、pic_list の各画像コンテンツに対応しなければいけません。

レスポンスパラメーター

名前 データタイプ 説明
Success Boolean リクエストが成功したかどうか。
RequestId String リクエストの ID。
Code int エラーコード。コードが 0 の場合、リクエストは成功です。コードが 0 でない場合、リクエストは失敗です。
Message String エラー情報。

レスポンスの構造

  1. {
  2. "Message":"success",
  3. "RequestId":"73B5133C-84EE-4F0A-B972-23CCCBFB7CD5",
  4. "Success":true,
  5. "Code":0
  6. }

次の例は、goodssearch という名前の Image Search インスタンスに商品写真を追加する方法を示しています。この例では、プロダクト写真 shoes1.jpg と shoes2.jpg を追加します。shoes1.jpg の内容は pic_content1 です。shoes2.jpg の内容は pic_content2 です。プロダクト ID (item_id)、カテゴリー ID (cat_id)、およびカスタムコンテンツ (cust_content) は、それぞれ 1000、0 および {“key1”:”value1”} として指定されています。

  1. URL: /item/add?instaneName=goodssearch
  2. POST ボディ:
  3. cust_content,0,17#item_id,17,21#c2hvZXMyLmpwZw==,21,37#cat_id,37,38#pic_list,38,71#c2hvZXMxLmpwZw==,71,87^{"key1":"value1"}1000cGljX2NvbnRlbnQy0c2hvZXMyLmpwZw==,c2hvZXMxLmpwZw==cGljX2NvbnRlbnQx
  4. 注意: c2hvZXMyLmpwZw== Base64 でエンコードされた画像名 shoes1.jpg を表し、c2hvZXMxLmpwZw== Base64 でエンコードされた画像名 shoes2.jpg を表します。