AssignQualification

Prev		Next

Description

The AssignQualification operation gives a Worker a Qualification. AssignQualification does not require that the Worker submit a Qualification request: It gives the Qualification directly to the Worker.

You can assign a Qualification to any Worker that has submitted one of your HITs in the past.

You can only assign a Qualification of a Qualification type that you created (using the CreateQualificationType operation).

Tip:

AssignQualification does not affect any pending Qualification requests for the Qualification by the Worker. If you assign a Qualification to a Worker, then later grant a Qualification request made by the Worker, the granting of the request may modify the Qualification score. To resolve a pending Qualification request without affecting the Qualification the Worker already has, reject the request with the RejectQualificationRequest operation.

Sample Request: Using AssignQualification (REST)

The following example of a call to the AssignQualification operation assigns a Qualification of the given type to a Worker with the given ID, using the given Qualification value. By default, the Worker will be sent an e-mail message saying that they have received the Qualification.

http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2006-10-31
&Operation=AssignQualification
&Signature=[signature for this request]
&Timestamp=[your system's local time]
&QualificationTypeId=789RVWYBAZW00EXAMPLE
&WorkerId=AZ3456EXAMPLE
&IntegerValue=800

Request Parameters

A request to the Mechanical Turk Service includes parameters that control its behavior and the data it returns. Required parameters must be included for the request to succeed.

AssignQualification accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.

The following parameters are specific to the AssignQualification operation:

Name	Description	Type	Value
`Operation`	The operation you would like to call. To access the `AssignQualification` operation, set the `Operation` parameter to `AssignQualification`.	Required	`AssignQualification`
`QualificationTypeId`	The ID of the Qualification type to use for the assigned Qualification.	Required	A valid Qualification type ID, as returned by the CreateQualificationType operation
`WorkerId`	The ID of the Worker to whom the Qualification is being assigned. Worker IDs are included with submitted HIT assignments and Qualification requests.	Required	A valid Worker ID
`IntegerValue`	The value of the Qualification to assign. If omitted, the default value is "1".	Optional	An integer
`SendNotification`	If `true`, the Worker will be sent an e-mail message saying that the Qualification was assigned to them. If `false`, the Worker will not be sent an e-mail message. The default is `true`.	Optional	A Boolean value, either `true` or `false`

Responses

A successful request for the AssignQualification operation will return with no errors. The response will include an AssignQualificationResult element, which contains the Request (if the Request response group is specified). The operation returns no other data.