Для автоматизации наполнения каталога фильмов и сериалов в Smarty можно использовать внешние источники меты. На данный момент в Smarty интегрировано 2 источника:
- KINOPOISK_API_UNOFFICIAL — неофициальный API для получения меты о фильмах с ресурса Кинопоиск. Ключ доступа настраивается с помощью опции
TVMIDDLEWARE_KINOPOISK_API_UNOFFICIAL_API_KEY - TMDB — недоступен в РФ, имеет возможность импорта меты на разных языках с помощью параметра
TVMIDDLEWARE_TMDB_IMPORT_LANGUAGE. Ключ доступа настраивается с помощью опцииTVMIDDLEWARE_TMDB_API_KEY, при создании объекта Video необходимо указывать, фильм это или сериал (как при создании Video в админке, так и через API).
Сценарии использования источников меты
Создание/редактирование фильмов и актёров в админке
При создании фильма в админке требуется указать идентификатор фильма во внешней системе в специальном поле и нажать на кнопку «Загрузить данные». Данные будут загружаться какое-то время, после чего пустые поля заполнятся информацией из внешнего ресурса. Для полей-изображений заполняется поле с URL изображения, с которого после нажатия на кнопку «Сохранить» происходит скачивание изображения на сервер Smarty.
Создание/редактирование фильмов через Content API
Чтобы загрузить мету для фильмов и сериалов при работе через API, следует передать параметр load_meta в методы VideoCreate/VideoModify. Для подгрузки меты для актёров требуется указание параметра movie_db_id в запросы ActorCreate/ActorModify.
Интеграции с онлайн-кинотеатрами
Не все интегрированные онлайн-кинотеатры предоставляют полный набор меты для своих фильмов, например, для фильмов кинотеатра Premier не предоставляются данные об актёрах — эту информацию дополнительно можно заполнить с помощью опции --load_actor_meta_from_mdb в команде premier_sync_content.
Доступная мета для фильмов/сериалов
| Поле | KINOPOISK_API_UNOFFICIAL | TMDB |
| Название | есть | есть |
| Оригинальное название | есть | есть |
| Возрастной рейтинг | есть | есть |
| Рейтинг Кинопоиск | есть | есть |
| Рейтинг IMDB | есть | есть |
| Длительность фильма | есть | есть |
| Описание | есть | есть |
| Краткое описание | есть | нет |
| Язык | нет | нет |
| Страны производства | есть | есть |
| Год выпуска | есть | есть |
| Режиссёры | есть | есть |
| Актёры | есть | есть |
| Жанры | есть | есть |
| Постер | есть | есть |
| Кадр из фильма | есть | нет |
| Рекламный баннер | нет | нет |
| Сезоны сериала | есть | нет |
| Серии сериала | есть | нет |
| Названия серий | есть | нет |
| Описания серий | есть | нет |
Доступная мета для актёров
| Поле | KINOPOISK_API_UNOFFICIAL | TMDB |
| Имя | есть | есть |
| Оригинальное имя | есть | есть |
| Пол | есть | есть |
| Дата рождения | есть | есть |
| Страна | есть | есть |
| Профессия | есть | есть |
| Биография | нет | нет |
| Фото | есть | есть |
| Кадр с актёром | нет | нет |
FAQ
Как поведут себя данные о фильме/актёре, если запустить импорт меты дважды?
- При реимпорте меты фильма старые описания и изображения удаляются только если они будут заменены новыми данными.
- Реимпорт меты для актёров заполняет данные только для новых актёров и актёров без фотографий.
