getResults {validateIt}

Get results from Mturk

Description

Get results from Mturk

Usage

getResults(
  batch_id = "unspecified",
  hit_ids,
  retry = TRUE,
  retry_in_seconds = 60,
  AWS_id = Sys.getenv("AWS_ACCESS_KEY_ID"),
  AWS_secret = Sys.getenv("AWS_SECRET_ACCESS_KEY"),
  sandbox = getOption("pyMTurkR.sandbox", TRUE)
)

Arguments

batch_id

any number or string to annotate the batch

hit_ids

hit ids returned from the MTurk API, i.e., output of sendTasks()

retry

if TRUE, retry retriving results from Mturk API five times; default to TRUE

retry_in_seconds

default to 60 seconds

AWS_id

AWS_ACCESS_KEY_ID

AWS_secret

AWS_SECRET_ACCESS_KEY

sandbox

sanbox setting

Details

this function works for complete or incomplete batches

Value

a data frame with columns:

batch_id

an annotation for the batch

local_task_id

an identifier for the task in the batch

mturk_hit_id

the ID of the HIT in MTurk

assignment_id

the ID of the assignment in MTurk

worker_id

the ID of the worker who completed the assignment

result

the worker's response to the task

completed_at

the time when the worker submitted the assignment