Как подключить плекс в экселе: автоматизация медиатеки

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

Интеграция позволяет выгружать списки фильмов, отслеживать статистику просмотров и создавать уникальные дашборды, недоступные в стандартном приложении. Это превращает разрозненные файлы в структурированный массив данных, готовый к фильтрации и сортировке.

Процесс подключения требует понимания принципов работы с веб-адресами и форматами данных. Однако, используя встроенные средства Microsoft Excel, можно наладить автоматический обмен информацией без написания сложного программного кода.

Подготовка к интеграции данных из Plex

Прежде чем начать настройку соединения, необходимо получить доступ к API вашего сервера. Plex API позволяет внешним приложениям запрашивать информацию о библиотеках, фильмах и пользователях. Для успешного подключения вам потребуется токен доступа, который выступает в роли цифрового ключа.

Получить токен можно через официальный сайт разработчиков или изучив сетевые запросы в браузере при авторизации. Этот код критически важен, так как без него сервер отклонит любой запрос от Excel.

Где найти токен Plex?

Токен можно найти в файле конфигурации Preferences.xml на сервере или получить, выполнив запрос к API авторизации с логином и паролем. Храните токен в секрете, так как он дает полный доступ к вашему серверу.

Также важно знать точный адрес вашего сервера в локальной сети или внешний IP, если вы планируете подключаться удаленно. Стандартный порт для Plex обычно равен 32400. Убедитесь, что брандмауэр не блокирует входящие соединения на этот порт.

⚠️ Внимание: Никогда не публикуйте свой токен доступа или внешний IP-адрес в открытых источниках. Это может привести к несанкционированному доступу к вашей медиатеке.

Получение и анализ URL-адреса API

Основой для подключения служит правильно сформированный URL-запрос. Он содержит адрес сервера, путь к библиотеке и параметры фильтрации. Понимание структуры этого адреса поможет вам гибко управлять выгружаемыми данными.

Базовый шаблон запроса выглядит следующим образом: http://[IP_АДРЕС]:32400/library/sections/[ID_БИБЛИОТЕКИ]/all?X-Plex-Token=[ВАШ_ТОКЕН]. Здесь ID_БИБЛИОТЕКИ — это уникальный номер вашей коллекции фильмов или сериалов, который можно найти в свойствах библиотеки через веб-интерфейс Plex.

Для экспорта данных в формате, понятном Excel, к адресу необходимо добавить параметр типа данных. Чаще всего используется формат JSON, так как он лучше сохраняет структуру вложенных метаданных, чем CSV или XML.

Добавьте к концу строки параметр &type=1 для фильмов или &type=2 для сериалов, если это необходимо для конкретной версии API. Финальный адрес должен быть проверен в браузере: если вы видите код из строк и скобок, значит, сервер ответил корректно.

Настройка подключения через Power Query

Для импорта данных в Excel используется встроенный инструмент Power Query. Он позволяет создавать устойчивые соединения с веб-источниками и обновлять данные по щелчку мыши. Откройте вкладку Данные и выберите пункт Получить данные → Из других источников → Из веб.

В открывшемся окне вставьте ранее подготовленный URL-адрес с токеном. Excel может запросить дополнительные параметры подключения. В режиме расширенных настроек убедитесь, что метод запроса установлен как GET.

При первом подключении система безопасности может предупредить о конфиденциальности. Выберите уровень доступа Анонимный, так как авторизация уже встроена в сам URL-адрес через токен. Нажмите кнопку OK для продолжения.

Если сервер использует самоподписанный SSL-сертификат, может потребоваться игнорирование ошибок сертификата. В настройках источника данных Power Query можно отключить проверку SSL, однако делать это стоит только в доверенной локальной сети.

Преобразование JSON в таблицу Excel

После успешного подключения Power Query отобразит навигатор, где данные будут представлены в виде записи Record или списка List. Чтобы увидеть содержимое, нажмите кнопку Преобразовать данные. Откроется редактор запросов, где начнется основная работа.

