The UpdateQualificationScore operation changes the value of a Qualification previously granted to a user.
To update a user's Qualification, you must know the user's ID. A Worker's user ID is included in the assignment data returned by the GetAssignmentsForHIT operation.
Only the author (creator) of a Qualification type may update the score of a Qualification of that type.
The user must have already been granted a Qualification of the given Qualification type before the score can be updated.
Using UpdateQualificationScore (REST)
The following example of a call to the UpdateQualificationScore operation changes the value of a Qualification of the given type for the given user.
http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID] &Operation=UpdateQualificationScore &Signature=[signature for this request] &Timestamp=[your system's local time] &QualificationTypeId=789RVWYBAZW00EXAMPLE &SubjectId=AZ3456EXAMPLE &Value=70
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.
UpdateQualificationScore accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.
The following parameters are specific to the UpdateQualificationScore operation:
| Name | Description | Type | Value |
|---|---|---|---|
| Operation |
The operation you would like to call. To access the UpdateQualificationScore operation, set the Operation parameter to UpdateQualificationScore. |
Required |
UpdateQualificationScore |
| QualificationTypeId |
The ID of the Qualification type, as returned by the CreateQualificationType operation. |
Required |
A Qualification type ID |
| SubjectId |
The ID of the user whose Qualification is being updated. A Worker's user ID is returned with assignment data by the GetAssignmentsForHIT operation. |
Required |
A user ID |
| Value |
The new value for the Qualification. |
Required |
An integer |
A successful request for the UpdateQualificationScore will return with no errors. The response will include an UpdateQualificationScoreResult element, which contains the request (if the Request response group is specified). The operation returns no other data.