MTurkR (version 0.5)

GetHITsForQualificationType: Get HITs by Qualification

Description

Retrieve HITs according to the QualificationTypes that are required to complete those HITs.

Usage

GetHITsForQualificationType(qual, response.group = NULL, return.all = TRUE, 
                            pagenumber = 1, pagesize = 100, 
                            verbose = getOption('MTurkR.verbose'), ...)

Arguments

qual

A character string containing a QualificationTypeId.

response.group

An optional character string specifying what details of each HIT to return of: “Minimal”, “Request”. For more information, see http://docs.amazonwebservices.com/AWSMechTurk/latest/AWSMturkAPI/ApiReference_HITDataStructureArticle.html.

return.all

A logical indicating whether all QualificationTypes (as opposed to a specified page of the search results) should be returned. Default is TRUE.

pagenumber

An optional character string indicating which page of search results should be returned. Most users can ignore this.

pagesize

An optional character string indicating how many search results should be returned by each request, between 1 and 100. Most users can ignore this.

verbose

Optionally print the results of the API request to the standard output. Default is taken from getOption('MturkR.verbose').

...

Additional arguments passed to request.

Value

A data frame containing the HITId and other requested characteristics of the qualifying HITs.

Details

A function to retrieve HITs that require the specified QualificationType.

gethitsbyqual() is an alias.

References

API Reference

See Also

GetHIT

SearchHITs

Examples

# NOT RUN {
q <- ListQualificationTypes()[7,2] # Location requirement
GetHITsForQualificationType(q)
# }