MTurkR (version 0.8.0)

GetQualificationScore: Get a Worker's Qualification Score

Description

Get a Worker's score for a specific Qualification. You can only retrieve scores for custom QualificationTypes. Scores for built-in QualificationTypes should be retrieved with GetWorkerStatistic.

Usage

GetQualificationScore(qual, workers, verbose = getOption('MTurkR.verbose', TRUE), ...)

Arguments

qual

A character string containing a QualificationTypeId for a custom QualificationType.

workers

A character string containing a WorkerId, or a vector of character strings containing multiple WorkerIds, whose Qualification Scores you want to retrieve.

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, time the qualification was granted, the Qualification score, a column indicating the status of the qualification, and a column indicating whether the API request was valid.

Details

A function to retrieve one or more scores for a specified QualificationType. To retrieve all Qualifications of a given QualificationType, use GetQualifications instead. Both qual and workers can be vectors. If qual is not length 1 or the same length as workers, an error will occur.

qualscore() is an alias.

References

API Reference

See Also

UpdateQualificationScore

GetQualifications

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")

GetQualificationScore(qual1$QualificationTypeId, qual1$WorkerId)

# cleanup
DisposeQualificationType(qual1$QualificationTypeId)
# }