SberJson структура описания видеоконтента на метавитрине Салют ТВ

Обновлено 3 апреля 2024

Данная документация описывает структуру данных для передачи информации о видеоконтенте, которая используется для формирования метавитрины контента на всех поверхностях Салют ТВ. Наполнение полей по каждой единице каталога влияют на его доступность на устройствах пользователей. Важным фактором является соблюдение требований по формату и обязательности заполнения полей, так как это влияет на визуальное отображение в метавитринах и каталоге контента.

Изменения с прошлой версии

Добавлены требования к размеру и формату изображений
Обновлен справочник доступных жанров контента
Поля audioTracks и qualities стали необязательными

Принцип формирования и доставки данных

Поставщик контента формирует статичную ссылку, на которой размещается выгрузка (фид). Файл выгрузки должен быть доступен по протоколу HTTPS на домене поставщика контента.

Пример ссылки на файл: https://yoursite.ru/feed.json. Content-Type=application/json; charset=utf-8.
Ссылка может быть защищена паролем.

Для верификации источника фида SberDevices поддерживаются в том числе и white-листы, в таком случае понадобится статичный IP-адрес.

SberDevices могут быть рассмотрены и иные технические особенности интеграции, для этого обсудите их с вашим контактным лицом в SberDevices.

Производить обновление данных в файле выгрузки желательно не реже, чем один раз в сутки и не чаще, чем один раз в шесть часов.

При необходимости использования иных периодов обновления – обсудите это с вашим контактным лицом в SberDevices.

Каждая единица контента задается отдельным объектом.
Опции оплат задаются как массив в каждой единице контента.
Сериальная матрица может отсутствовать.
Если вами используются уникальные идентификаторы контента, сообщите об этом отдельно.
При необходимости передавать новый тип контента необходимо согласовать добавление нового ТИПА, размещение в некорректных уже существующих типах контента запрещено.
У единицы контента может быть указано несколько «жанров». Справочник доступных жанров приведен в комментарии к соответствующему полю.
Маркировка возраста, эротики и порноконтента обязательна.

В случае отсутствия данных по полям помеченных в текущей документации как обязательные свяжитесь с вашим контактным лицом в SberDevices.

Полнота контента

Ожидается, что поставщик предоставляет весь доступный контент, кроме UGC. Если имеющиеся типы не охватывают полноту каталога (например, спортивный контент), то свяжитесь с вашим контактным лицом в SberDevices для согласования добавления новых типов.
Добавление UGC контента в фид имеет смысл при условии, что его использование запланировано совместно. Любые детали всегда можно уточнить у контактного лица в SberDevices.
В фиде могут быть переданы подборки контента, как отдельный объект данных, их промо размещение (формат, срок, состав, стоимость и т.д.) согласуется отдельно через менеджера SberDevices.
Если планируется отправка промоподборок и их обновление силами собственных контент-менеджеров, то возможно создание отдельных галерей контента с уникальными идентификаторами, которые далее необходимо сообщить менеджеру SberDevices.

Требования к размеру и формату изображений

Название	Формат	Размер, px
Горизонтальные изображения covers	.webp	640 х 360
Квадратные виджеты (square_small_type)	.webp	640 х 640
Вертикальные изображения covers	.webp	640 х 960
Фоновое изображение для карточки контента без логотипа/названия фильма/сериала thumbnails	.webp	1920 х 1080
Изображение с названием/логотипом фильма/сериала titleImage	.png/.webp (с прозрачным фоном)	Максимальные размеры контейнера для изображения: ширина - 392 высота - 80

Примеры использования изображений

Описание SberJson

Общая схема

Пример
Описание

