この API 操作は、Image Search インスタンスにイメージを追加します。
この操作を呼び出すには、URL で `instanceName` パラメーターを渡してターゲットインスタンスを指定します。他のパラメーターは指定されたフォーマットに結合し、リクエストボディで送信する必要があります。リクエスト URI は /item/add です。
リクエストパラメーター
- URL 内のパラメーター
名前 タイプ 必須 説明 instanceName String はい インスタンス名。 - ボディ内のパラメーター
名前 タイプ 必須 説明 item_id String はい プロダクトまたはイメージの ID。 説明 必要に応じてパラメーター値をカスタマイズします。例：top001 または pants002。cat_id String - プロダクト検索シナリオでは必須です。
- 汎用検索シナリオではオプションです。
カテゴリ ID。 crop ブール値 いいえ 主題識別を実行するかどうかを指定します。デフォルト値は trueです。region String いいえ イメージの主題領域。フォーマットは x1,x2,y1,y2です。ここで、x1,y1は左上の点の座標で、x2,y2は右下の点の座標です。デフォルトでは、主題領域は自動的に検出されます。cust_content String はい カスタムコンテンツ。 pic_list リスト はい イメージ名のリスト。 pic_map マップ はい 各イメージに対応するコンテンツ。 - ボディ構造ボディのフォーマットは次のとおりです：
key1,key1_start_offset,key1_end_offset#...#keyn,keyn_start_offset,keyn_end_offset^key1_content...keyn_contentボディは、キャレット (^) で区切られたメタパートとコンテンツパートの 2 つの部分で構成されます。メタパートは、キーとコンテンツパート内の各キーの値のオフセットを記述します。複数のキーはハッシュ記号 (#) で区切られます。単一のキーのコンポーネントはコンマ (,) で区切られます。キー名の後の 2 つの数字は、コンテンツパート内の値の開始位置と終了位置を指定します。さらに、`pic_list` 内の各イメージ名は Base64 エンコードされている必要があります。複数のイメージ名は、コンマで区切られて 1 つの文字列に連結されます。`pic_map` 内の各キーは `pic_list` 内の名前に対応し、`pic_map` 内のイメージコンテンツも Base64 エンコードされている必要があります。
レスポンスパラメーター
| 名前 | タイプ | 説明 |
| Success | ブール値 | リクエストが成功したかどうかを示します。 |
| RequestId | String | リクエスト ID。 |
| Code | int | エラーコード。値が 0 の場合は成功を示します。0 以外の値は失敗を示します。 |
| Message | String | エラーメッセージ。 |
レスポンスフォーマット
{ "Message":"success", "RequestId":"73B5133C-84EE-4F0A-B972-23CCCBFB7CD5", "Success":true, "Code":0}
例
この例では、`goodssearch` インスタンスにプロダクトを追加する方法を示します。プロダクトの `item_id` は `1000`、`cat_id` は `0`、カスタムコンテンツ `cust_content` は `{"key1":"value1"}` に設定されています。プロダクトには 2 つのイメージが追加されます：コンテンツが `pic_content1` の `shoes1.jpg` と、コンテンツが `pic_content2` の `shoes2.jpg` です。リクエストは次のとおりです：
URL: /item/add?instaneName=goodssearch
POST Body:
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
注：この例では、c2hvZXMxLmpwZw== は shoes1.jpg の Base64 エンコード値であり、c2hvZXMyLmpwZw== は shoes2.jpg の Base64 エンコード値です。