Learn R Programming

MTurkR (version 0.2)

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, 
					keypair = credentials(), print = TRUE, 
					log.requests = TRUE, sandbox = FALSE, return.qual.dataframe = 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.
keypair
A two-item character vector containing an AWS Access Key ID in the first position and the corresponding Secret Access Key in the second position. Set default with credentials.
print
Optionally print the results of the API request to the standard output. Default is TRUE.
log.requests
A logical specifying whether API requests should be logged. Default is TRUE. See readlogfile for details.
sandbox
Optionally execute the request in the MTurk sandbox rather than the live server. Default is FALSE.
return.qual.dataframe
A logical specifying whether the Qualification dataframe should be returned. Default is TRUE.

Value

  • A dataframe 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. getquals() is an alias.

References

http://docs.amazonwebservices.com/AWSMechTurk/latest/AWSMturkAPI/ApiReference_GetQualificationsForQualificationTypeOperation.html{API Reference}

See Also

GetQualificationScore UpdateQualificationScore

Examples

Run this code
GetQualifications("2YCIA0RYNJ9262B1D82MPTUEXAMPLE")
GetQualifications("2YCIA0RYNJ9262B1D82MPTUEXAMPLE",status="Revoked")

Run the code above in your browser using DataLab