Документация Толоки

Яндекс Диск

Обратите внимание

Документация на русском языке может быть устаревшей. Самые последние изменения доступны в документации на английском языке.

Примечание

Если вы хотите разместить небольшое количество картинок, вы можете воспользоваться любым фотохостингом, например: imgbb или ImageShack. Так вы сможете быстро получить прямые ссылки на ваши картинки, которые можно добавить в файл с заданиями или в инструкцию.

Если для ваших заданий нужны картинки или другие файлы, разместите их на Яндекс Диске. Вы можете использовать файлы только с Яндекс Диска того же аккаунта, с которым вы работаете в Толоке.

Чтобы использовать файлы с Яндекс Диска в заданиях:

  1. Подключите Яндекс Диск.

  2. Добавьте ссылки на файлы в интерфейс задания.

  3. Добавьте ссылки на файлы в инструкцию.

Подключить Яндекс Диск

Чтобы использовать Яндекс Диск в качестве источника данных:

  1. Нажмите кнопку Подключить Яндекс Диск на вкладке Интеграция на странице профиля и разрешите Толоке доступ к Яндекс Диску.

  2. Нажмите кнопку Добавить прокси и заполните поля:

    Поле

    Описание

    Уникальное имя

    Название источника данных. Будет включено в URL-путь к файлам. Допустимые символы в названии: латинские буквы, цифры, дефис «-».

    Должно быть уникально в рамках Толоки.

    Тип

    Выберите «Яндекс Диск».

    Права доступа

    Уровень доступа к файлам:

    • «Публичный» — всем исполнителям Толоки (подходит для файлов инструкций).

    • «Приватный» — только исполнителям, которые получили задание с данным файлом (подходит для контента заданий).

    Название папки

    Название папки на Яндекс Диске. в названии папки нельзя использовать слеш («/»).

    Папка с этим названием будет создана на Яндекс Диске автоматически: Приложения/Toloka/<имя папки>).

  3. Нажмите Сохранить.

  4. Загрузите файлы для заданий или инструкций в созданную папку на Яндекс Диске. Она будет находиться по адресу Приложения/Toloka/<имя папки> (имя вы указали в поле ).

Добавить файлы в интерфейс задания

Чтобы добавить файл в интерфейс задания:

  1. Выберите тип компонента. Например, "view.image" — для вставки картинки, "view.audio" — аудио, "view.video" — видео.

  2. В свойстве "url" компонента выберите тип "@yandex-toloka/helper.proxy".

  3. В свойстве "path" компонента укажите конструкцию вида /<имя прокси>/<имя файла>.<тип> со своими данными.

Посмотреть пример с классификацией изображений

Совет

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

Пример добавления файлов с Яндекс Диска в конструкторе шаблонов:

{
"type": "view.image",
"url": {
  "type": "@yandex-toloka/helper.proxy",
  "path": "/my-proxy/example.jpg"
  }
}

Вы также можете вынести ссылки на файлы вида /<имя прокси>/<имя файла>.<тип> во входные данные и сослаться на них в конфигурации.

Одно изображение
{
"type": "view.image",
"url": {
  "type": "@yandex-toloka/helper.proxy",
  "path": {
    "type": "data.input",
    "path": "image"
    }
  }
}

Посмотреть пример в песочнице

Несколько изображений

Совет

Не забывайте, что элементы массива начинаются с нуля.

{
"type": "view.image",
"url": {
  "type": "@yandex-toloka/helper.proxy",
  "path": {
    "type": "data.input",
    "path": "images.0"
    }
  }
}

Посмотреть пример в песочнице

  1. Укажите тип данных строка для поля входных данных, в котором вы будете передавать ссылку на файл.

  2. Вставьте файл. Обратите внимание на формат, в котором указывается имя поля: proxy <поле со ссылкой на файл>

    Картинка

    Добавьте картинку в блоке HTML одним из способов:

    • С помощью компонента Картинка: {{img src=(proxy image)}}.

    • С помощью HTML-тега: <img src="{{proxy image}}">.

    Аудио или видео

    Добавьте HTML-тег:

    • для вставки аудиозаписи в плеере: <audio src="{{proxy audio}}" controls>;

    • для вставки видеозаписи в плеере: <video src="{{proxy video}}" controls>.

    Редактор для выделения области на картинке

    Добавьте компонент{{field type="image-annotation" name="result" src=(proxy image)}}.

  3. Приведите относительные ссылки на файлы Яндекс Диска в  вида /<имя прокси>/<имя папки>/<имя файла>.<тип>. Например, /my-proxy/example.jpg или с названием папки — /my-proxy/photos/example.jpg.

    Примечание

    Обратите внимание, что название папки нужно не всегда. Иногда достаточно имени прокси и названия файла через "/".

Добавить файлы в инструкцию

Внимание

Тип прав доступа на папку с файлами для инструкций нужно установить «Публичный».

