Amazon Mechanical Turk
API Reference (API Version 2012-03-25)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

Qualification

Description

The Qualification data structure represents a Qualification assigned to a user, including the Qualification type and the value (score).

The Qualification data structure is used as a response element for the following operations:

Elements

The Qualification structure can contain the elements described in the following table. When the structure is used in a request, elements described as Required must be included for the request to succeed.

NameDescriptionRequired

QualificationTypeId

The ID of the Qualification type for the Qualification

Type: String

Default: None

Yes

SubjectId

The ID of the Worker who possesses the Qualification.

Type: String

Default: None

Yes

GrantTime

The date and time the Qualification was granted to the Worker. If the Worker's Qualification was revoked, and then re-granted based on a new Qualification request, GrantTime is the date and time of the last call to the GrantQualification operation.

Type: a dateTime structure in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z

Default: None

Yes

IntegerValue

The value (score) of the Qualification, if the Qualification has an integer value.

Type: Integer

Default: None

No

LocaleValue

The value of the Qualification if the Qualification describes a geographical region or location.

Type: a Locale data structure.

Default: None

No

Status

The status of the Qualification

Type: String

Valid Values: Granted | Revoked

Default: None

Yes

Example

The following example illustrates a Qualification with an integer value.

<Qualification>
  <QualificationTypeId>789RVWYBAZW00EXAMPLE</QualificationTypeId>
  <SubjectId>AZ3456EXAMPLE</SubjectId>
  <GrantTime>2005-01-31T23:59:59Z</GrantTime>
  <IntegerValue>95</IntegerValue>
</Qualification>