Learn R Programming

MTurkR (version 0.6)

GrantQualification: Grant Qualification Request

Description

Grant a Worker's request for a Qualification.

Usage

GrantQualification(qual.requests, values, 
                   verbose = getOption('MTurkR.verbose', TRUE), ...)

Arguments

qual.requests

A character string containing a QualificationRequestId (for example, returned by GetQualificationRequests), or a vector of QualificationRequestIds.

values

A character string containing the value of the Qualification to be assigned to the worker, or a vector of values of length equal to the number of QualificationRequests.

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 dataframe containing the QualificationRequestId and whether each request was valid.

Details

Qualifications are publicly visible to workers on the MTurk website and workers can request Qualifications (e.g., when a HIT requires a QualificationType that they have not been assigned). QualificationRequests can be retrieved via GetQualificationRequests. This function grants specified qualification requests. Requests can be rejected with RejectQualifications.

Note that granting a qualification may have the consequence of modifying a worker's existing qualification score. For example, if a worker already has a score of 100 on a given QualificationType and then requests the same QualificationType, a GrantQualification action might increase or decrease that worker's qualification score.

GrantQualifications() and grantqual() are aliases.

References

API Reference

See Also

GetQualificationRequests

RejectQualification

Examples

Run this code
# NOT RUN {
GrantQualification("2YCIA0RYNJ9262B1D82MPTUEXAMPLE","100")
# }

Run the code above in your browser using DataLab