Get all Qualifications of a particular QualificationType assigned to Workers.
GetQualifications(qual, status = NULL, return.all = TRUE,
pagenumber = 1, pagesize = 100,
verbose = getOption('MTurkR.verbose'), ...)
A character string containing a QualificationTypeId for a custom (i.e., not built-in) QualificationType.
An optional character string specifying whether only “Granted” or “Revoked” Qualifications should be returned.
A logical indicating whether all Qualifications (as opposed to a specified page of the search results) should be returned. Default is TRUE
.
An optional character string indicating which page of search results should be returned. Most users can ignore this.
An optional character string indicating how many search results should be returned by each request, between 1 and 100. Most users can ignore this.
Optionally print the results of the API request to the standard output. Default is taken from getOption('MturkR.verbose')
.
Additional arguments passed to request
.
A dataframe containing the QualificationTypeId, WorkerId, and Qualification scores of workers assigned the Qualification.
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 recieve 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.
# NOT RUN {
GetQualifications("2YCIA0RYNJ9262B1D82MPTUEXAMPLE")
GetQualifications("2YCIA0RYNJ9262B1D82MPTUEXAMPLE",status="Revoked")
# }
Run the code above in your browser using DataLab