MTurkR (version 0.2)

GetReviewResultsForHIT: Get ReviewPolicy Results for a HIT

Description

Get HIT- and/or Assignment-level ReviewPolicy Results for a HIT

Usage

GetReviewResultsForHIT(	hit, assignment = NULL, policy.level = NULL,
						retrieve.results = TRUE, retrieve.actions = TRUE,
						keypair = credentials(), print = TRUE,
						browser = FALSE, log.requests = TRUE, sandbox = FALSE)

Arguments

hit

A character string containing a HITId.

assignment

An optional character string containing an AssignmentId. If specified, only results pertaining to that assignment will be returned.

policy.level

Either HIT or Assignment. If omitted, the default behavior is to retrieve all data for both policy levels.

retrieve.results

Optionally retrieve ReviewResults. Default is TRUE.

retrieve.actions

Optionally retrieve ReviewActions. Default is TRUE.

keypair

A two-item character vector containing an AWS Access Key ID in the first position and the corresponding Secret Access Key in the second position. Set default with credentials.

print

Optionally print the results of the API request to the standard output. Default is TRUE.

browser

Optionally open the request in the default web browser, rather than opening in R. Default is FALSE.

log.requests

A logical specifying whether API requests should be logged. Default is TRUE. See readlogfile for details.

sandbox

Optionally execute the request in the MTurk sandbox rather than the live server. Default is FALSE.

Value

• A list containing up to four named dataframes, depending on what ReviewPolicy (or ReviewPolicies) were attached to the HIT: AssignmentReviewResult, AssignmentReviewAction, HITReviewResult, HITReviewAction.

Details

A simple function to return the results of a ReviewPolicy. This is intended only for advanced users, who should reference MTurk documentation for further information. reviewresults is an alias.

References

http://docs.amazonwebservices.com/AWSMechTurk/latest/AWSMturkAPI/ApiReference_GetReviewResultsForHitOperation.html{API Reference} http://docs.amazonwebservices.com/AWSMechTurk/latest/AWSMturkAPI/ApiReference_ReviewPoliciesArticle.html{API Reference (ReviewPolicies)} http://docs.amazonwebservices.com/AWSMechTurk/latest/AWSMturkAPI/ApiReference_HITReviewPolicyDataStructureArticle.html{API Reference (Data Structure)}

See Also

CreateHIT

Examples

GetReviewResultsForHIT()