RevokeQualification: Revoke a Qualification from a Worker

In pyMTurkR: A Client for the 'MTurk' Requester API

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).

Details

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

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

Value

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

Author(s)

Tyler Burleigh, Thomas J. Leeper

References

API Reference

See Also

GrantQualification

RejectQualification

Examples

## 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)

pyMTurkR documentation built on Nov. 25, 2021, 9:07 a.m.