RevokeQualification: Revoke a Qualification from a Worker

Description Usage Arguments Details Value Author(s) References See Also Examples

Description

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

Usage

1
2
RevokeQualification(qual, worker, reason = NULL, 
                    verbose = getOption('MTurkR.verbose', TRUE), ...)

Arguments

qual

A character string containing a QualificationTypeId.

worker

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

reason

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('MTurkR.verbose', TRUE).

...

Additional arguments passed to request.

Details

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

RevokeQualifications() and revokequal() are aliases.

Value

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

Author(s)

Thomas J. Leeper

References

API Reference

See Also

GrantQualification

RejectQualification

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
## 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)


## End(Not run)


Search within the MTurkR package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? or email at ian@mutexlabs.com.

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.