Amazon Mechanical Turk Developer Guide API Version 2017-01-17 Amazon Mechanical Turk Developer Guide
Total Page:16
File Type:pdf, Size:1020Kb
Amazon Mechanical Turk Developer Guide API Version 2017-01-17 Amazon Mechanical Turk Developer Guide Amazon Mechanical Turk: Developer Guide Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved. Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon. Amazon Mechanical Turk Developer Guide Table of Contents What is Amazon Mechanical Turk? ........................................................................................................ 1 Mechanical Turk marketplace ....................................................................................................... 1 Marketplace rules ............................................................................................................... 2 The sandbox marketplace .................................................................................................... 2 Tasks that work well on Mechanical Turk ...................................................................................... 3 Tasks can be completed within a web browser ....................................................................... 3 Work can be broken into distinct, bite-sized tasks .................................................................. 3 Task supports clear instructions and outcomes ...................................................................... 3 Examples of common uses of Mechanical Turk ....................................................................... 3 Core concepts ............................................................................................................................ 4 Requesters and workers ...................................................................................................... 4 Marketplace ....................................................................................................................... 4 Task or HIT ....................................................................................................................... 4 Assignment ....................................................................................................................... 5 Reward and bonus ............................................................................................................. 5 Qualifications .................................................................................................................... 5 Best practices ............................................................................................................................ 5 Allow workers to be as efficient as possible ........................................................................... 5 Build tasks with family and friends in mind ........................................................................... 5 Include an optional feedback field ....................................................................................... 5 Test your HITs ................................................................................................................... 6 Start small ........................................................................................................................ 6 Keep HIT type attributes consistent ...................................................................................... 6 Specify that links open new browser, windows or tabs ............................................................ 7 Limit your use of worker blocks ........................................................................................... 7 Include clear reasons for rejections and blocks ....................................................................... 7 Frequently asked questions ......................................................................................................... 7 Why aren't my tasks being completed? ................................................................................. 7 How do I pull down HITs I created by mistake? ...................................................................... 8 I expired my HITs. Why am I still getting submissions from workers? ......................................... 8 Why are some of my task fields missing from my results? ....................................................... 8 Can I make some fields in my task interface required? ............................................................ 8 How can I test my task interface? ........................................................................................ 8 What is the difference between a HIT and an assignment? ....................................................... 8 Can I view the HITs I create with the API in the requester website? ........................................... 9 I published HITs in the sandbox environment. Why they aren't being completed? ........................ 9 I incorrectly rejected some assignments. Can I reverse the rejection? ......................................... 9 How do I filter the workers eligible to work on my task? ......................................................... 9 How do I create a custom qualification? ................................................................................ 9 Can I restrict how many HITs a worker can complete for my project? ......................................... 9 Can I post HITs in languages other than English? ................................................................... 9 Additional Mechanical Turk Resources ................................................................................. 10 Set up Mechanical Turk ..................................................................................................................... 11 Step 1: Create a Mechanical Turk account .................................................................................... 11 Step 2: Link your AWS account to your Mechanical Turk requester account ....................................... 11 Step 3: Select a payment option ................................................................................................ 12 Step 4: Get an AWS access key .................................................................................................. 12 Step 5: Configure Your Credentials ............................................................................................. 13 Step 6: Set up the developer sandbox ........................................................................................ 13 Access Mechanical Turk ..................................................................................................................... 14 Use the Mechanical Turk Requester UI ........................................................................................ 14 Use the Mechanical Turk API ...................................................................................................... 14 Use the AWS CLI ...................................................................................................................... 14 Download and configure the AWS CLI ................................................................................. 15 API Version 2017-01-17 iii Amazon Mechanical Turk Developer Guide Use the AWS CLI with Mechanical Turk ............................................................................... 15 Get Started with Mechanical Turk ....................................................................................................... 17 Prerequisites ............................................................................................................................ 17 Step 1: Create a task ................................................................................................................ 17 Question definition ........................................................................................................... 17 Task attributes ................................................................................................................. 18 Post the task ................................................................................................................... 18 Step 2: Check task status .......................................................................................................... 20 Step 3: Retrieve results ............................................................................................................. 23 Step 4: Approve Assignments .................................................................................................... 27 Creating and managing tasks (HITs) .................................................................................................... 29 Define questions ...................................................................................................................... 29 Use HTML to define questions ........................................................................................... 29 Question definitions ......................................................................................................... 33 Requester website layouts ................................................................................................. 35 HIT attributes .........................................................................................................................