推荐产品卡

Deprecated

Info

Console

方法适用于所有模式.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一

offers-and-cards-management — 商品和卡片管理
offers-and-cards-management:read-only — 查看商品和卡片
all-methods — 全面管理账户
all-methods:read-only — 查看所有数据

返回市场上推荐用于您的产品的产品卡的Id。

您放置的每个产品必须在市场上有一个带有自己标识符的产品卡。 — SKU 在市场上。它在指定 URL 产品卡，后 «...sku=» 例如:

https://market.yandex.ru/product--yandex-kniga/484830016?sku=484830016…

获得推荐的产品 SKU 在市场上，在体内发送 POST-请求尽可能多的关于他们的信息：名称，制造商，条形码，价格等。

收到 SKU 您可以使用请求将其与有关产品的信息一起发送。 POST v2/businesses/{businessId}/offer-mappings/update.

每个请求最多可获得500条建议。

⚙️ 限制: 每小时100,000条建议

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offer-mapping-entries/suggestions

Path parameters

Name

Description

campaignId

Type: integer

广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。它与您的商店唯一链接，但仅用于自动交互。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。点击您的帐户图标→ 设置在左边的菜单中，选择 Api和模块:

座 运动ID;
标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要把它与:

商店的标识符，显示在商家的个人帐户中。
广告活动。

Min value: 1

Body

application/json

{
  "offers": [
    {
      "name": "Ударная дрель Makita HP1630, 710 Вт",
      "shopSku": "example",
      "category": "example",
      "vendor": "LEVENHUK",
      "vendorCode": "VNDR-0005A",
      "description": "example",
      "id": "example",
      "feedId": 0,
      "barcodes": [
        "46012300000000"
      ],
      "urls": [
        "example"
      ],
      "pictures": [
        "example"
      ],
      "manufacturer": "example",
      "manufacturerCountries": [
        "example"
      ],
      "minShipment": 0,
      "transportUnitSize": 0,
      "quantumOfSupply": 0,
      "deliveryDurationDays": 0,
      "boxCount": 0,
      "customsCommodityCodes": [
        "example"
      ],
      "weightDimensions": {
        "length": 65.55,
        "width": 50.7,
        "height": 20,
        "weight": 1.001
      },
      "supplyScheduleDays": [
        "MONDAY"
      ],
      "shelfLifeDays": 0,
      "lifeTimeDays": 0,
      "guaranteePeriodDays": 0,
      "processingState": {
        "status": "UNKNOWN",
        "notes": [
          null
        ]
      },
      "availability": "ACTIVE",
      "shelfLife": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "lifeTime": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "guaranteePeriod": {
        "timePeriod": 0,
        "timeUnit": "HOUR",
        "comment": "example"
      },
      "certificate": "example",
      "price": 0.5
    }
  ]
}

Name

Description

offers

Type: object[]

的产品清单。

Min items: 1

Max items: 500

Example

[
  {
    "name": "Ударная дрель Makita HP1630, 710 Вт",
    "shopSku": "example",
    "category": "example",
    "vendor": "LEVENHUK",
    "vendorCode": "VNDR-0005A",
    "description": "example",
    "id": "example",
    "feedId": 0,
    "barcodes": [
      "46012300000000"
    ],
    "urls": [
      "example"
    ],
    "pictures": [
      "example"
    ],
    "manufacturer": "example",
    "manufacturerCountries": [
      "example"
    ],
    "minShipment": 0,
    "transportUnitSize": 0,
    "quantumOfSupply": 0,
    "deliveryDurationDays": 0,
    "boxCount": 0,
    "customsCommodityCodes": [
      "example"
    ],
    "weightDimensions": {
      "length": 65.55,
      "width": 50.7,
      "height": 20,
      "weight": 1.001
    },
    "supplyScheduleDays": [
      "MONDAY"
    ],
    "shelfLifeDays": 0,
    "lifeTimeDays": 0,
    "guaranteePeriodDays": 0,
    "processingState": {
      "status": "UNKNOWN",
      "notes": [
        {}
      ]
    },
    "availability": "ACTIVE",
    "shelfLife": {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    },
    "lifeTime": {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    },
    "guaranteePeriod": {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    },
    "certificate": "example",
    "price": 0.5
  }
]

