MTurkR (version 0.6)

RejectQualification: Reject a Worker's Qualification Request

Description

Reject a Worker's request for a Qualification.

Usage

RejectQualification(qual.request, reason = NULL, 
                    verbose = getOption('MTurkR.verbose', TRUE), ...)

Arguments

qual.request

A character string containing a QualificationRequestId, or a vector of character strings containing multiple QualificationRequestIds (e.g., as returned by GetQualificationRequests).

reason

An optional character string, or vector of character strings of length equal to length of the qual.requests parameter, supplying each worker with a reason for rejecting their request for the Qualification. Workers will see this message. Maximum of 1024 characters.

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, reason for rejection (if applicable), 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 rejects specified qualification requests.

Note that rejecting a qualification is not the same as revoking a worker's Qualification. For example, if a worker already has a score of 100 on a given QualificationType and then requests the same QualificationType, a RejectQualification leaves the worker's existing Qualification in place. Use RevokeQualification to entirely remove a worker's Qualification.

RejectQualifications() and rejectrequest() are aliases.

References

API Reference

See Also

GetQualificationRequests

GrantQualification

Examples

# NOT RUN {
RejectQualification("2YCIA0RYNJ9262B1D82MPTUEXAMPLE",
                    reason="I am not currently granting this QualificationType.")
# }