创建或更新商品

创建商品并更新有关商品信息的方法。

欲知限制，请使用
/v4/product/info/limit。如果商品下载和更新次数
超过限制，则出现错误 item_limit_exceeded。

一次请求最多可转移100种商品。每个商品都是数组中的单独元素 items。请指出
有关商品的所有信息：特征、条形码、图像、尺寸、价格和价格货币。

在更新商品时，请在请求中转达有关商品的所有信息。

指定货币必须与个人中心中设置的币种相匹配。默认情况下显示 RUB — 俄罗斯卢布。
如果您设置了人民币为币种, 请选择 CNY, 否则将返回错误。

如果您填写错误或指定，则不会创建或更新商品:

强制特征: 不同类目的属性有所不同——您可以在卖家知识库中查看，或者通过方法 /v1/description-category/attribute获取。

真实体积和重量特性: depth, width, height, dimension_unit, weight, weight_unit。请勿在请求中跳过这些参数，也不要指定0。

HTML标签可用于某些特征。

更多关于特征的信息可见卖家知识库

审核后，该商品将出现在您的个人中心中，但在您将其出售之前，用户将无法看到该商品。

请求中的每项都是数组的单独元素 items。

为连接两张卡片, 请对每张卡片传递9048 在 attributes中。这些卡片除了大小或颜色外的所有属性都必须匹配。

加载图片

若要上传，请将请求中的图像链接发至公共云存储中。
链接的图像格式为JPG或PNG。

按照网站上所需的顺序将图像放在images 数组中。要加载主图请使用 primary_image参数。如果没有传递 primary_image值, 主图将是
在 images组中的第一张图片。

对于每个商品，您最多可以上传15个图像，包括主图像。
如果传递 primary_image值, 在 images 的最大图像数为——14。
如果参数 primary_image 为空, 那么在images 可以传递最多15张图片。

若要上传招聘360，请使用images360字段, 上传营销名字 — color_image。

如果要更改图像的构图或顺序，请使用
/v3/product/info/list
方法获取信息 —— 里面显示当前订单和
图像组成。请复制 images, images360, color_image字段的数据, 更改和完成列表或者
根据需求订购。

上传视频

上传视频请在请求中上传视频链接。

为此，请在 complex_attributes参数中传递对象。在attributes数组中，请传递两个含complex_id = 100001的对象:

在第一个中，请赋值指定 id = 21841 和在数组 values 中传输含视频链接的对象。

例子:

{
  "complex_id": 100001,
  "id": 21841,
  "values": [
    {
      "value": "https://www.youtube.com/watch?v=ZwM0iBn03dY"
    }
  ]
}

在二个中，请指定值id = 21837 和在 values 数组中传输含视频名称的对象。

例子:

{
  "complex_id": 100001,
  "id": 21837,
  "values": [
    {
      "value": "videoName_1"
    }
  ]
}

如果您想上传视频, 请在不同的values数组对象中为每个视频赋值。

例子:

{
  "complex_id": 100001,
  "id": 21837,
  "values": [
    {
      "value": "videoName_1"
    },
    {
      "value": "videoName_2"
    }
  ]
},
{
  "complex_id": 100001,
  "id": 21841,
  "values": [
    {
      "value": "https://www.youtube.com/watch?v=ZwM0iBn03dY"
    },
    {
      "value": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    }
  ]
}

上传尺寸表

为添加使用以下方法创建的尺寸图表设计, 请在attributes组传递表格，格式 JSON 如 Rich-内容 id = 13164。

JSON格式的设计
更多关于设计可见卖家知识库

视频封面上传

您可以通过综合属性上传视频封面 complex_attributes。

例子：

"complex_attributes": [
  {
    "attributes": [
      {
        "id": 21845,
        "complex_id": 100002,
        "values": [
          {
          "dictionary_value_id": 0,
          "value": "https://v.ozone.ru/vod/video-10/01GFATWQVCDE7G5B721421P1231Q7/asset_1.mp4"
          }
        ]
      }
    ]
  }
]

请求参数

Header 参数

Body 参数application/json

示例

不上传视频的请求示例视频上传请求示例

{
    "items": [
        {
            "attributes": [
                {
                    "complex_id": 0,
                    "id": 5076,
                    "values": [
                        {
                            "dictionary_value_id": 971082156,
                            "value": "麦克风架"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 9048,
                    "values": [
                        {
                            "value": "一套X3NFC保护膜。 深色棉质"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 8229,
                    "values": [
                        {
                            "dictionary_value_id": 95911,
                            "value": "一套X3NFC保护膜。深色棉质"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 85,
                    "values": [
                        {
                            "dictionary_value_id": 5060050,
                            "value": "Samsung"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 10096,
                    "values": [
                        {
                            "dictionary_value_id": 61576,
                            "value": "灰色的"
                        }
                    ]
                }
            ],
            "barcode": "112772873170",
            "description_category_id": 17028922,
            "new_description_category_id": 0,
            "color_image": "",
            "complex_attributes": [],
            "currency_code": "RUB",
            "depth": 10,
            "dimension_unit": "mm",
            "height": 250,
            "images": [],
            "images360": [],
            "name": "一套X3NFC的保护膜。深色棉质",
            "offer_id": "143210608",
            "old_price": "1100",
            "pdf_list": [],
            "price": "1000",
            "primary_image": "",
            "promotions": [
                {
                    "operation": "UNKNOWN",
                    "type": "REVIEWS_PROMO"
                }
            ],
            "type_id": 91565,
            "vat": "0.1",
            "weight": 100,
            "weight_unit": "g",
            "width": 150
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

不上传视频的请求示例视频上传请求示例

curl --location --request POST 'https://api-seller.ozon.ru/v3/product/import' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "items": [
        {
            "attributes": [
                {
                    "complex_id": 0,
                    "id": 5076,
                    "values": [
                        {
                            "dictionary_value_id": 971082156,
                            "value": "麦克风架"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 9048,
                    "values": [
                        {
                            "value": "一套X3NFC保护膜。 深色棉质"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 8229,
                    "values": [
                        {
                            "dictionary_value_id": 95911,
                            "value": "一套X3NFC保护膜。深色棉质"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 85,
                    "values": [
                        {
                            "dictionary_value_id": 5060050,
                            "value": "Samsung"
                        }
                    ]
                },
                {
                    "complex_id": 0,
                    "id": 10096,
                    "values": [
                        {
                            "dictionary_value_id": 61576,
                            "value": "灰色的"
                        }
                    ]
                }
            ],
            "barcode": "112772873170",
            "description_category_id": 17028922,
            "new_description_category_id": 0,
            "color_image": "",
            "complex_attributes": [],
            "currency_code": "RUB",
            "depth": 10,
            "dimension_unit": "mm",
            "height": 250,
            "images": [],
            "images360": [],
            "name": "一套X3NFC的保护膜。深色棉质",
            "offer_id": "143210608",
            "old_price": "1100",
            "pdf_list": [],
            "price": "1000",
            "primary_image": "",
            "promotions": [
                {
                    "operation": "UNKNOWN",
                    "type": "REVIEWS_PROMO"
                }
            ],
            "type_id": 91565,
            "vat": "0.1",
            "weight": 100,
            "weight_unit": "g",
            "width": 150
        }
    ]
}'

加载图片#

上传视频#

上传尺寸表#