Files on Yandex.Disk

If your tasks require images or other files, put them on Yandex.Disk . You can use only Yandex.Disk linked to the same account you are using in Toloka.

To use files on Yandex.Disk in tasks:
  1. Connect Yandex.Disk.
  2. Add links to files in the task.

Connecting to Yandex.Disk

To use Yandex.Disk as a data source:

  1. Click Add Ya.Disk on the profile page (the External Services Integration tab) and allow Toloka access to Yandex.Disk.

  2. Click Add proxy and fill in the fields:

    Field

    Description

    Unique name

    Name of the data source. The name will be inserted in the file URLs. Allowed characters: Latin letters, numbers, dashes (“-”).

    Type

    Choose “Yandex.Disk”.

    Permissions

    Level of access to files:

    • “Public” — All Toloka performers (appropriate for files with instructions).

    • “Private” — Only performers who received a task with this file (appropriate for task content).

    Folder name

    The name of the folder on Yandex.Disk. A folder with this name will be created on Yandex.Disk automatically (Applications/Yandex.Toloka/<folder name>). Slashes are not allowed (“/”) in the folder name.

    Field

    Description

    Unique name

    Name of the data source. The name will be inserted in the file URLs. Allowed characters: Latin letters, numbers, dashes (“-”).

    Type

    Choose “Yandex.Disk”.

    Permissions

    Level of access to files:

    • “Public” — All Toloka performers (appropriate for files with instructions).

    • “Private” — Only performers who received a task with this file (appropriate for task content).

    Folder name

    The name of the folder on Yandex.Disk. A folder with this name will be created on Yandex.Disk automatically (Applications/Yandex.Toloka/<folder name>). Slashes are not allowed (“/”) in the folder name.

  3. Click Save.

The folder Applications/Yandex.Toloka/<folder name> will be created on Yandex.Disk. Upload images or other files for tasks to it.

Adding files from Yandex.Disk

Upload files for your tasks to Yandex.Disk and add them to the project:

Project instructions

To add an image to the project instructions, provide a link in the format /api/proxy/<unique name>/<file name>. For example, /api/proxy/pics/image1.jpg.

Task interface

To add a file, such as an image or an audio, in the the task interface:

  1. Set the string data type for the input data field in which you will pass the file link.

  2. Use HTML tags:
    • <img> to insert an image.
    • <audio> to insert an audio recording in the player.
    • <video> to insert a video recording in the player.
    In the src attribute, specify the proxy Handlebars component and the input data field ID. For example: <img src={{proxy image}} width="400">, <audio src={{proxy audio}} controls>.

  3. Include relative links to Yandex.Disk files in the TSV file with tasks. For example, pics/image1.jpg.

Editor for image area selection

To add an image to image area selection editor:

  1. Set the string data type for the input data field in which you will pass the file link.

  2. In the src attribute, specify the proxy Handlebars component and the input data field ID. For example: {{field type="image-annotation" name="result" src=(proxy image)}}

  3. Include relative links to Yandex.Disk files in the TSV file with tasks. For example, pics/image1.jpg.