Находите файлы на Яндекс Диске и считайте по выгрузкам

Агент обращается к REST API Диска по адресу cloud-api.yandex.net и работает с деревом подключённого аккаунта: перечисляет папки и файлы, читает метаданные — имя, тип, размер, дату изменения, — ищет документ по названию, расширению или папке и отдаёт ссылку вместо ручного листания. Он же берёт выгрузку или отчёт прямо с Диска, считает по ней цифры и следит за остатком места и появлением новых файлов в рабочих папках.

Одну особенность Диска стоит знать заранее: положить файл можно только по внешнему URL — передать содержимое напрямую API не позволяет. Поэтому результат расчёта агент возвращает через ссылку, а не потоком байт. Чужая папка попадает в его поле зрения лишь после того, как владелец выдал на неё «Просмотр» или «Редактирование» в «Настроить доступ», а удалённое уходит в корзину, откуда его ещё можно достать.

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

Большие операции — копирование и перенос папки — API выполняет асинхронно: в ответ приходит ссылка на статус, и агент дожидается завершения, а не рапортует «готово» на полпути. Точечно открыть доступ к одной папке REST API Диска не умеет, права всегда охватывают весь Диск, поэтому под ограниченный доступ заводят отдельный аккаунт. Частоту запросов агент держит сам, а пустую папку называет пустой, а не молчит.