Responses

200 OK

目录中有关产品的信息。

Body

application/json

{
  "status": "OK",
  "result": {
    "offers": [
      {}
    ]
  }
}

Type: object

All of 2 types

Type: object
status

Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

result

Type: object

offers

Type: object[]

的产品清单。

Example

[
  {
    "name": "Ударная дрель Makita HP1630, 710 Вт",
    "shopSku": "example",
    "category": "example",
    "vendor": "LEVENHUK",
    "vendorCode": "VNDR-0005A",
    "description": "example",
    "id": "example",
    "feedId": 0,
    "barcodes": [
      "46012300000000"
    ],
    "urls": [
      "example"
    ],
    "pictures": [
      "example"
    ],
    "manufacturer": "example",
    "manufacturerCountries": [
      "example"
    ],
    "minShipment": 0,
    "transportUnitSize": 0,
    "quantumOfSupply": 0,
    "deliveryDurationDays": 0,
    "boxCount": 0,
    "customsCommodityCodes": [
      "example"
    ],
    "weightDimensions": {
      "length": 65.55,
      "width": 50.7,
      "height": 20,
      "weight": 1.001
    },
    "supplyScheduleDays": [
      "MONDAY"
    ],
    "shelfLifeDays": 0,
    "lifeTimeDays": 0,
    "guaranteePeriodDays": 0,
    "processingState": {
      "status": "UNKNOWN",
      "notes": [
        null
      ]
    },
    "availability": "ACTIVE",
    "shelfLife": {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    },
    "lifeTime": {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    },
    "guaranteePeriod": {
      "timePeriod": 0,
      "timeUnit": "HOUR",
      "comment": "example"
    },
    "certificate": "example",
    "price": 0.5,
    "marketCategoryId": 0,
    "marketCategoryName": "example",
    "marketModelName": "example",
    "marketSku": 1,
    "marketSkuName": "example"
  }
]

推荐产品卡列表。

Example

{
  "offers": [
    {
      "name": "Ударная дрель Makita HP1630, 710 Вт",
      "shopSku": "example",
      "category": "example",
      "vendor": "LEVENHUK",
      "vendorCode": "VNDR-0005A",
      "description": "example",
      "id": "example",
      "feedId": 0,
      "barcodes": [
        null
      ],
      "urls": [
        null
      ],
      "pictures": [
        null
      ],
      "manufacturer": "example",
      "manufacturerCountries": [
        null
      ],
      "minShipment": 0,
      "transportUnitSize": 0,
      "quantumOfSupply": 0,
      "deliveryDurationDays": 0,
      "boxCount": 0,
      "customsCommodityCodes": [
        null
      ],
      "weightDimensions": {},
      "supplyScheduleDays": [
        null
      ],
      "shelfLifeDays": 0,
      "lifeTimeDays": 0,
      "guaranteePeriodDays": 0,
      "processingState": {},
      "availability": "ACTIVE",
      "shelfLife": {},
      "lifeTime": {},
      "guaranteePeriod": {},
      "certificate": "example",
      "price": 0.5,
      "marketCategoryId": 0,
      "marketCategoryName": "example",
      "marketModelName": "example",
      "marketSku": 1,
      "marketSkuName": "example"
    }
  ]
}

Example

{
  "result": {
    "offers": [
      {
        "marketCategoryId": 0,
        "marketCategoryName": "example",
        "marketModelName": "example",
        "marketSku": 1,
        "marketSkuName": "example"
      }
    ]
  }
}

400 Bad Request

请求包含不正确的数据。有关错误的更多信息

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

401 Unauthorized

请求中未指定授权数据。有关错误的更多信息

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

403 Forbidden

授权数据不正确或禁止访问资源。有关错误的更多信息

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

404 Not Found

找不到请求的资源。有关错误的更多信息

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

420 Method Failure

已超出资源访问限制。有关错误的更多信息

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

500 Internal Server Error

Yandex中的内部错误。市场。有关错误的更多信息

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

这篇文章是否有用？

设定货物数量和最低数量的限制

查看匹配的卡片