Learn R Programming

MTurkR (version 0.2)

UpdateQualificationType: Update a Worker QualificationType

Description

Update characteristics of a QualificationType.

Usage

UpdateQualificationType(qual, description = NULL, status = NULL, 
						retry.delay = NULL, test = NULL, answerkey = NULL, 
						test.duration = NULL, auto = NULL, auto.value = NULL, 
						keypair = credentials(), print = TRUE, browser = FALSE, 
						log.requests = TRUE, sandbox = FALSE)

Arguments

qual
A character string containing a QualificationTypeId.
description
A character string describing the Qualification. This is visible to workers. Maximum of 2000 characters.
status
A character vector of Active or Inactive, indicating whether the QualificationType should be active and visible.
retry.delay
An optional time (in seconds) indicating how long workers have to wait before requesting the QualificationType after an initial rejection.
test
An optional character string consisting of a QuestionForm data structure, used as a test a worker must complete before the QualificationType is granted to them.
answerkey
An optional character string consisting of an AnswerKey data structure, used to automatically score the test.
test.duration
An optional time (in seconds) indicating how long workers have to complete the test.
auto
A logical indicating whether the Qualification is automatically granted to workers who request it. Default is FALSE.
auto.value
An optional parameter specifying the value that is automatically assigned to workers when they request it (if the Qualification is automatically granted).
keypair
A two-item character vector containing an AWS Access Key ID in the first position and the corresponding Secret Access Key in the second position. Set default with credentials.
print
Optionally print the results of the API request to the standard output. Default is TRUE.
browser
Optionally open the request in the default web browser, rather than opening in R. Default is FALSE.
log.requests
A logical specifying whether API requests should be logged. Default is TRUE. See readlogfile for details.
sandbox
Optionally execute the request in the MTurk sandbox rather than the live server. Default is FALSE.

Value

  • A dataframe containing the QualificationTypeId of the newly created QualificationType and other details as specified in the request.

Details

A function to update the characteristics of a QualificationType. Name and keywords cannot be modified after a QualificationType is created. updatequal() is an alias.

References

http://docs.amazonwebservices.com/AWSMechTurk/latest/AWSMturkAPI/ApiReference_UpdateQualificationTypeOperation.html{API Reference}

See Also

GetQualificationType CreateQualificationType DisposeQualificationType SearchQualificationTypes

Examples

Run this code
qual1 <- CreateQualificationType(title="Worked for me before",description="This qualification is for people who have worked for me before",keywords="Worked for me before",sandbox=TRUE)
qual2 <- UpdateQualificationType(qual.test,description="This qualification is for everybody!",auto=TRUE,auto.value="5",sandbox=TRUE)

Run the code above in your browser using DataLab