You are browsing the documentation for a deprecated version ('2014-08-15') of the Amazon Mechanical Turk Requester API. This version of the API will be deprecated and will be rendered unusable as of June 1st, 2019. If you request against a legacy API version (https://docs.aws.amazon.com/AWSMechTurk/latest/AWSMturkAPI-legacy/Welcome.html) on or after June 1, 2019, you will receive the following response:
The latest version of our API ('2017-01-17') provides you with additional tool choices and enables you to select from nine AWS Software Development Kits This version also updates naming conventions used in the API and adopts the AWS standard of Signature Version 4 to authenticate requests securely. The API uses REST requests and no longer requires that developers be familiar with SOAP protocol. These changes make the MTurk API consistent with AWS APIs, simplifying the on-boarding process for both new and existing AWS developers. The legacy MTurk Command Line Tools and .NET, Java, Ruby, and Perl SDKs were marked as deprecated in January 2018. We will be deprecating the legacy APIs as of June 1, 2019. If you are on a legacy API, you must migrate to the latest
version of our API. You can find documentation for the latest API here and the AWS SDKs here For support, contact requestor-apilegacydeprecation-support@amazon.com |
QualificationType
Description
The QualificationType data structure represents a Qualification type, a description of a property of a Worker that must match the requirements of a HIT for the Worker to be able to accept the HIT. The type also describes how a Worker can obtain a Qualification of that type, such as through a Qualification test.
The QualificationType data structure is used as a response element for the following operations:
Elements
The QualificationType structure can contain the elements described in the following table:
Name | Description | Required |
---|---|---|
|
A unique identifier for the Qualification type. A Qualification type is given a Qualification type ID when you call the CreateQualificationType operation operation, and it retains that ID forever. Type: String Default: None |
No |
|
The date and time the Qualification type was created Type: a dateTime Default: None |
No |
|
The name of the Qualification type. The type name is used to identify the type, and to find the type using a Qualification type search. Type: String Default: None |
No |
|
A long description for the Qualification type. Type: String Default: None |
No |
|
One or more words or phrases that describe theQualification type, separated by commas. The Keywords make the type easier to find using a search. Type: String Default: None |
No |
|
The status of the Qualification type. A Qualification type's status determines if users can apply to receive a Qualification of this type, and if HITs can be created with requirements based on this type. Type: String Valid Values: Active | Inactive Default: None |
No |
|
The amount of time, in seconds, Workers must wait after taking the Qualification test before they can take it again. Workers can take a Qualification test multiple times if they were not granted the Qualification from a previous attempt, or if the test offers a gradient score and they want a better score. Type: positive integer Default: None. If not specified, retries are disabled and Workers can request a Qualification only once. |
No |
|
The questions for a Qualification test associated with this Qualification type that a user can take to obtain a Qualification of this type. Type: a QuestionForm data structure. NoteA Qualification test cannot use an ExternalQuestionQuestionForm like a HIT can. Default: None Constraints: must be specified if |
No |
|
The amount of time, in seconds, given to a Worker to complete the Qualification test, beginning from the time the Worker requests the Qualification. Type: positive integer Default: None |
No |
|
The answers to the Qualification test specified in the
Type: an AnswerKey data structure. Default: None. If not provided with a test, the Qualification author must process the Qualification request manually. |
No |
|
Specifies that requests for the Qualification type are granted immediately, without prompting the Worker with a Qualification test. Type: Boolean Valid Values: true | false Default: None Constraints: A Qualification type cannot have both a specified
|
No |
|
The Qualification value to use for automatically granted Qualifications,
if Type: Integer Default: 1 |
No |
|
Specifies whether the Qualification type is one that a user can request
through the Amazon Mechanical Turk web site, such as by taking a Qualification
test. This value is Type: Boolean Valid Values: true | false Default: None |
No |
Example
The following example shows a QualificationType data structure returned by a call to the GetQualificationType operation.
The GetQualificationType
operation returns a GetQualificationTypeResult
element, which contains a
QualificationType
element.
<QualificationType> <QualificationTypeId>789RVWYBAZW00EXAMPLE</QualificationTypeId> <CreationTime>2005-01-31T23:59:59Z</CreationTime> <Name>EnglishWritingAbility</Name> <Description>The ability to write and edit text...</Description> <Keywords>English, text, write, edit, language</Keywords> <QualificationTypeStatus>Active</QualificationTypeStatus> <RetryDelayInSeconds>86400</RetryDelayInSeconds> <IsRequestable>true</IsRequestable> </QualificationType>