pyMTurkR (version 1.1)

RevokeQualification: Revoke a Qualification from a Worker

Description

Revoke a Qualification from a worker or multiple workers. This deletes their qualification score and any record thereof.

Usage

RevokeQualification(qual, workers, reasons = NULL,
  verbose = getOption("pyMTurkR.verbose", TRUE))

Arguments

qual

A character string containing a QualificationTypeId.

workers

A character string containing a WorkerId, or a vector of character strings containing multiple WorkerIds.

reasons

An optional character string, or vector of character strings of length equal to length of the workers parameter, supplying each worker with a reason for revoking their Qualification. Workers will see this message.

verbose

Optionally print the results of the API request to the standard output. Default is taken from getOption('pyMTurkR.verbose', TRUE).

Value

A data frame containing the QualificationTypeId, WorkerId, reason (if applicable), and whether each request was valid.

Details

A simple function to revoke a Qualification assigned to one or more workers.

RevokeQualifications(), revokequal() and DisassociateQualificationFromWorker() are aliases.

References

API Reference

See Also

GrantQualification

RejectQualification

Examples

# NOT RUN {
# }
# NOT RUN {
qual1 <-
AssignQualification(workers = "A1RO9UJNWXMU65",
                    name = "Worked for me before",
                    description = "This qualification is for people who have worked for me before",
                    status = "Active",
                    keywords = "Worked for me before")

RevokeQualification(qual = qual1$QualificationTypeId,
                    worker = qual1$WorkerId,
                    reason = "No longer needed")

DisposeQualificationType(qual1$QualificationTypeId)

# }
# NOT RUN {
# }