provider required	string Название поставщика
version required	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"originalTitle": [ ],
"tagline": "string",
"description": "string",
"year": 2010,
"created": "2024-01-30T21:00:00Z\n",
"duration": 1673598990054,
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": [{"link": "/imageid=215",
"resolution": "640x360"
}
],
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"keyNumber": "string",
"cards": [{"sequence": 0,
"id": "string"
}
],
"links": [{"type": "string",
"value": "string"
}
],
"trailers": ["https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4"
],
"streamPreview": "string",
"actors": ["string"
],
"directors": ["string"
],
"creators": [{"creatorTitle": "string",
"creatorType": "string",
"deepLink": "string",
"icon": "string"
}
],
"cameramen": ["string"
],
"producers": ["string"
],
"artists": ["string"
],
"composers": ["string"
],
"screenwriters": ["string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [{"provider": "string",
"value": "8.7"
}
],
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [{"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": ["string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [{"seasonSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [{"episodeSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"links": "string"
}
],
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}

provider required	string Название поставщика
version required	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"originalTitle": [ ],
"tagline": "string",
"description": "string",
"year": 2010,
"created": "2024-01-30T21:00:00Z\n",
"duration": 1673598990054,
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": [{"link": "/imageid=215",
"resolution": "640x360"
}
],
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"keyNumber": "string",
"cards": [{"sequence": 0,
"id": "string"
}
],
"links": [{"type": "string",
"value": "string"
}
],
"trailers": ["https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4"
],
"streamPreview": "string",
"actors": ["string"
],
"directors": ["string"
],
"creators": [{"creatorTitle": "string",
"creatorType": "string",
"deepLink": "string",
"icon": "string"
}
],
"cameramen": ["string"
],
"producers": ["string"
],
"artists": ["string"
],
"composers": ["string"
],
"screenwriters": ["string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [{"provider": "string",
"value": "8.7"
}
],
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [{"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": ["string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [{"seasonSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [{"episodeSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"links": "string"
}
],
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}

Пример формирования элемента MOVIE

Пример
Описание

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"originalTitle": [ ],
"tagline": "string",
"description": "string",
"year": 2010,
"duration": "1673598990054",
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [{"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"actors": ["string"
],
"directors": ["string"
],
"cameramen": ["string"
],
"producers": ["string"
],
"artists": ["string"
],
"composers": ["string"
],
"screenwriters": ["string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [{"provider": "string",
"value": "8.7"
}
],
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [{"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": ["string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [{"seasonSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [{"episodeSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"links": "string"
}
],
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"originalTitle": [ ],
"tagline": "string",
"description": "string",
"year": 2010,
"duration": "1673598990054",
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [{"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"actors": ["string"
],
"directors": ["string"
],
"cameramen": ["string"
],
"producers": ["string"
],
"artists": ["string"
],
"composers": ["string"
],
"screenwriters": ["string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [{"provider": "string",
"value": "8.7"
}
],
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [{"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": ["string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [{"seasonSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [{"episodeSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"links": "string"
}
],
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}

Пример формирования элемента SERIES

Пример
Описание

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"originalTitle": [ ],
"tagline": "string",
"description": "string",
"year": 2010,
"duration": "1673598990054",
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [{"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"actors": ["string"
],
"directors": ["string"
],
"cameramen": ["string"
],
"producers": ["string"
],
"artists": ["string"
],
"composers": ["string"
],
"screenwriters": ["string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [{"provider": "string",
"value": "8.7"
}
],
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [{"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": ["string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [{"seasonSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [{"episodeSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"links": "string"
}
],
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"originalTitle": [ ],
"tagline": "string",
"description": "string",
"year": 2010,
"duration": "1673598990054",
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [{"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"actors": ["string"
],
"directors": ["string"
],
"cameramen": ["string"
],
"producers": ["string"
],
"artists": ["string"
],
"composers": ["string"
],
"screenwriters": ["string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [{"provider": "string",
"value": "8.7"
}
],
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [{"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": ["string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [{"seasonSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [{"episodeSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"links": "string"
}
],
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}

Пример формирования элемента TVCHANNEL

Пример
Описание

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"originalTitle": [ ],
"description": "string",
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"keyNumber": "string",
"cards": [{"sequence": 0,
"id": "string"
}
],
"links": [{"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"ratings": [{"provider": "string",
"value": "8.7"
}
],
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
]
}
]
}

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"originalTitle": [ ],
"description": "string",
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"keyNumber": "string",
"cards": [{"sequence": 0,
"id": "string"
}
],
"links": [{"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"ratings": [{"provider": "string",
"value": "8.7"
}
],
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
]
}
]
}

Пример формирования элемента TVSHOW

Пример
Описание

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"originalTitle": [ ],
"tagline": "string",
"description": "string",
"year": 2010,
"duration": "1673598990054",
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [{"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"actors": ["string"
],
"directors": ["string"
],
"cameramen": ["string"
],
"producers": ["string"
],
"artists": ["string"
],
"composers": ["string"
],
"screenwriters": ["string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [{"provider": "string",
"value": "8.7"
}
],
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [{"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": ["string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [{"seasonSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [{"episodeSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"links": "string"
}
],
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"originalTitle": [ ],
"tagline": "string",
"description": "string",
"year": 2010,
"duration": "1673598990054",
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [{"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"actors": ["string"
],
"directors": ["string"
],
"cameramen": ["string"
],
"producers": ["string"
],
"artists": ["string"
],
"composers": ["string"
],
"screenwriters": ["string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [{"provider": "string",
"value": "8.7"
}
],
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [{"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": ["string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [{"seasonSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [{"episodeSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"links": "string"
}
],
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}

Пример формирования элемента UGC

Пример
Описание

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"tagline": "string",
"description": "string",
"created": "2024-01-30T21:00:00Z",
"duration": 1673598990054,
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [{"type": "string",
"value": "string"
}
],
"streamPreview": "string",
"creators": [{"creatorTitle": "string",
"creatorType": "string",
"deepLink": "string",
"icon": "string"
}
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [{"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": ["string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [{"seasonSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [{"episodeSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"links": "string"
}
],
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"customLabels": ["string"
],
"tagline": "string",
"description": "string",
"created": "2024-01-30T21:00:00Z",
"duration": 1673598990054,
"covers": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [{"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [{"type": "string",
"value": "string"
}
],
"streamPreview": "string",
"creators": [{"creatorTitle": "string",
"creatorType": "string",
"deepLink": "string",
"icon": "string"
}
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"specialContentTag": ["string"
],
"countries": ["RUS"
],
"genres": ["string"
],
"similar": ["string"
],
"ageRestrictions": "string",
"externalIds": [{"name": "string",
"value": "string"
}
],
"qualities": [{"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [{"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": ["string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 -  сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [{"seasonSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [{"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [{"episodeSeq": 0,
"title": "string",
"customLabels": ["string"
],
"links": [{"type": "string",
"links": "string"
}
],
"screenshots": [{"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}

Пример формирования элемента GALLERY

Пример
Описание

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"cards": [{"sequence": 0,
"id": "string"
}
]
}
]
}

provider required	string Название поставщика
version	string Версия фида: 2.03 2.02 2.01
required	Array of objects[ items ]

{"provider": "videoprovider",
"version": "string",
"contents": [{"contentId": "string",
"type": "string",
"title": "string",
"cards": [{"sequence": 0,
"id": "string"
}
]
}
]
}

Как работать с датой релиза контента

Для управления доступностью контента рекомендуем использовать флаг availability, либо при недоступности возможно удаление контента из фида. Не желательно сохранять большое количество недоступных тайтлов в фиде, т.к. это приводит к увеличению размера файла и замедлению обновления каталога.
Для контента, дата начала доступности которого известна, можно использовать поле availabilityStartDate". При наступлении этой даты контент становится доступным (значение поля availability в таком случае игнорируется).
Для контента, дата начала недоступности которого известна, можно использовать поле availabilityEndDate. При наступлении этой даты контент становится недоступным (значения полей availability и availabilityStartDate в этом случае игнорируются).

//
"availability" : false,
"availabilityStartDate": "2024-01-01T00:00:01Z",
"availabilityEndDate": "2026-01-01T23:59:59Z",
//

Контент будет доступен в период указанных дат:

availabilityStartDate
availabilityEndDate

SberJson структура описания видеоконтента на метавитрине Салют ТВ

Принцип формирования и доставки данных﻿

Полнота контента﻿

Требования к размеру и формату изображений﻿

Описание SberJson﻿

Общая схема﻿

Пример формирования элемента MOVIE﻿

Пример формирования элемента SERIES﻿

Пример формирования элемента TVCHANNEL﻿

Пример формирования элемента TVSHOW﻿

Пример формирования элемента UGC﻿

Пример формирования элемента GALLERY﻿

Как работать с датой релиза контента﻿