API возвращает список последних файлов, загруженных на Диск.
Список можно фильтровать по типу файла (аудио, видео, изображение и т. д.). Диск определяет тип каждого файла при загрузке.
Формат запроса
Запрос последних загруженных файлов следует отправлять с помощью метода GET.
Https://cloud-api.yandex.net/v1/disk/resources/last-uploaded
? [\n Значение по умолчанию - 20. \n "}}">limit
Тип файлов, которые нужно включить в список. Диск определяет тип каждого файла\n при загрузке. Чтобы запросить несколько типов файлов, можно перечислить их в значении параметра\n через запятую. Например, media_type=\"audio,video\" . Поддерживаемые типы: Список свойств JSON, которые следует включить в ответ. Ключи, не указанные в этом\n списке, будут отброшены при составлении ответа. Если параметр не указан, ответ\n возвращается полностью, без сокращений. Имена ключей следует указывать через запятую, а вложенные ключи разделять\n точками. Например: name,_embedded.items.path . \n "}}">fields
Требуемый размер уменьшенного изображения (превью файла), ссылку на которое Диск\n должен вернуть в ключе preview . Вы можете задать как точный размер превью, так и размер одной из сторон.\n Получившееся изображение можно обрезать до квадрата с помощью параметра\n preview_crop . Варианты значений
Картинка уменьшается до указанного размера по большей стороне,\n пропорции исходного изображения сохраняются. Например, для размера S и\n картинки размером 120×200 будет сгененерировано превью размером 90×150,\n а для картинки 300×100 - превью размером 150×50. Поддерживаемые значения: \"S\" - 150 пикселей; Точная ширина (например, \"120\" или\n \"120x\") или точная высота (например,\n \"x145\"). Картинка уменьшается до указанной ширины или высоты, пропорции\n исходного изображения сохраняются. Если передан параметр preview_crop , из центра\n уменьшенного изображения также вырезается квадрат с заданной\n стороной. Точный размер (в формате\n <ширина>x<высота> , например\n \"120x240\"). Картинка уменьшается до меньшего из указанных размеров, пропорции\n исходного изображения сохраняются. Если передан параметр preview_crop , из центра\n оригинального изображения вырезается фрагмент максимального размера в\n заданных пропорциях ширины и высоты (в примере - один к двум). Затем\n вырезанный фрагмент масштабируется до указанных размеров.\n
\n "}}">media_type
=<тип запрашиваемых файлов>]
& [\n \n \n
\n\n
\n\n \n
\n \n \n \n\n "}}">preview_size
=<размер превью>]
& [\n Параметр позволяет обрезать превью согласно размеру, заданному в значении\n параметра preview_size . Допустимые значения: Если передана только ширина или высота, картинка уменьшается до этого\n размера с сохранением пропорций. Затем из центра уменьшенного изображения\n также вырезается квадрат с заданной стороной. Если передан точный размер (например, \"120x240\"), из\n центра оригинального изображения вырезается фрагмент максимального размера\n в заданных пропорциях ширины и высоты. Затем вырезанный фрагмент\n масштабируется до указанных размеров.\n \n \n \n
\n "}}">preview_crop
=<признак обрезки превью>]
\n
\n\n
Query-параметры | |
limit | Значение по умолчанию - 20. |
media_type | Поддерживаемые типы:
|
fields | |
preview_size | Варианты значений
Предопределенный размер большей стороны. Поддерживаемые значения: Точный размер (в формате <ширина>x<высота> , например "120x240"). |
preview_crop | Допустимые значения: false - параметр игнорируется (по умолчанию). true - превью обрезается следующим образом: |
Query-параметры | |
limit | Количество последних загруженных файлов, описание которых следует вернуть в ответе (например, для постраничного вывода). Значение по умолчанию - 20. |
media_type | Тип файлов, которые нужно включить в список. Диск определяет тип каждого файла при загрузке. Чтобы запросить несколько типов файлов, можно перечислить их в значении параметра через запятую. Например, media_type="audio,video" . Поддерживаемые типы:
|
fields | Список свойств JSON, которые следует включить в ответ. Ключи, не указанные в этом списке, будут отброшены при составлении ответа. Если параметр не указан, ответ возвращается полностью, без сокращений. Имена ключей следует указывать через запятую, а вложенные ключи разделять точками. Например: name,_embedded.items.path . |
preview_size | Требуемый размер уменьшенного изображения (превью файла), ссылку на которое Диск должен вернуть в ключе preview . Вы можете задать как точный размер превью, так и размер одной из сторон. Получившееся изображение можно обрезать до квадрата с помощью параметра preview_crop . Варианты значений
Предопределенный размер большей стороны. Картинка уменьшается до указанного размера по большей стороне, пропорции исходного изображения сохраняются. Например, для размера S и картинки размером 120×200 будет сгененерировано превью размером 90×150, а для картинки 300×100 - превью размером 150×50. Поддерживаемые значения: Точная ширина (например, "120" или "120x") или точная высота (например, "x145"). Картинка уменьшается до указанной ширины или высоты, пропорции исходного изображения сохраняются. Если передан параметр preview_crop , из центра уменьшенного изображения также вырезается квадрат с заданной стороной. Точный размер (в формате <ширина>x<высота> , например "120x240"). Картинка уменьшается до меньшего из указанных размеров, пропорции исходного изображения сохраняются. Если передан параметр preview_crop , из центра оригинального изображения вырезается фрагмент максимального размера в заданных пропорциях ширины и высоты (в примере - один к двум). Затем вырезанный фрагмент масштабируется до указанных размеров. |
preview_crop | Параметр позволяет обрезать превью согласно размеру, заданному в значении параметра preview_size . Допустимые значения:
false - параметр игнорируется (по умолчанию). true - превью обрезается следующим образом: |
Формат ответа
Если запрос был обработан без ошибок, API отвечает кодом 200 OK , и возвращает метаинформацию о запрошенном количестве файлов в теле ответа, в объекте . Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки .
Пример ответа:
{ "Массив последних загруженных файлов (\n \n)."}}">items ": [ { "Имя ресурса."}}">name ": "photo2.png", "\n\n"}}">preview
Дата и время создания ресурса, в формате ISO 8601 ."}}">created ": "2014-04-22T14:57:13+04:00", ", в формате ISO 8601 ."}}">modified ": "2014-04-22T14:57:14+04:00", "\n\n"}}">path
": "disk:/foo/photo2.png", "MD5-хэш файла."}}">md5 ": "53f4dc6379c8f95ddf11b9508cfea271", "\nТип ресурса:
- \n
- «dir» - папка; \n
- «file» - файл. \n
Запросить превью можно только с OAuth-токеном пользователя, имеющего доступ к самому файлу.
\n"}}">preview
": "https://downloader.disk.yandex.ru/preview/...", "Дата и время создания ресурса, в формате ISO 8601 ."}}">created ": "2014-04-21T14:57:13+04:00", "Дата и время изменения ресурса, в формате ISO 8601 ."}}">modified ": "2014-04-21T14:57:14+04:00", "\nПолный путь к ресурсу на Диске.
Для ресурса, находящегося в Корзине, к атрибуту может быть добавлен уникальный идентификатор (например, trash:/foo_1408546879). С помощью этого идентификатора ресурс можно отличить от других удаленных ресурсов с тем же именем.
\n"}}">path
": "disk:/foo/photo1.png", "MD5-хэш файла."}}">md5 ": "4334dc6379c8f95ddf11b9508cfea271", "\nТип ресурса:
- \n
- «dir» - папка; \n
- «file» - файл. \n
Количество последних загруженных файлов, описание которых следует вернуть в\n ответе (например, для постраничного вывода).
Значение по умолчанию - 20.
\n"}}">limit
": 20, }Элемент | Описание | ||
---|---|---|---|
items | Массив последних загруженных файлов (). | ||
limit | Максимальное количество элементов в массиве items , заданное в запросе. |
||
Элемент | Описание | ||
public_key | |||
public_url | Включается в ответ только если указанный файл или папка опубликован. |
||
_embedded | |||
preview | Запросить превью можно только с OAuth-токеном пользователя, имеющего доступ к самому файлу. |
||
name | Имя ресурса. | ||
custom_properties | |||
created | Дата и время создания ресурса, в формате ISO 8601 . | ||
modified | Дата и время изменения ресурса, в формате ISO 8601 . | ||
path | Полный путь к ресурсу на Диске. Для ресурса, находящегося в Корзине, к атрибуту может быть добавлен уникальный идентификатор (например, trash:/foo_1408546879). С помощью этого идентификатора ресурс можно отличить от других удаленных ресурсов с тем же именем. |
||
origin_path | public_key | Включается в ответ только если указанный файл или папка опубликован. |
|
public_url | Включается в ответ только если указанный файл или папка опубликован. |
||
_embedded | Ресурсы, непосредственно содержащиеся в папке (содержит объект ). Включается в ответ только при запросе метаинформации о папке. |
||
preview | Запросить превью можно только с OAuth-токеном пользователя, имеющего доступ к самому файлу. |
||
name | Имя ресурса. | ||
custom_properties | Объект со всеми атрибутами, заданными с помощью запроса Добавление метаинформации для ресурса . Содержит только ключи вида имя:значение (объекты или массивы содержать не может). | ||
created | Дата и время создания ресурса, в формате ISO 8601 . | ||
modified | Дата и время изменения ресурса, в формате ISO 8601 . | ||
path | Полный путь к ресурсу на Диске. Для ресурса, находящегося в Корзине, к атрибуту может быть добавлен уникальный идентификатор (например, trash:/foo_1408546879). С помощью этого идентификатора ресурс можно отличить от других удаленных ресурсов с тем же именем. |
||
origin_path | Путь к ресурсу до перемещения в Корзину. Включается в ответ только для запроса метаинформации о ресурсе в Корзине. |
||
md5 | MD5-хэш файла. | ||
type | Тип ресурса:
|
||
mime_type | MIME-тип файла. | ||
size | Размер файла. |
Скачали на компьютер файл с интернета и не получается открыть, потому что не можете его найти? Рассмотрим, как работает функционал поиска и управления загруженными файлами в браузерах: Mozilla Firefox, Opera, Google Chrome.
Для поиска закачек в Mozilla Firefox щелкните по значку со стрелочкой – откроется панель загрузок. В появившемся окошке вы увидели три последних загруженных файла, а чтобы просмотреть все загрузки, активируйте пункт «Показать все загрузки». Откройте необходимую загрузку двойным кликом мыши по файлу. Если список загрузок очищен, но вы точно помните, что скачивали файл через мазилу, обратитесь к окну «Настройки» на вкладку «Основные». Посмотрите путь для сохранения файлов в разделе загрузок. Далее найдите свой файл в папке «Загрузки», следуя подсказке. В Mozilla Firefox по умолчанию именно в нее попадают интернетовские закачки. В веб-обозревателе Opera аналогично Mozilla Firefox загрузки открываются через панель «Загрузки», которая располагается в верхнем углу справа. Щелкните на стрелочку – увидите список последних закачек. Нажмите «Подробнее» – откроются все «Загрузки». Обратите внимание на его функциональность. Присутствие активных кнопок «Открыть» и «Показать в папке» значительно упрощает работу со скачанными в сети файлами. По умолчанию все закачки через оперу попадают в папку «downloads» – это подсказывает и адресная строка основного окна «Загрузки». Загрузки в Google Chrome, в отличие от мазилы и оперы, находятся внизу и высвечиваются в процессе скачивания. Откройте загруженный файл, кликнув на него через всплывающую панель загрузок. По умолчанию файлы сохраняются в библиотеку «Документы» в папку «Downloads» – воспользуйтесь этой информацией, если панель пропала из поля зрения.У вас бывали ситуации, когда вы скачали программу, а потом не можете её найти в своём компьютере? Если да, то думаю, что вам пора разобраться с этим вопросом - изучив данный урок, вы забудете об этой проблеме раз и навсегда, т.к. будете знать куда скачиваются файлы.
Некоторые начинающие пользователи уверены, что после скачивания файл куда-то исчезает. Другие просто утверждают, что у них не получается скачать. На самом деле причина не в исчезновении или неумении, а в непонимании того, что перед скачиванием надо точно представлять, куда будет этот файл скачиваться.
Запомните - прежде чем запускать скачивание (загрузку, закачку) файла надо знать конкретное место на жестком диске, в которое будет помещен загружаемый файл. Именно поэтому, давайте сразу разберемся, куда деваются файлы, которые мы скачиваем.
Если во время загрузки файла не было никаких сбоев, наш антивирус не подавал никаких сигналов, и мы уверены, что загрузка закончилась то, скорее всего файл был нормально скачан, и наша задача его найти.
Чаще всего начинающие пользователи скачивают из Интернета с помощью браузера (наверняка у вас это Opera, Firefox, IE или Chrome). Более опытные пользователи для этого используют специальные программы . Но не все пользователи знают, что любой браузер (или программа) изначально настроен на скачивание файлов в определенное место.
Проверьте эти папки и вероятнее всего вы найдете там свои «потерянные» файлы.
Но надо отметить, что это очень неудобные места для хранения информации, так как они расположены в том же разделе где и операционная система (Windows). Если вдруг случится какой-то сбой в системе, и потребуется её переустановка, то все файлы в этих папках будут удалены.
Поэтому я предлагаю сделать следующее: создать отдельную папку для всех загрузок (в более надежном месте на жестком диске) и настроить браузер (или программу) на скачивание всех файлов в эту папку.
Если согласны, то давайте приступим…
Создавать папку можно в любом месте, но важно, чтобы это не был системный раздел (обычно это диск С). К примеру, можно создать папку в разделе D, назвав её «Загрузки из Интернета»:
Теперь давайте настроим наш браузер так, чтобы все закачки попадали именно в эту папку. Я покажу, как это сделать на примере всех основных браузеров.
Opera
Запускаем Opera и заходим в настройки браузера. Это можно сделать из меню (Инструменты - Общие настройки ) или просто нажав комбинацию клавиш Ctrl + F12 .
В появившемся окне переходим на вкладку Расширенные (1), затем выбираем пункт Загрузки (2), после чего с помощью кнопки Обзор… (3) находим и выбираем нашу папку (4):
После этого нажимаем кнопку Ok (5).
Настройка загрузок в браузере Firefox
Запускаем Firefox, в верхней части окна нажимаем кнопку Firefox и выбираем пункт Настройки (либо то же самое через меню Инструменты - Настройки ):
В открывшемся окне на вкладке Основные (1) с помощью кнопки Обзор… Ok (4):
Настройка загрузок в браузере Internet Explorer (версия 9)
Запускаем IE и нажимаем комбинацию клавиш Ctrl + J . В появившемся окне нажимаем пункт Параметры внизу окна:
А в следующем окне с помощью кнопки Обзор… (1) находим и выбираем нашу папку, после чего нажимаем кнопку Ok (2):
Настройка загрузок в браузере Chrome
Запускаем Chrome и нажимаем значок с ключиком в правом верхнем углу, а в выпавшем меню выбираем пункт Параметры :
В настройках браузера Chrome кнопки Ok нет, т.к. все настройки сохраняются без подтверждения, поэтому больше ничего нажимать не надо.
Как видите, ничего сложного нет!
Настройка загрузок в программе Download Master
Те же самые настройки можно сделать в любой программе для скачивания (менеджер закачек). К примеру, в программе Download Master это делается через пункт меню Инструменты - Настройки :
В открывшемся окне в левом списке выбираем пункт Закачки (1) и с помощью кнопки Изменить (2) находим и выбираем нашу папку (3), после чего нажимаем кнопку Ok (4):
Вот и все! Теперь вы не потеряете ни одного загруженного файла.
У вас бывали ситуации, когда вы скачали программу, а потом не можете её найти в своём компьютере? Если да, то думаю, что вам пора разобраться с этим вопросом - изучив данный урок, вы забудете об этой проблеме раз и навсегда, т.к. будете знать куда скачиваются файлы.
Некоторые начинающие пользователи уверены, что после скачивания файл куда-то исчезает. Другие просто утверждают, что у них не получается скачать. На самом деле причина не в исчезновении или неумении, а в непонимании того, что перед скачиванием надо точно представлять, куда будет этот файл скачиваться.
Запомните - прежде чем запускать скачивание (загрузку, закачку) файла надо знать конкретное место на жестком диске, в которое будет помещен загружаемый файл. Именно поэтому, давайте сразу разберемся, куда деваются файлы, которые мы скачиваем.
Если во время загрузки файла не было никаких сбоев, наш антивирус не подавал никаких сигналов, и мы уверены, что загрузка закончилась то, скорее всего файл был нормально скачан, и наша задача его найти.
Чаще всего начинающие пользователи скачивают из Интернета с помощью (наверняка у вас это Opera, Firefox, IE или Chrome). Более опытные пользователи для этого используют . Но не все пользователи знают, что любой браузер (или программа) изначально настроен на скачивание файлов в определенное место.
Проверьте эти папки и вероятнее всего вы найдете там свои «потерянные» файлы.
Но надо отметить, что это очень неудобные места для хранения информации, так как они расположены в том же разделе где и операционная система (Windows). Если вдруг случится какой-то сбой в системе, и потребуется её переустановка, то все файлы в этих папках будут удалены.
Поэтому я предлагаю сделать следующее: создать отдельную папку для всех загрузок (в более надежном месте на жестком диске) и настроить браузер (или программу) на скачивание всех файлов в эту папку.
Если согласны, то давайте приступим…
Создавать папку можно в любом месте, но важно, чтобы это не был системный раздел (обычно это диск С). К примеру, можно создать папку в разделе D, назвав её «Загрузки из Интернета»:
Теперь давайте настроим наш браузер так, чтобы все закачки попадали именно в эту папку. Я покажу, как это сделать на примере всех основных браузеров.
Opera
Запускаем Opera и заходим в настройки браузера. Это можно сделать из меню (Инструменты – Общие настройки ) или просто нажав комбинацию клавиш Ctrl + F12 .
В появившемся окне переходим на вкладку Расширенные (1), затем выбираем пункт Загрузки (2), после чего с помощью кнопки Обзор… (3) находим и выбираем нашу папку (4):
После этого нажимаем кнопку Ok (5).
Настройка загрузок в браузере Firefox
Запускаем Firefox, в верхней части окна нажимаем кнопку Firefox и выбираем пункт Настройки (либо то же самое через меню Инструменты – Настройки ):
В открывшемся окне на вкладке Основные (1) с помощью кнопки Обзор… Ok (4):
Настройка загрузок в браузере Internet Explorer (версия 9)
Запускаем IE и нажимаем комбинацию клавиш Ctrl + J . В появившемся окне нажимаем пункт Параметры внизу окна:
А в следующем окне с помощью кнопки Обзор… (1) находим и выбираем нашу папку, после чего нажимаем кнопку Ok (2):
Настройка загрузок в браузере Chrome
Запускаем Chrome и нажимаем значок с ключиком в правом верхнем углу, а в выпавшем меню выбираем пункт Параметры :
В настройках браузера Chrome кнопки Ok нет, т.к. все настройки сохраняются без подтверждения, поэтому больше ничего нажимать не надо.
Как видите, ничего сложного нет!
Настройка загрузок в программе Download Master
Те же самые настройки можно сделать в любой программе для скачивания (менеджер закачек). К примеру, в программе это делается через пункт меню Инструменты – Настройки :
В открывшемся окне в левом списке выбираем пункт Закачки (1) и с помощью кнопки Изменить (2) находим и выбираем нашу папку (3), после чего нажимаем кнопку Ok (4):