MTurkR (version 0.8.0)

GetQualifications: Get Qualifications

Description

Get all Qualifications of a particular QualificationType assigned to Workers.

Usage

GetQualifications(qual, status = NULL, return.all = TRUE, 
                  pagenumber = 1, pagesize = 100,
                  verbose = getOption('MTurkR.verbose', TRUE), ...)

Arguments

qual

A character string containing a QualificationTypeId for a custom (i.e., not built-in) QualificationType.

status

An optional character string specifying whether only “Granted” or “Revoked” Qualifications should be returned.

return.all

A logical indicating whether all Qualifications (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', TRUE).

...

Additional arguments passed to request.

Value

A data frame containing the QualificationTypeId, WorkerId, and Qualification scores of workers assigned the Qualification.

Details

A function to retrieve Qualifications granted for the specified QualificationType. To retrieve a specific Qualification score (e.g., for one worker), use GetQualificationScore.

A practical use for this is with automatically granted QualificationTypes. After workers request and receive an automatically granted Qualification that is tied to one or more HITs, GetQualifications can be used to retrieve the WorkerId's for workers that are actively working on those HITs (even before they have submitted an assignment).

getquals() is an alias.

References

API Reference

See Also

GetQualificationScore

UpdateQualificationScore

Examples

# NOT RUN {
qual1 <- 
AssignQualification(workers = "A1RO9UJNWXMU65",
                    name = "Worked for me before",
                    description = "This qualification is for people who have worked for me before",
                    status = "Active",
                    keywords = "Worked for me before")

GetQualifications(qual1$QualificationTypeId)
RevokeQualification(qual1$QualificationTypeId, qual1$WorkerId)
GetQualifications(qual1$QualificationTypeId, status="Revoked")

DisposeQualificationType(qual1$QualificationTypeId)
# }