Toloka documentation

get_attachments

toloka.client.TolokaClient.get_attachments | Source code

Finds all attachments that match certain criteria and returns their metadata.

get_attachments returns a generator. You can iterate over all found attachments using the generator. Several requests to the Toloka server are possible while iterating.

If you need to sort attachments use the find_attachments method.

Parameters Description

Parameters Type Description
name Optional[str]

An attachment file name.

type Optional[Attachment.Type]

An attachment type. Refer to the Attachment.Type page for more information on the available type values.

user_id Optional[str]

The ID of a Toloker who uploaded attachments.

assignment_id Optional[str]

The ID of an assignment with attachments. Either assignment_id of pool_id is required in a search request.

pool_id Optional[str]

The ID of a pool with attachments. Either assignment_id of pool_id is required in a search request.

id_lt Optional[str]

Attachments with IDs less than the specified value.

id_lte Optional[str]

Attachments with IDs less than or equal to the specified value.

id_gt Optional[str]

Attachments with IDs greater than the specified value.

id_gte Optional[str]

Attachments with IDs greater than or equal to the specified value.

created_lt Optional[datetime]

Attachments uploaded by Tolokers before the specified date.

created_lte Optional[datetime]

Attachments uploaded by Tolokers before or on the specified date.

created_gt Optional[datetime]

Attachments uploaded by Tolokers after the specified date.

created_gte Optional[datetime]

Attachments uploaded by Tolokers after or on the specified date.

  • Yields:

    The next matching attachment.

  • Yield type:

    Generator[Attachment, None, None]

Examples:

Make a list of all received attachments in the specified pool.

results_list = list(toloka_client.get_attachments(pool_id='1'))