Подбор таблиц размеров
Метод доступен для всех моделей.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- offers-and-cards-management — Управление товарами и карточками
- offers-and-cards-management:read-only — Просмотр товаров и карточек
- all-methods — Полное управление кабинетом
- all-methods:read-only — Просмотр всех данных
Возвращает таблицы размеров, подходящие для указанной категории, бренда и пола.
Тип STANDARD — таблицы, уже созданные Маркетом и автоматически подобранные под выбранные
вами категорию, бренд и пол. Тип CUSTOM — таблицы, которые вы создали сами: они подходят,
если у вас свой бренд, уникальная размерная линейка, товары маломерят или большемерят.
Сначала возвращаются созданные бизнесом, затем брендовые, затем стандартные таблицы; внутри каждой группы — по убыванию идентификатора.
Результаты возвращаются постранично. Для навигации используйте параметры pageToken и limit.
⚙️ Лимит: 100 запросов в минуту |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/businesses/{businessId}/size-tables/suggest
Path parameters
|
Name |
Description |
|
businessId |
Type: integer Идентификатор кабинета. Чтобы его узнать, воспользуйтесь запросом GET v2/campaigns. ℹ️ Что такое кабинет и магазин на Маркете Min value: |
Query parameters
|
Name |
Description |
|
limit |
Type: integer Количество значений на одной странице. Default: Min value: Max value: |
|
pageToken |
Type: string Идентификатор страницы c результатами. Если параметр не указан, возвращается первая страница. Передавайте значение выходного параметра Example: `` |
Body
application/json
{
"categoryId": 0,
"vendorId": 1,
"genderId": 1
}
|
Name |
Description |
|
categoryId |
Type: CategoryId Идентификатор категории на Маркете. При изменении категории убедитесь, что характеристики товара и их значения в параметре Список категорий Маркета можно получить с помощью запроса POST v2/categories/tree. Min value: Exclusive min: Example: |
|
genderId |
Type: integer Идентификатор пола: значение характеристики Пол ( Чтобы его узнать, воспользуйтесь запросом POST v2/category/{categoryId}/parameters — идентификатор придет в Min value: |
|
vendorId |
Type: integer Идентификатор бренда: значение характеристики Бренд ( Чтобы его узнать, воспользуйтесь запросом POST v2/category/{categoryId}/parameters — идентификатор придет в Min value: |
CategoryId
Идентификатор категории на Маркете.
При изменении категории убедитесь, что характеристики товара и их значения в параметре parameterValues вы передаете для новой категории.
Список категорий Маркета можно получить с помощью запроса POST v2/categories/tree.
Type: integer
Min value: 0
Exclusive min: true
Responses
200 OK
Подходящие таблицы размеров.
Body
application/json
{
"status": "OK",
"result": {
"sizeParameterId": 0,
"sizeTables": [
{
"sizeTableId": 0,
"sizeTableName": "example",
"sizeTableType": "CUSTOM",
"sizeParameterId": 0,
"editable": true,
"key": {},
"sizeCharts": [
null
]
}
],
"paging": {
"nextPageToken": "example"
}
}
}
Type: object
All of 2 types
-
Type: ApiResponse
Стандартная обертка для ответов сервера.
Example
{ "status": "OK" } -
Type: object
result
Type: SuggestSizeTablesResultDTO
Подходящие таблицы размеров.
Example
{ "sizeParameterId": 0, "sizeTables": [ { "sizeTableId": 0, "sizeTableName": "example", "sizeTableType": "CUSTOM", "sizeParameterId": 0, "editable": true, "key": { "categoryId": 0, "vendorId": 0, "genderId": 0 }, "sizeCharts": [ { "sizeChartId": 0, "sizeChartName": "example", "columnType": "SIZE_CHART", "sizes": [ null ] } ] } ], "paging": { "nextPageToken": "example" } }Example
{ "result": { "sizeParameterId": 0, "sizeTables": [ { "sizeTableId": 0, "sizeTableName": "example", "sizeTableType": "CUSTOM", "sizeParameterId": 0, "editable": true, "key": { "categoryId": 0, "vendorId": 0, "genderId": 0 }, "sizeCharts": [ {} ] } ], "paging": { "nextPageToken": "example" } } }
ApiResponseStatusType
Тип ответа. Возможные значения:
OK— ошибок нет.ERROR— при обработке запроса произошла ошибка.
Type: string
Enum: OK, ERROR
ApiResponse
Стандартная обертка для ответов сервера.
|
Name |
Description |
|
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
Example
{
"status": "OK"
}
SizeTableType
Тип таблицы размеров:
CUSTOM— таблица, созданная бизнесом.STANDARD— таблица Маркета: стандартная или подобранная под бренд.
Type: string
Enum: CUSTOM, STANDARD
SizeTableKeyDTO
Условия, по которым подобрана таблица.
|
Name |
Description |
|
categoryId |
Type: integer Идентификатор категории из запроса. |
|
genderId |
Type: integer Идентификатор пола на Маркете. |
|
vendorId |
Type: integer Идентификатор бренда на Маркете. Возвращается только для таблиц бренда. |
Example
{
"categoryId": 0,
"vendorId": 0,
"genderId": 0
}
SizeTableColumnType
Тип колонки таблицы размеров:
SIZE_CHART— размерная сетка, по которой определяется размер товара.MEASUREMENT— обмер, например обхват груди или длина стопы. В определении размера товара не участвует.
Type: string
Enum: SIZE_CHART, MEASUREMENT
SizeValueDTO
Значение в ячейке таблицы размеров.
|
Name |
Description |
|
rowIndex |
Type: integer Номер строки таблицы, начиная с 0. Значения с одинаковым Номера могут идти с пропусками, а порядок строк может не совпадать с порядком размеров. Собирайте строки
по значению Min value: |
|
sizeValue |
Type: string Значение размера или обмера. Example: |
|
sizeValueId |
Type: integer Идентификатор значения размера. Возвращается, только если у колонки есть справочник значений — это стандартные размерные сетки Маркета. В сетках, созданных бизнесом, брендовых сетках и обмерах значение задается только текстом. |
Example
{
"sizeValueId": 0,
"sizeValue": "example",
"rowIndex": 0
}
SizeChartDTO
Колонка таблицы размеров — размерная сетка или обмер.
|
Name |
Description |
|
columnType |
Type: SizeTableColumnType Тип колонки таблицы размеров:
Enum: |
|
sizeChartId |
Type: integer Идентификатор размерной сетки или обмера. У сеток и обмеров общее пространство идентификаторов. |
|
sizeChartName |
Type: string Название размерной сетки или обмера. Example: |
|
sizes |
Type: SizeValueDTO[] Значения колонки в порядке строк таблицы. Пустые ячейки не возвращаются. Example
|
Example
{
"sizeChartId": 0,
"sizeChartName": "example",
"columnType": "SIZE_CHART",
"sizes": [
{
"sizeValueId": 0,
"sizeValue": "example",
"rowIndex": 0
}
]
}
SizeTableDTO
Таблица размеров.
|
Name |
Description |
|
editable |
Type: boolean Может ли бизнес редактировать таблицу: |
|
sizeCharts |
Type: SizeChartDTO[] Колонки таблицы: размерные сетки и обмеры. Колонки без значений не возвращаются. Example
|
|
sizeParameterId |
Type: integer Идентификатор размерной характеристики, к которой относятся размеры из таблицы. |
|
sizeTableId |
Type: integer Идентификатор таблицы размеров. |
|
sizeTableName |
Type: string Название таблицы размеров. Example: |
|
sizeTableType |
Type: SizeTableType Тип таблицы размеров:
Enum: |
|
key |
Type: SizeTableKeyDTO Условия подбора таблицы. Возвращаются, только если таблица подобрана по категории. Условия, по которым подобрана таблица. Example
|
Example
{
"sizeTableId": 0,
"sizeTableName": "example",
"sizeTableType": "CUSTOM",
"sizeParameterId": 0,
"editable": true,
"key": {
"categoryId": 0,
"vendorId": 0,
"genderId": 0
},
"sizeCharts": [
{
"sizeChartId": 0,
"sizeChartName": "example",
"columnType": "SIZE_CHART",
"sizes": [
{
"sizeValueId": 0,
"sizeValue": "example",
"rowIndex": 0
}
]
}
]
}
PackagingForwardScrollingPagerDTO
Идентификатор следующей страницы.
|
Name |
Description |
|
nextPageToken |
Type: string Идентификатор следующей страницы результатов. Example: |
Example
{
"nextPageToken": "example"
}
SuggestSizeTablesResultDTO
Подходящие таблицы размеров.
|
Name |
Description |
|
paging |
Type: PackagingForwardScrollingPagerDTO Идентификатор следующей страницы. Example
|
|
sizeTables |
Type: SizeTableDTO[] Подходящие таблицы размеров: сначала созданные бизнесом, затем брендовые, затем стандартные; внутри каждой группы — по убыванию идентификатора. Example
|
|
sizeParameterId |
Type: integer Идентификатор размерной характеристики категории. Отсутствует, если у категории нет размерной характеристики — тогда и таблиц нет. |
Example
{
"sizeParameterId": 0,
"sizeTables": [
{
"sizeTableId": 0,
"sizeTableName": "example",
"sizeTableType": "CUSTOM",
"sizeParameterId": 0,
"editable": true,
"key": {
"categoryId": 0,
"vendorId": 0,
"genderId": 0
},
"sizeCharts": [
{
"sizeChartId": 0,
"sizeChartName": "example",
"columnType": "SIZE_CHART",
"sizes": [
null
]
}
]
}
],
"paging": {
"nextPageToken": "example"
}
}
400 Bad Request
Запрос содержит неправильные данные. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
ApiErrorDTO
Общий формат ошибки.
|
Name |
Description |
|
code |
Type: string Код ошибки. Example: |
|
message |
Type: string Описание ошибки. Example: |
Example
{
"code": "example",
"message": "example"
}
ApiErrorResponse
Стандартная обертка для ошибок сервера.
Type: object
All of 2 types
-
Type: ApiResponse
Стандартная обертка для ответов сервера.
Example
{ "status": "OK" } -
Type: object
errors
Type: ApiErrorDTO[] | null
Список ошибок.
Min items:
1Example
[ { "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: ApiErrorResponse
Стандартная обертка для ошибок сервера.
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: ApiErrorResponse
Стандартная обертка для ошибок сервера.
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: ApiErrorResponse
Стандартная обертка для ошибок сервера.
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: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
500 Internal Server Error
Внутренняя ошибка Маркета. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }