# Облако Mail.ru

Разбирайте файлы в Облаке Mail.ru, не открывая браузер

Облачное хранилище Mail.ru по WebDAV — папки, файлы, загрузка и выгрузка

## Как агент работает с Облако Mail.ru

Агент работает с Облаком по протоколу WebDAV через webdav.cloud.mail.ru — тем же способом, которым облако подключают как сетевой диск. Он перечисляет папки и файлы, читает метаданные — имя, размер, тип, дату изменения, — находит документ по части названия и показывает, сколько места занято и сколько осталось. Это же даёт разбор выгрузки: файл забирается из Облака целиком и считается, а не пересказывается по имени.

В отличие от Яндекс Диска, файл сюда кладётся содержимым: агент передаёт байты напрямую методом PUT, внешняя ссылка не нужна, поэтому результат расчёта возвращается файлом, а не адресом для скачивания. Копирование и перенос WebDAV выполняет синхронно — ответ приходит, когда операция уже завершилась, и «готово» на полпути тут невозможно в принципе.

У протокола есть и обратная сторона, которую агент не скрывает. Серверного поиска в WebDAV нет: агент обходит дерево папку за папкой и держит обход в границах — по глубине, числу папок и числу совпадений. Упершись в границу, он говорит, что список неполный, вместо того чтобы выдать частичный результат за исчерпывающий. Публичных ссылок и корзины в протоколе тоже нет — это функции самого Облака, не WebDAV.

Подключается не пароль от аккаунта, а отдельный пароль для внешних приложений, и отзывается он в настройках Mail.ru отдельно, без смены основного пароля. Доступ ограничен Облаком того ящика, чей пароль подключён. Перед перезаписью файла с тем же именем и перед удалением агент спрашивает: удаление убирает и файл, и целиком папку со всем содержимым, а вернуть удалённое тем же путём, каким оно ушло, агент не может — восстановления в протоколе нет, и лежит ли копия в Корзине Облака, ему не видно.

## Сценарии интеграции

### Поиск документа в Облаке
Агент обойдёт папки, найдёт файл по части названия и назовёт путь, размер и дату изменения — без ручного листания дерева.

### Расчёт по выгрузке из Облака
Агент заберёт выгрузку или отчёт прямо из Облака, посчитает по ней цифры и положит результат обратно в нужную папку.

### Загрузка готового файла
Агент зальёт подготовленный документ в Облако содержимым, а не ссылкой, и скажет, по какому пути он теперь лежит.

### Наведение порядка в папках
Агент заведёт папку, перенесёт или скопирует в неё файлы и уберёт лишнее, называя каждый путь явно.

### Сколько осталось места
Агент покажет занятое и свободное место в Облаке, чтобы загрузка не упёрлась в квоту в самый неподходящий момент.

### Дубли и старые версии
Агент сверит имена, размеры и даты в рабочей папке и покажет дубли и устаревшие версии одного документа.

## Как подключить

**Перед подключением**

- Полный адрес ящика Mail.ru и доступ к его настройкам.
- Место в Облаке под новые файлы.
- Публичные ссылки и корзина по WebDAV недоступны.

### Привяжите телефон к ящику
Пароль для внешних приложений выдают только ящику с телефоном. Откройте «Настройки» → «Все настройки» → «Контакты и адреса» и добавьте номер, если его нет.

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

### Создайте пароль и скопируйте его сразу
Нажмите «Создать» и дайте паролю понятное название — по нему его потом отзывают. Пароль показывается один раз и нигде не сохраняется.

### Проверьте место в Облаке
Агент работает с тем же Облаком, что открывается на cloud.mail.ru: читает файлы и кладёт новые. Если свободного места нет, загрузка не пройдёт.

## Частые вопросы

### Как подключить Облако Mail.ru?
Адресом ящика и паролем для внешних приложений. В «Настройки» → «Безопасность» откройте «Пароли для внешних приложений», создайте пароль и скопируйте его сразу — он показывается один раз.

### Что агент видит в Облаке?
Папки и файлы Облака того ящика, чей пароль подключён: имя, путь, размер, тип и дату изменения, а также занятое и свободное место.

### Может ли агент загружать файлы?
Да, содержимым напрямую: агент кладёт файл в Облако методом PUT, создаёт папки, переносит, копирует и удаляет. Внешняя ссылка для загрузки не нужна.

### Почему агент не даёт публичную ссылку?
Публикация и корзина — функции интерфейса Облака, а не протокола WebDAV. По WebDAV их выразить нечем, поэтому агент за них не берётся и говорит об этом прямо.

[Открыть Облако Mail.ru](https://e.mail.ru/settings/security)