GetQualificationScore: Get a Worker's Qualification Score

In pyMTurkR: A Client for the 'MTurk' Requester API

Get a Worker's Qualification Score

Description

Get a Worker's score for a specific Qualification. You can only retrieve scores for custom QualificationTypes.

Usage

GetQualificationScore(
  qual,
  workers,
  verbose = getOption("pyMTurkR.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('pyMTurkR.verbose', TRUE).

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.

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.

Author(s)

Tyler Burleigh, Thomas J. Leeper

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)

## End(Not run)

pyMTurkR documentation built on May 29, 2024, 6:13 a.m.