Папки приложений
Приложения могут хранить на Диске пользователя собственные данные — например, настройки, сделанные этим пользователем или созданные им файлы. Чтобы запрашивать доступ к собственной папке на Диске, приложение следует зарегистрировать с правом Доступ к папке приложения на Диске.
Такое приложение сможет оперировать файлами только в рамках своей папки, если не получит также прав на общий доступ к Диску.
Организация папок приложений
Если на Диске пользователя еще нет папки какого-либо приложения, она создается автоматически, при первом запросе с соответствующим OAuth-токеном. Имя папки соответствует имени приложения на Яндекс.OAuth. Если такая папка уже существует, к имени приложения добавляется его идентификатор, например foo_4760142d81bc4b7799476b42b5103713
.
Все папки приложений создаются в системном каталоге Приложения. По аналогии с другими системными каталогами, его имя задается в соответствии с языком учетной записи (например, для англоязычных пользователей этот каталог называется Apps).
Внимание
Файлы в каталоге Приложения полностью доступны пользователю, могут быть удалены, перемещены и переименованы.
Путь к папке приложения
Для доступа к собственной папке можно использовать схему адреса app:/
. Например, список ресурсов в своей корневой папке приложение может получить таким запросом:
https://cloud-api.yandex.net/v1/disk/resources?path=app:/
В ответах API пути указываются в схеме disk:/
, с абсолютными путями к ресурсам. Например, приложение Foo получает ответ о своем файле photo.png
:
{
"name": "photo.png",
"created": "2014-04-21T14:57:13+04:00",
"modified": "2014-04-21T14:57:14+04:00",
"path": "disk:/Приложения/Foo/photo.png",
"md5": "4334dc6379c8f95ddf11b8508cfea271",
"type": "file",
"mime_type": "application/x-www-form-urlencoded",
"size": 34567
}