В открывшемся окне вы увидите столбец с названием MediaContainer, внутри которого находится поле Metadata. Именно в Metadata хранится список всех ваших фильмов. Нажмите на значок расширения (две стрелочки) в заголовке столбца Metadata, чтобы развернуть список.

Excel предложит выбрать поля для извлечения. Для базовой таблицы фильмов выберите: title (название), year (год), addedAt (дата добавления) и rating (оценка). Не забудьте снять галочку с опции"Исполь оригинальное имя столбца как префикс", чтобы заголовки были читаемыми.

После расширения полей вы получите классическую таблицу. Некоторые поля могут содержать вложенные структуры, например, жанры или актеры. Их также можно раскрыть, но это создаст дополнительные столбцы или строки в зависимости от выбранной стратегии обработки.

Обработка и очистка импортированных данных

Сырые данные из API часто требуют дополнительной обработки. Даты могут приходить в формате Unix Timestamp (количество секунд с 1970 года), а не в привычном виде. Чтобы исправить это, создайте новый столбец и используйте формулу преобразования времени.

Для конвертации времени добавьте вычисляемый столбец с формулой, делящей значение на 86400 (секунд в сутках) и прибавляющей базовую дату. В интерфейсе Power Query это можно сделать через меню Добавить столбец → Дата и время → От начала эпохи, выбрав секунды.

Текстовые поля, такие как названия жанров, могут быть объединены через запятую. Используйте функцию Text.Combine или инструмент"Разделить столбец", чтобы разнести жанры по отдельным ячейкам для последующей фильтрации.

Удалите лишние столбцы, которые не несут смысловой нагрузки, например, технические идентификаторы key или librarySectionID, если вы не планируете использовать их для связей с другими таблицами. Это уменьшит размер итогового файла.

Автоматизация и обновление отчета

Главное преимущество использования Power Query — возможность обновления данных. Когда вы добавите новый фильм в Plex, достаточно нажать кнопку Обновить все на вкладке Данные в Excel, чтобы таблица актуализировалась.

Для полной автоматизации можно настроить обновление по расписанию. Перейдите в параметры подключения и установите интервал обновления, например, каждые 60 минут. Это позволит держать отчет в актуальном состоянии без вашего участия.

Сохраните файл Excel в формате .xlsx или .xlsm, если используете макросы. При открытии файла на другом компьютере может потребоваться ввести учетные данные заново или подтвердить доверие источнику данных.

⚠️ Внимание: При перемещении файла Excel на другой компьютер пути к источникам данных могут сбиться. Используйте относительные пути или убедитесь, что новый ПК имеет доступ к IP-адресу сервера Plex.

Часто задаваемые вопросы (FAQ)

Почему Excel выдает ошибку при подключении к URL?

Чаще всего проблема кроется в неверном формате токена или блокировке порта 32400 антивирусом. Проверьте, открывается ли ссылка с токеном в обычном браузере. Если браузер показывает XML/JSON код, значит ссылка рабочая, и ошибку нужно искать в настройках прокси Excel.

Можно ли выгрузить данные о просмотрах конкретных пользователей?

Да, API Plex позволяет фильтровать данные. Добавив параметр &watched=1 или используянные эндпоинты для истории просмотров, можно получить детальную статистику. Однако структура JSON для истории сложнее и требует более глубокой вложенности при разборе в Power Query.

Как часто можно обновлять данные без нагрузки на сервер?

Запросы к API легковесны, но частое обновление (каждую минуту) может создать нагрузку на процессор сервера, особенно если он работает на Raspberry Pi или слабом NAS. Оптимальный интервал — один раз в час или по требованию.

Что делать, если пропали столбцы после обновления?

Если структура данных в Plex изменилась (редко, но бывает при обновлении сервера), Power Query может не найти старые поля. Зайдите в редактор запросов, найдите шаг"Развернуть" и заново выберите необходимые поля из списка доступных.