Чтобы добавить картинку в инструкцию проекта:

  1. Загрузите файлы в папку Приложения/Толока/<имя папки> через [веб-интерфейс]({{ yadisk-client }) или с помощью приложения [Яндекс Диск]({{ yadisk-app }).

  2. Выберите способ добавления файла в инструкцию.

    1. В поле Инструкция для исполнителей на панели инструментов нажмите значок .

    2. Вставьте конструкцию вида /api/proxy/<имя прокси>/<имя файла>.<тип> в появившееся поле. Например: /api/proxy/my-proxy/example.jpg.

    3. Нажмите клавишу Enter.

    1. На панели инструментов нажмите значок .

    2. Добавьте HTML-тег <img src="/api/proxy/<имя прокси>/<имя файла>.<тип>"> в поле ввода. Например: <img src="/api/proxy/my-proxy/example.jpg">.

Решение проблем

Не загружаются файлы с Яндекс Диска

Если картинки, аудио или видео с Яндекс Диска не отображаются в инструкции или на странице задания, убедитесь, что вы правильно подключили Диск и загрузили файлы.

Как сделать задание, в котором исполнитель должен просматривать видео с Яндекс Диска?

Для создания задания возьмите за основу шаблон для разметки видео.

Чтобы разместить ваши видеоролики на Яндекс Диске, его нужно подключить и настроить проект.

Подробная видеоинструкция об этом в нашем блоге.

Почему в задании по выделению объектов на изображении не отображаются изображения с Яндекс Диска?

Проблема в шаблоне задания. Проверьте, что:

  • Для поля входных данных, куда вы передаете ссылку на файл, в проекте указан тип «строка».

  • В компоненте в шаблоне задания используется выражение proxy.

  • Формат относительных ссылок в файле с заданиями указан верно: <уникальное имя>/<путь и имя файла>.

Подробная инструкцию и видео на странице Использование файлов с Яндекс Диска.

Частые ошибки при подключении Диска и загрузке файлов
  • В настройках проекта в поле Входные данные указан тип ссылка. Необходимо выбрать тип строка.

  • В файле с заданиями указаны абсолютные ссылки на файлы для заданий. Необходимо вставить ссылку вида <уникальное имя>/<путь и имя файла>. Например: yadisk/image1.jpg или yadisk/photos/image1.png.

  • Фото с Яндекс Диска используются в инструкции к заданию в мобильном приложении. Чтобы фото отобразилось в инструкции, используйте только прямые ссылки.

  • Файлы удалены или находятся не в той папке на Диске, на которую ведет ссылка.

  • OAuth-токен не активен. Обновите токен на странице Интеграция.

Чтобы файлы, загруженные на Яндекс Диск (картинки, аудио, видео), отображались у исполнителя, нужно:

  1. Подключить Яндекс Диск в профиле.

  2. Установить тип строка для поля входных данных.

  3. Вставлять ссылку на файл при помощи компонента proxy.

Подробная инструкция

Как сделать задание, в котором исполнитель должен просматривать видео с Яндекс Диска?

Для создания задания возьмите за основу шаблон для разметки видео.

Чтобы разместить ваши видеоролики на Яндекс Диске, его нужно подключить и настроить проект.

Подробная видеоинструкция об этом в нашем блоге.

Почему в задании по выделению объектов на изображении не отображаются изображения с Яндекс Диска?

Проблема в шаблоне задания. Проверьте, что:

  • Для поля входных данных, куда вы передаете ссылку на файл, в проекте указан тип «строка».

  • В компоненте в шаблоне задания используется выражение proxy.

  • Формат относительных ссылок в файле с заданиями указан верно: <уникальное имя>/<путь и имя файла>.

Подробная инструкцию и видео на странице Использование файлов с Яндекс Диска.

Файлы на Яндекс Диск загружаются слишком медленно. Как ускорить загрузку?

Попробуйте воспользоваться рекомендациями с этой страницы или написать в службу поддержки Яндекс Диска.

Как в инструкцию встроить несколько картинок с Яндекс Диска?

Чтобы добавить картинки с помощью ссылок на Яндекс Диск, используйте ссылку вида /api/proxy/<имя прокси>/<имя файла>.<тип>. Например: /api/proxy/my-proxy/example.jpg

Подробнее об этом читайте в разделе Добавить файлы в инструкцию.

Почему в предпросмотре заданий не отображаются изображения с Яндекс Диска?

Проблема в шаблоне задания. Проверьте, что:

  • Для поля входных данных, куда вы передаете ссылку на файл, в проекте указан тип «строка».

  • В компоненте в шаблоне задания используется выражение proxy.

  • Формат относительных ссылок в файле с заданиями указан верно: <уникальное имя>/<путь и имя файла>.

Подробная инструкция и видео.

Как в задание добавить видео, которое размещено на Яндекс Диске?

Можно взять за основу шаблон для разметки видео.

Чтобы разместить ваши видеоролики на Яндекс Диске, его нужно подключить и настроить проект.

Подробная видеоинструкция есть в нашем блоге.

Если эти рекомендации не помогли: