Description Usage Arguments Details Value Author(s) References See Also Examples
Grant or reject a worker's request for a Qualification.
1 2 3 4 5 | GrantQualification(qual.requests, values,
verbose = getOption('MTurkR.verbose', TRUE), ...)
RejectQualification(qual.requests, reason = NULL,
verbose = getOption('MTurkR.verbose', TRUE), ...)
|
qual.requests |
A character string containing a QualificationRequestId (for example, returned by |
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. |
reason |
An optional character string, or vector of character strings of length equal to length of the |
verbose |
Optionally print the results of the API request to the standard output. Default is taken from |
... |
Additional arguments passed to |
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
. GrantQualification
grants the 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.
Similarly, 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.
GrantQualifications()
and grantqual()
are aliases; RejectQualifications()
and rejectrequest()
are aliases.
A data frame containing the QualificationRequestId, reason for rejection (if applicable; only for RejectQualification
), and whether each request was valid.
Thomas J. Leeper
API Reference: GrantQualification
API Reference: RejectQualification
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | ## Not run:
# create QualificationType
qual1 <- CreateQualificationType(name="Requestable Qualification",
description="This is a test qualification that can be requested.",
status = "Active")
# poll for qualification requests
qrs <- GetQualificationRequests(qual1$QualificationTypeId)
# grant a qualification request
GrantQualification(qrs$QualificationRequestId[1], values = "100")
# correct a worker's score (note use of `SubjectId`, not `WorkerId`)
UpdateQualificationScore(qrs$QualificationTypeId[1], qrs$SubjectId[1], value = "95")
# reject a qualification request
RejectQualification(qrs$QualificationTypeId[2], reason = "Sorry!")
# cleanup
DisposeQualificationType(qual1$QualificationTypeId)
## End(Not run)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.