RubyGems - rturk - Versions diffs - 2.0.2 → 2.0.3 - Mend

rturk 2.0.2 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (122) hide show

data/README.markdown +3 -2
data/Rakefile +10 -4
data/VERSION +1 -1
data/aws_docs/ApiReference_AnswerKeyDataStructureArticle.html +98 -0
data/aws_docs/ApiReference_ApproveAssignmentOperation.html +75 -0
data/aws_docs/ApiReference_AssignQualificationOperation.html +107 -0
data/aws_docs/ApiReference_AssignmentDataStructureArticle.html +171 -0
data/aws_docs/ApiReference_BlockWorkerOperation.html +70 -0
data/aws_docs/ApiReference_ChangeHITTypeOfHITOperation.html +68 -0
data/aws_docs/ApiReference_CommonParametersArticle.html +119 -0
data/aws_docs/ApiReference_CreateHITOperation.html +330 -0
data/aws_docs/ApiReference_CreateQualificationTypeOperation.html +190 -0
data/aws_docs/ApiReference_DataStructuresArticle.html +7 -0
data/aws_docs/ApiReference_DisableHITOperation.html +63 -0
data/aws_docs/ApiReference_DisposeHITOperation.html +56 -0
data/aws_docs/ApiReference_DisposeQualificationTypeOperation.html +52 -0
data/aws_docs/ApiReference_ExtendHITOperation.html +86 -0
data/aws_docs/ApiReference_ExternalQuestionArticle.html +125 -0
data/aws_docs/ApiReference_ForceExpireHITOperation.html +61 -0
data/aws_docs/ApiReference_FormattedContentXHTMLArticle.html +289 -0
data/aws_docs/ApiReference_GetAccountBalanceOperation.html +51 -0
data/aws_docs/ApiReference_GetAssignmentsForHITOperation.html +166 -0
data/aws_docs/ApiReference_GetBonusPaymentsOperation.html +160 -0
data/aws_docs/ApiReference_GetFileUploadURLOperation.html +75 -0
data/aws_docs/ApiReference_GetHITOperation.html +89 -0
data/aws_docs/ApiReference_GetHITsForQualificationTypeOperation.html +137 -0
data/aws_docs/ApiReference_GetQualificationRequestsOperation.html +155 -0
data/aws_docs/ApiReference_GetQualificationScoreOperation.html +68 -0
data/aws_docs/ApiReference_GetQualificationTypeOperation.html +57 -0
data/aws_docs/ApiReference_GetQualificationsForQualificationTypeOperation.html +134 -0
data/aws_docs/ApiReference_GetRequesterStatisticOperation.html +315 -0
data/aws_docs/ApiReference_GetReviewableHITsOperation.html +155 -0
data/aws_docs/ApiReference_GrantBonusOperation.html +95 -0
data/aws_docs/ApiReference_GrantQualificationOperation.html +69 -0
data/aws_docs/ApiReference_HITDataStructureArticle.html +302 -0
data/aws_docs/ApiReference_HelpOperation.html +125 -0
data/aws_docs/ApiReference_LocaleDataStructureArticle.html +29 -0
data/aws_docs/ApiReference_NotificationAPI_BuildingANotificationReceptor.html +36 -0
data/aws_docs/ApiReference_NotificationAPI_ElementsOfANotification.html +40 -0
data/aws_docs/ApiReference_NotificationDataStructureArticle.html +73 -0
data/aws_docs/ApiReference_NotificationReceptorAPIArticle.html +9 -0
data/aws_docs/ApiReference_NotificationReceptorAPI_RESTTransportArticle.html +39 -0
data/aws_docs/ApiReference_NotificationReceptorAPI_SOAPTransportArticle.html +45 -0
data/aws_docs/ApiReference_NotifyWorkersOperation.html +82 -0
data/aws_docs/ApiReference_OperationsArticle.html +8 -0
data/aws_docs/ApiReference_PriceDataStructureArticle.html +65 -0
data/aws_docs/ApiReference_QualificationDataStructureArticle.html +89 -0
data/aws_docs/ApiReference_QualificationRequestDataStructureArticle.html +102 -0
data/aws_docs/ApiReference_QualificationRequirementDataStructureArticle.html +176 -0
data/aws_docs/ApiReference_QualificationTypeDataStructureArticle.html +198 -0
data/aws_docs/ApiReference_QuestionAnswerDataArticle.html +8 -0
data/aws_docs/ApiReference_QuestionFormAnswersDataStructureArticle.html +54 -0
data/aws_docs/ApiReference_QuestionFormDataStructureArticle.html +796 -0
data/aws_docs/ApiReference_RegisterHITTypeOperation.html +149 -0
data/aws_docs/ApiReference_RejectAssignmentOperation.html +66 -0
data/aws_docs/ApiReference_RejectQualificationRequestOperation.html +61 -0
data/aws_docs/ApiReference_RevokeQualificationOperation.html +78 -0
data/aws_docs/ApiReference_SearchHITsOperation.html +164 -0
data/aws_docs/ApiReference_SearchQualificationTypesOperation.html +211 -0
data/aws_docs/ApiReference_SendTestEventNotificationOperation.html +78 -0
data/aws_docs/ApiReference_SetHITAsReviewingOperation.html +73 -0
data/aws_docs/ApiReference_SetHITTypeNotificationOperation.html +99 -0
data/aws_docs/ApiReference_UnblockWorkerOperation.html +67 -0
data/aws_docs/ApiReference_UpdateQualificationScoreOperation.html +77 -0
data/aws_docs/ApiReference_UpdateQualificationTypeOperation.html +180 -0
data/aws_docs/ApiReference_WsdlLocationArticle.html +95 -0
data/aws_docs/ApiReference_XMLParameterValuesArticle.html +37 -0
data/aws_docs/Welcome.html +125 -0
data/aws_docs/WhatsNew.html +16 -0
data/aws_docs/_title.html +28 -0
data/aws_docs/_toc.html +749 -0
data/aws_docs/aws-docs-IE.css +419 -0
data/aws_docs/aws-docs.css +455 -0
data/aws_docs/copyrightinfo.html +14 -0
data/aws_docs/frameset.js +12 -0
data/aws_docs/images/Feedback_link.gif +0 -0
data/aws_docs/images/caution.png +0 -0
data/aws_docs/images/home.gif +0 -0
data/aws_docs/images/important.png +0 -0
data/aws_docs/images/next.gif +0 -0
data/aws_docs/images/note.png +0 -0
data/aws_docs/images/prev.gif +0 -0
data/aws_docs/images/tip.png +0 -0
data/aws_docs/images/title-swoosh-logo.gif +0 -0
data/aws_docs/images/toc_bullet.gif +0 -0
data/aws_docs/images/toc_plus.gif +0 -0
data/aws_docs/index.html +18 -0
data/aws_docs/toc.js +84 -0
data/lib/rturk.rb +2 -2
data/lib/rturk/adapter.rb +11 -0
data/lib/rturk/adapters/assignment.rb +13 -50
data/lib/rturk/adapters/hit.rb +21 -9
data/lib/rturk/adapters/worker.rb +23 -0
data/lib/rturk/operation.rb +1 -1
data/lib/rturk/operations/create_hit.rb +10 -54
data/lib/rturk/operations/register_hit_type.rb +68 -0
data/lib/rturk/operations/search_hits.rb +44 -0
data/lib/rturk/parser.rb +8 -0
data/lib/rturk/parsers/answer_parser.rb +29 -0
data/lib/rturk/parsers/assignment_parser.rb +49 -0
data/lib/rturk/parsers/hit_parser.rb +50 -0
data/lib/rturk/{response.rb → parsers/response.rb} +7 -2
data/lib/rturk/{responses → parsers/responses}/create_hit_response.rb +2 -2
data/lib/rturk/{responses → parsers/responses}/get_account_balance_response.rb +0 -0
data/lib/rturk/{responses → parsers/responses}/get_assignments_for_hit_response.rb +3 -3
data/lib/rturk/{responses → parsers/responses}/get_hit_response.rb +9 -16
data/lib/rturk/{responses → parsers/responses}/get_reviewable_hits_response.rb +3 -5
data/lib/rturk/parsers/responses/register_hit_type_response.rb +17 -0
data/lib/rturk/parsers/responses/search_hits_response.rb +65 -0
data/lib/rturk/xml_utilities.rb +14 -3
data/rturk.gemspec +112 -12
data/spec/adapters/hit_spec.rb +10 -0
data/spec/fake_responses/register_hit_type.xml +6 -0
data/spec/fake_responses/search_hits.xml +50 -0
data/spec/operations/create_hit_spec.rb +2 -2
data/spec/operations/get_hit_spec.rb +1 -1
data/spec/operations/register_hit_type_spec.rb +24 -0
data/spec/{adapters/answers_spec.rb → parsers/answer_parser_spec.rb} +2 -2
data/spec/parsers/hit_parser_spec.rb +41 -0
data/spec/xml_parse_spec.rb +2 -2
metadata +111 -11
data/lib/rturk/adapters/answers.rb +0 -38

data/README.markdown CHANGED Viewed

@@ -24,9 +24,10 @@ Let's say you have a form at "http://myapp.com/turkers/add_tags" where Turkers c
     RTurk.setup(YourAWSAccessKeyId, YourAWSAccessKey, :sandbox => true)
     hit = RTurk::Hit.create(:title => "Add some tags to a photo") do |hit|
       hit.assignments = 2
+      hit.description = 'blah'
       hit.question("http://myapp.com/turkers/add_tags")
       hit.reward = 0.05
-      hit.qualifications.approval_rate, {:gt => 80}
+      hit.qualifications.add :approval_rate, { :gt => 80 }
     end
     p hit.url #=>  'https://workersandbox.mturk.com:443/mturk/preview?groupId=Q29J3XZQ1ASZH5YNKZDZ'
@@ -95,4 +96,4 @@ Anything submitted in this form will be sent to Amazon and saved for your review
 Take a look at the [Amazon MTurk developer docs](http://docs.amazonwebservices.com/AWSMechTurk/latest/AWSMechanicalTurkRequester/) for more information. They have a complete list of API operations, all of which can be called with this library.

data/Rakefile CHANGED Viewed

@@ -1,6 +1,14 @@
 require 'rubygems'
 require 'rake'
-require 'yard'
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new do |t|
+    t.files   = ['lib/**/*.rb', 'lib/**/*.rb']
+  end
+rescue LoadError
+  puts "YARD is not available. For generating docs, you'll need to sudo gem install yard"
+end
 begin
   require 'jeweler'
@@ -48,6 +56,4 @@ Rake::RDocTask.new do |rdoc|
 end
-YARD::Rake::YardocTask.new do |t|
-  t.files   = ['lib/**/*.rb', 'lib/**/*.rb']
-end

data/VERSION CHANGED Viewed

	@@ -1 +1 @@
1	- 2.0.2
1	+ 2.0.3

data/aws_docs/ApiReference_AnswerKeyDataStructureArticle.html ADDED Viewed

@@ -0,0 +1,98 @@
+<html xmlns:fo="http://www.w3.org/1999/XSL/Format"><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>AnswerKey</title><link rel="stylesheet" href="aws-docs-IE.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#top" title="Amazon Mechanical Turk"><link rel="up" href="ApiReference_QuestionAnswerDataArticle.html" title="Chapter&nbsp;7.&nbsp;Question and Answer Data"><link rel="prev" href="ApiReference_QuestionFormAnswersDataStructureArticle.html" title="QuestionFormAnswers"><link rel="next" href="ApiReference_ExternalQuestionArticle.html" title="ExternalQuestion"><!--[if !IE]>--><link rel="stylesheet" href="aws-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><!--<![endif]--><meta xmlns="http://www.w3.org/1999/xhtml" http-equiv="Content-Type" content="text/html; charset=utf-8"></meta><script src="/urchin.js" type="text/javascript"></script><script type="text/javascript">
+				urchinTracker();
+			</script><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript" src="frameset.js"> //
+		</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_QuestionFormAnswersDataStructureArticle.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_AnswerKeyDataStructureArticle">Documentation Feedback</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_ExternalQuestionArticle.html"><img src="images/next.gif" alt="Next"></a></td></tr></table><div class="breadcrumb"><a href="Welcome.html">Welcome</a><a href=""></a> &raquo; <a href="ApiReference_QuestionAnswerDataArticle.html">Question and Answer Data</a> &raquo; <strong>AnswerKey</strong></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h1 class="topictitle">AnswerKey</h1></div></div></div><a class="indexterm" name="d0e19956"></a><a class="indexterm" name="d0e19959"></a><a class="indexterm" name="d0e19964"></a><a class="indexterm" name="d0e19969"></a><div class="highlights"><p><strong>Topics</strong></p><ul><li><a href="ApiReference_AnswerKeyDataStructureArticle.html#d0e19975">Description</a></li><li><a href="ApiReference_AnswerKeyDataStructureArticle.html#d0e20019">The Structure of an Answer Key</a></li><li><a href="ApiReference_AnswerKeyDataStructureArticle.html#d0e20166">Example</a></li></ul></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e19975">Description</h2></div></div></div><p> The AnswerKey data structure specifies answers for a Qualification test, and a mechanism to use
+			to calculate a score from the key and a Worker's answers. </p><p> An AnswerKey data structure is a string value that consists of XML data. The XML data must
+			conform to the AnswerKey schema. See <a class="link" href="ApiReference_WsdlLocationArticle.html" title="Chapter&nbsp;3.&nbsp;WSDL and Schema Locations">WSDL and
+				Schema Locations</a> for the location of this schema. For more information about using XML
+			data as parameter or return value, see <a class="link" href="ApiReference_XMLParameterValuesArticle.html" title="Using XML Parameter Values">Using XML Parameter Values</a>. </p><p> The AnswerKey data structure is used as a parameter for the following operations: </p><div class="itemizedlist"><ul type="disc"><li><p>
+					<code class="function">CreateQualificationType</code>
+				</p></li></ul></div><p> The AnswerKey data structure is used as a return value for the following operations: </p><div class="itemizedlist"><ul type="disc"><li><p>
+					<code class="function">GetQualificationType</code>
+				</p></li></ul></div><p> The AnswerKey data structure is a value in a <a class="link" href="ApiReference_QualificationTypeDataStructureArticle.html" title="QualificationType">Qualification type data
+			structure</a>. </p><p> All elements in a <em class="parameter"><code>AnswerKey</code></em> belong to a namespace whose name is
+			identical to the URL of the <em class="parameter"><code>AnswerKey</code></em> schema document for the version of
+			the API you are using. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e20019">The Structure of an Answer Key</h2></div></div></div><p> An answer key is contained in a <em class="parameter"><code>AnswerKey</code></em> element. This element contains
+			a <em class="parameter"><code>Question</code></em> element for each question in the Qualification test, and an
+			optional <em class="parameter"><code>QualificationValueMapping</code></em> element that describes how to calculate
+			the Qualification value from the answer key and the Worker's answers. </p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e20033">Question</h3></div></div></div><p> A <em class="parameter"><code>Question</code></em> element contains a
+				<em class="parameter"><code>QuestionIdentifier</code></em> element, which identifies the question for this
+				answer. This value corresponds to a <em class="parameter"><code>QuestionIdentifier</code></em> in the
+				QuestionForm. </p><p> A <em class="parameter"><code>Question</code></em> element has one or more
+				<em class="parameter"><code>AnswerOption</code></em> elements, one for each combination of selections in the
+				multiple-choice question that affects the Worker's test score. </p><p> Each <em class="parameter"><code>AnswerOption</code></em> contains one or more
+					<em class="parameter"><code>SelectionIdentifier</code></em> elements that correspond to identifiers for the
+				selections in the QuestionForm. It also contains an <em class="parameter"><code>AnswerScore</code></em>
+				element, a number that is added to the Worker's test score if the Worker's answer matches this
+				option. The Worker must select all of the selections specified by the
+					<em class="parameter"><code>SelectionIdentifier</code></em> elements, and no others, to earn the score. </p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="images/tip.png"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p> An <em class="parameter"><code>AnswerScore</code></em> for an <em class="parameter"><code>AnswerOption</code></em> may be
+					negative. </p></td></tr></table></div><p> The <em class="parameter"><code>Question</code></em> may have an optional
+				<em class="parameter"><code>DefaultScore</code></em>, a number that is added to the Worker's test score if none
+				of the answer options exactly match the Worker's answer for the question.
+					<em class="parameter"><code>DefaultScore</code></em> is optional, and defaults to 0. </p><pre class="programlisting">&lt;AnswerOption&gt;
+  &lt;SelectionIdentifier&gt;apples&lt;/SelectionIdentifier&gt;
+  &lt;AnswerScore&gt;10&lt;/AnswerScore&gt;
+&lt;/AnswerOption&gt;</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e20091">QualificationValueMapping</h3></div></div></div><p> The <em class="parameter"><code>Question</code></em> may have an optional
+					<em class="parameter"><code>QualificationValueMapping</code></em> element that describes how to calculate
+				the Worker's overall score from the scores of the Worker's answers. It contains either a
+					<em class="parameter"><code>PercentageMapping</code></em> element, a <em class="parameter"><code>ScaleMapping</code></em>
+				element, or a <em class="parameter"><code>RangeMapping</code></em> element. </p><p> If no <em class="parameter"><code>QualificationValueMapping</code></em> is specified, the sum of the scores
+				of the answers is used as the Qualification value. </p><pre class="programlisting">&lt;QualificationValueMapping&gt;
+  ...
+&lt;/QualificationValueMapping&gt;</pre><p> A <em class="parameter"><code>PercentageMapping</code></em> specifies a maximum score for the test, as a
+					<em class="parameter"><code>MaximumSummedScore</code></em> element. The Qualification value is calculated
+				as the sum of the scores of the selected answers, divided by the maximum, multiplied by 100
+				and rounded to the nearest integer to produce a percentage. </p><pre class="programlisting">  ...
+  &lt;PercentageMapping&gt;
+    &lt;MaximumSummedScore&gt;15&lt;/MaximumSummedScore&gt;
+  &lt;/PercentageMapping&gt;</pre><p> A <em class="parameter"><code>ScaleMapping</code></em> specifies a multiplier, as a decimal value in a
+					<em class="parameter"><code>SummedScoreMultiplier</code></em> element. The Qualification value is
+				calculated as the sum of the scores of the selected answers, multiplied by the multiplier. </p><pre class="programlisting">  ...
+  &lt;ScaleMapping&gt;
+    &lt;SummedScoreMultiplier&gt;3&lt;/SummedScoreMultiplier&gt;
+  &lt;/ScaleMapping&gt;</pre><p> A <em class="parameter"><code>RangeMapping</code></em> assigns specific Qualification values to ranges of
+				total test scores. It contains one or more <em class="parameter"><code>SummedScoreRange</code></em> elements,
+				each of which specify an <em class="parameter"><code>InclusiveLowerBound</code></em> element, an
+					<em class="parameter"><code>InclusiveUpperBound</code></em> element, and a
+				<em class="parameter"><code>QualificationValue</code></em> that becomes the Qualification value if the sum of
+				the scores of the selected answers falls within the specified range. Finally, the
+					<em class="parameter"><code>RangeMapping</code></em> includes a single
+					<em class="parameter"><code>OutOfRangeQualificationValue</code></em>, which specifies the Qualification
+				value if the sum of the scores of the selected answers do not fall within a specified range. </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p> Ranges cannot overlap. If ranges overlap, the behavior is undefined. </p></td></tr></table></div><pre class="programlisting">  ...
+  &lt;RangeMapping&gt;
+    &lt;SummedScoreRange&gt;
+      &lt;InclusiveLowerBound&gt;5&lt;/InclusiveLowerBound&gt;
+      &lt;InclusiveUpperBound&gt;7&lt;/InclusiveUpperBound&gt;
+      &lt;QualificationValue&gt;5&lt;/QualificationValue&gt;
+    &lt;/SummedScoreRange&gt;
+    &lt;SummedScoreRange&gt;
+      &lt;InclusiveLowerBound&gt;8&lt;/InclusiveLowerBound&gt;
+      &lt;InclusiveUpperBound&gt;10&lt;/InclusiveUpperBound&gt;
+      &lt;QualificationValue&gt;10&lt;/QualificationValue&gt;
+    &lt;/SummedScoreRange&gt;
+    &lt;OutOfRangeQualificationValue&gt;0&lt;/OutOfRangeQualificationValue&gt;
+  &lt;/RangeMapping&gt;</pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e20166">Example</h2></div></div></div><p> The following is an example of a complete <em class="parameter"><code>QuestionForm</code></em> data structure.
+			Remember that to pass this structure in as a parameter to an operation, XML characters must be
+			escaped as character entities. </p><pre class="programlisting">&lt;AnswerKey xmlns="<em class="replaceable"><code>[the AnswerKey schema URL]</code></em>"&gt;
+  &lt;Question&gt;
+    &lt;QuestionIdentifier&gt;nextmove&lt;/QuestionIdentifier&gt;
+    &lt;AnswerOption&gt;
+      &lt;SelectionIdentifier&gt;D&lt;/SelectionIdentifier&gt;
+      &lt;AnswerScore&gt;5&lt;/AnswerScore&gt;
+    &lt;/AnswerOption&gt;
+  &lt;/Question&gt;
+  &lt;Question&gt;
+    &lt;QuestionIdentifier&gt;favoritefruit&lt;/QuestionIdentifier&gt;
+    &lt;AnswerOption&gt;
+      &lt;SelectionIdentifier&gt;apples&lt;/SelectionIdentifier&gt;
+      &lt;AnswerScore&gt;10&lt;/AnswerScore&gt;
+    &lt;/AnswerOption&gt;
+  &lt;/Question&gt;
+  &lt;QualificationValueMapping&gt;
+    &lt;PercentageMapping&gt;
+      &lt;MaximumSummedScore&gt;15&lt;/MaximumSummedScore&gt;
+    &lt;/PercentageMapping&gt;
+  &lt;/QualificationValueMapping&gt;
+&lt;/AnswerKey&gt;</pre></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_QuestionFormAnswersDataStructureArticle.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_AnswerKeyDataStructureArticle">Documentation Feedback</a><br><a href="copyrightinfo.html">Copyright Information</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_ExternalQuestionArticle.html"><img src="images/next.gif" alt="Next"></a></td></tr><tr><td width="30%" align="left" valign="top">&nbsp;</td><td width="40%" align="center"><a accesskey="h" href="#top"><img src="images/home.gif" alt="Home"></a></td><td width="30%" align="right" valign="top">&nbsp;</td></tr></table></div></body></html>

data/aws_docs/ApiReference_ApproveAssignmentOperation.html ADDED Viewed

@@ -0,0 +1,75 @@
+<html xmlns:fo="http://www.w3.org/1999/XSL/Format"><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>ApproveAssignment</title><link rel="stylesheet" href="aws-docs-IE.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#top" title="Amazon Mechanical Turk"><link rel="up" href="ApiReference_OperationsArticle.html" title="Chapter&nbsp;5.&nbsp;Operations"><link rel="prev" href="ApiReference_OperationsArticle.html" title="Chapter&nbsp;5.&nbsp;Operations"><link rel="next" href="ApiReference_AssignQualificationOperation.html" title="AssignQualification"><!--[if !IE]>--><link rel="stylesheet" href="aws-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><!--<![endif]--><meta xmlns="http://www.w3.org/1999/xhtml" http-equiv="Content-Type" content="text/html; charset=utf-8"></meta><script src="/urchin.js" type="text/javascript"></script><script type="text/javascript">
+				urchinTracker();
+			</script><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript" src="frameset.js"> //
+		</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_OperationsArticle.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_ApproveAssignmentOperation">Documentation Feedback</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_AssignQualificationOperation.html"><img src="images/next.gif" alt="Next"></a></td></tr></table><div class="breadcrumb"><a href="Welcome.html">Welcome</a><a href=""></a> &raquo; <a href="ApiReference_OperationsArticle.html">Operations</a> &raquo; <strong>ApproveAssignment</strong></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h1 class="topictitle">ApproveAssignment</h1></div></div></div><a class="indexterm" name="d0e1122"></a><a class="indexterm" name="d0e1125"></a><a class="indexterm" name="d0e1130"></a><a class="indexterm" name="d0e1135"></a><a class="indexterm" name="d0e1140"></a><a class="indexterm" name="d0e1145"></a><a class="indexterm" name="d0e1148"></a><a class="indexterm" name="d0e1153"></a><a class="indexterm" name="d0e1158"></a><a class="indexterm" name="d0e1163"></a><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e1168">Description</h2></div></div></div><p> The <code class="function">ApproveAssignment</code> operation approves the results of a
+			completed assignment. </p><p> Approving an assignment initiates two payments from the Requester's Amazon.com
+			account: the Worker who submitted the results is paid the reward specified in the HIT,
+			and Amazon Mechanical Turk fees are debited. If the Requester's account does not have
+			adequate funds for these payments, the call to <code class="function">ApproveAssignment</code>
+			returns an exception, and the approval is not processed. </p><p> You can include an optional feedback message with the approval, which the Worker can
+			see in the <span class="guilabel">Status</span> section of the web site. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e1186">Request Parameters</h2></div></div></div><p> The <code class="function">ApproveAssignment</code> operation accepts parameters common to all
+			operations. Some common parameters are required. See <a class="link" href="ApiReference_CommonParametersArticle.html" title="Chapter&nbsp;4.&nbsp;Common Parameters">Common Parameters</a> for more information. </p><p> The following parameters are specific to the <code class="function">ApproveAssignment</code>
+			operation: </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col><col></colgroup><thead><tr><th>Name</th><th>Description</th><th>Required</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>Operation</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The name of the operation</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Valid Values: ApproveAssignment</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>AssignmentId</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The ID of the assignment. This parameter must correspond to a
+								HIT created by the Requester. </p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>RequesterFeedback</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> A message for the Worker, which the Worker can see in the
+									<span class="guilabel">Status</span> section of the web site. </p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+							<p class="simpara"> Constraints: Can be up to 1024 characters (including
+								multi-byte characters). </p>
+							<p class="simpara"> The <em class="parameter"><code>RequesterFeedback</code></em> parameter cannot
+								contain ASCII characters 0-8, 11,12, or 14-31. If these characters
+								are present, the operation throws an InvalidParameterValue error.
+							</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e1305">Response Elements</h2></div></div></div><p> A successful request for the <code class="function">ApproveAssignment</code> operation returns
+			with no errors. The response includes the elements described in the following table. The
+			operation returns no other data. </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>ApproveAssignmentResult</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">Contains a <em class="parameter"><code>Request</code></em> element if the
+									<strong class="userinput"><code>Request</code></strong>
+								<em class="parameter"><code>ResposeGroup</code></em> is specified. </p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e1347">Examples</h2></div></div></div><p>The following example shows how to use the <code class="function">ApproveAssignment</code>
+			operation.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e1355">Sample Request</h3></div></div></div><p> The following example approves an assignment identified by its assignment ID. </p><pre class="programlisting">http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester
+&amp;AWSAccessKeyId=<em class="replaceable"><code>[the Requester's Access Key ID]</code></em>
+&amp;Version=2008-08-02
+&amp;Operation=ApproveAssignment
+&amp;Signature=<em class="replaceable"><code>[signature for this request]</code></em>
+&amp;Timestamp=<em class="replaceable"><code>[your system's local time]</code></em>
+&amp;AssignmentId=123RVWYBAZW00EXAMPLE456RVWYBAZW00EXAMPLE
+        </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e1371">Sample Response</h3></div></div></div><p>The following is an example response.</p><pre class="programlisting">&lt;ApproveAssignmentResult&gt;
+  &lt;Request&gt;
+    &lt;IsValid&gt;True&lt;/IsValid&gt;
+  &lt;/Request&gt;
+&lt;/ApproveAssignmentResult&gt;</pre></div></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_OperationsArticle.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_ApproveAssignmentOperation">Documentation Feedback</a><br><a href="copyrightinfo.html">Copyright Information</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_AssignQualificationOperation.html"><img src="images/next.gif" alt="Next"></a></td></tr><tr><td width="30%" align="left" valign="top">&nbsp;</td><td width="40%" align="center"><a accesskey="h" href="#top"><img src="images/home.gif" alt="Home"></a></td><td width="30%" align="right" valign="top">&nbsp;</td></tr></table></div></body></html>

data/aws_docs/ApiReference_AssignQualificationOperation.html ADDED Viewed

@@ -0,0 +1,107 @@
+<html xmlns:fo="http://www.w3.org/1999/XSL/Format"><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>AssignQualification</title><link rel="stylesheet" href="aws-docs-IE.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#top" title="Amazon Mechanical Turk"><link rel="up" href="ApiReference_OperationsArticle.html" title="Chapter&nbsp;5.&nbsp;Operations"><link rel="prev" href="ApiReference_ApproveAssignmentOperation.html" title="ApproveAssignment"><link rel="next" href="ApiReference_BlockWorkerOperation.html" title="BlockWorker"><!--[if !IE]>--><link rel="stylesheet" href="aws-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><!--<![endif]--><meta xmlns="http://www.w3.org/1999/xhtml" http-equiv="Content-Type" content="text/html; charset=utf-8"></meta><script src="/urchin.js" type="text/javascript"></script><script type="text/javascript">
+				urchinTracker();
+			</script><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript" src="frameset.js"> //
+		</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_ApproveAssignmentOperation.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_AssignQualificationOperation">Documentation Feedback</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_BlockWorkerOperation.html"><img src="images/next.gif" alt="Next"></a></td></tr></table><div class="breadcrumb"><a href="Welcome.html">Welcome</a><a href=""></a> &raquo; <a href="ApiReference_OperationsArticle.html">Operations</a> &raquo; <strong>AssignQualification</strong></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h1 class="topictitle">AssignQualification</h1></div></div></div><a class="indexterm" name="d0e1381"></a><a class="indexterm" name="d0e1384"></a><a class="indexterm" name="d0e1389"></a><a class="indexterm" name="d0e1392"></a><a class="indexterm" name="d0e1397"></a><a class="indexterm" name="d0e1402"></a><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e1407">Description</h2></div></div></div><p> The <code class="function">AssignQualification</code> operation gives a Worker a
+			Qualification. <code class="function">AssignQualification</code> does not require that the Worker
+			submit a Qualification request. It gives the Qualification directly to the Worker. </p><p> You can assign a Qualification to any Worker who has submitted one of your HITs in
+			the past. </p><p> You can only assign a Qualification of a Qualification type that you created (using
+			the <a class="link" href="ApiReference_CreateQualificationTypeOperation.html" title="CreateQualificationType">
+				CreateQualificationType</a> operation). </p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="images/tip.png"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
+				<code class="function">AssignQualification</code> 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 <a class="link" href="ApiReference_RejectQualificationRequestOperation.html" title="RejectQualificationRequest">
+					RejectQualificationRequest</a> operation. </p></td></tr></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e1434">Request Parameters</h2></div></div></div><p> The <code class="function">AssignQualification</code> operation accepts parameters common to
+			all operations. Some common parameters are required. See <a class="link" href="ApiReference_CommonParametersArticle.html" title="Chapter&nbsp;4.&nbsp;Common Parameters">CommonParameters</a> for more
+			information. </p><p> The following parameters are specific to the <code class="function">AssignQualification</code>
+			operation: </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col><col></colgroup><thead><tr><th>Name</th><th>Description</th><th>Required</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>Operation</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The name of the operation</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Valid Values: AssignQualifcation</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>QualificationTypeId</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The ID of the Qualification type to use for the assigned
+								Qualification.</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+							<p class="simpara"> Constraints: must be a valid Qualification type ID, as
+								returned by the <a class="link" href="ApiReference_CreateQualificationTypeOperation.html" title="CreateQualificationType">
+									CreateQualificationType</a> operation. </p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>WorkerId</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The ID of the Worker to whom the Qualification is being
+								assigned. Worker IDs are included with submitted HIT assignments and
+								Qualification requests. </p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">Yes</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>IntegerValue</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The value of the Qualification to assign.</p>
+							<p class="simpara">Type: Integer</p>
+							<p class="simpara">Default: 1</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>SendNotification</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> Specifies whether to send a notification email message to the
+								Worker saying that the qualification was assigned to the Worker. </p>
+							<p class="simpara">Type: Boolean</p>
+							<p class="simpara"> Valid Values: <code class="code">true</code> | <code class="code">false</code>. </p>
+							<p class="simpara">Default: <code class="code">true</code></p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e1609">Response Elements</h2></div></div></div><p> A successful request for the AssignQualification operation returns with no errors.
+			The response includes the elements described in the following table. The operation
+			returns no other data. </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>AssignQualificationResult</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> Contains a <em class="parameter"><code>Request</code></em> element if the
+									<strong class="userinput"><code>Request</code></strong>
+								<em class="parameter"><code>ResposeGroup</code></em> is specified. </p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e1648">Examples</h2></div></div></div><p>The following example shows how to use the <code class="function">AssignQualification</code>
+			operation.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e1656">Sample Request</h3></div></div></div><p> The following example assigns a Qualification of a specified type to a Worker
+					with the specified ID, using the specified Qualification value. By default,
+					Amazon Mechanical Turk sends the Worker an e-mail message saying that the Worker
+					has received the Qualification. </p><pre class="programlisting">http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester
+&amp;AWSAccessKeyId=<em class="replaceable"><code>[the Requester's Access Key ID]</code></em>
+&amp;Version=2008-08-02
+&amp;Operation=AssignQualification
+&amp;Signature=<em class="replaceable"><code>[signature for this request]</code></em>
+&amp;Timestamp=<em class="replaceable"><code>[your system's local time]</code></em>
+&amp;QualificationTypeId=789RVWYBAZW00EXAMPLE
+&amp;WorkerId=AZ3456EXAMPLE
+&amp;IntegerValue=800
+           </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title" id="d0e1672">Sample Response</h3></div></div></div><p>The following is an example response.</p><pre class="programlisting">&lt;AssignQualificationResult&gt;
+  &lt;Request&gt;
+    &lt;IsValid&gt;True&lt;/IsValid&gt;
+  &lt;/Request&gt;
+&lt;/AssignQualificationResult&gt;</pre></div></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_ApproveAssignmentOperation.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_AssignQualificationOperation">Documentation Feedback</a><br><a href="copyrightinfo.html">Copyright Information</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_BlockWorkerOperation.html"><img src="images/next.gif" alt="Next"></a></td></tr><tr><td width="30%" align="left" valign="top">&nbsp;</td><td width="40%" align="center"><a accesskey="h" href="#top"><img src="images/home.gif" alt="Home"></a></td><td width="30%" align="right" valign="top">&nbsp;</td></tr></table></div></body></html>

data/aws_docs/ApiReference_AssignmentDataStructureArticle.html ADDED Viewed

@@ -0,0 +1,171 @@
+<html xmlns:fo="http://www.w3.org/1999/XSL/Format"><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Assignment</title><link rel="stylesheet" href="aws-docs-IE.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><link rel="home" href="#top" title="Amazon Mechanical Turk"><link rel="up" href="ApiReference_DataStructuresArticle.html" title="Chapter&nbsp;6.&nbsp;Data Structures"><link rel="prev" href="ApiReference_DataStructuresArticle.html" title="Chapter&nbsp;6.&nbsp;Data Structures"><link rel="next" href="ApiReference_HITDataStructureArticle.html" title="HIT"><!--[if !IE]>--><link rel="stylesheet" href="aws-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><!--<![endif]--><meta xmlns="http://www.w3.org/1999/xhtml" http-equiv="Content-Type" content="text/html; charset=utf-8"></meta><script src="/urchin.js" type="text/javascript"></script><script type="text/javascript">
+				urchinTracker();
+			</script><script xmlns="http://www.w3.org/1999/xhtml" type="text/javascript" src="frameset.js"> //
+		</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_DataStructuresArticle.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_AssignmentDataStructureArticle">Documentation Feedback</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_HITDataStructureArticle.html"><img src="images/next.gif" alt="Next"></a></td></tr></table><div class="breadcrumb"><a href="Welcome.html">Welcome</a><a href=""></a> &raquo; <a href="ApiReference_DataStructuresArticle.html">Data Structures</a> &raquo; <strong>Assignment</strong></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h1 class="topictitle">Assignment</h1></div></div></div><a class="indexterm" name="d0e13741"></a><a class="indexterm" name="d0e13744"></a><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e13749">Description</h2></div></div></div><p> The Assignment data structure represents a single assignment of a HIT to a Worker. The
+			assignment tracks the Worker's efforts to complete the HIT, and contains the results for later
+			retrieval. </p><p> The Assignment data structure is used as a response element for the following operation: </p><div class="itemizedlist"><ul type="disc"><li><p>
+					<a class="link" href="ApiReference_GetAssignmentsForHITOperation.html" title="GetAssignmentsForHIT">GetAssignmentsForHIT</a>
+				</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e13763">Elements</h2></div></div></div><p> The Assignment structure can contain the following elements. </p><div class="informaltable"><table cellspacing="0" border="0"><colgroup><col><col><col></colgroup><thead><tr><th>Name</th><th>Description</th><th>Required</th></tr></thead><tbody><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>AssignmentId</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">A unique identifier for the assignment</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>WorkerId</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The ID of the Worker who accepted the HIT. </p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>HITId</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The ID of the HIT</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>AssignmentStatus</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The status of the assignment</p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara">Valid Values: Submitted | Approved | Rejected</p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>AutoApprovalTime</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> If results have been submitted, <em class="parameter"><code>AutoApprovalTime</code></em>
+								is the date and time the results of the assignment results are considered
+									<span class="guilabel">Approved</span> automatically if they have not already been
+								explicitly approved or rejected by the Requester. This value is derived from
+								the auto-approval delay specified by the Requester in the HIT. This value is
+								omitted from the assignment if the Worker has not yet submitted results. </p>
+							<p class="simpara"> Type: a <a class="ulink" href="http://www.w3.org/TR/xmlschema-2/#dateTime" target="_blank">dateTime</a> structure in the Coordinated Universal Time (Greenwich Mean
+								Time) time zone, such as <strong class="userinput"><code>2005-01-31T23:59:59Z</code></strong>. </p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>AcceptTime</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">The date and time the Worker accepted the assignment.</p>
+							<p class="simpara"> Type: a <a class="ulink" href="http://www.w3.org/TR/xmlschema-2/#dateTime" target="_blank">dateTime</a> structure in the Coordinated Universal Time (Greenwich Mean
+								Time) time zone, such as <strong class="userinput"><code>2005-01-31T23:59:59Z</code></strong>. </p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>SubmitTime</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> If the Worker has submitted results, <em class="parameter"><code>SubmitTime</code></em>
+								is the date and time the assignment was submitted. This value is omitted from
+								the assignment if the Worker has not yet submitted results. </p>
+							<p class="simpara"> Type: a <a class="ulink" href="http://www.w3.org/TR/xmlschema-2/#dateTime" target="_blank">dateTime</a> structure in the Coordinated Universal Time (Greenwich Mean
+								Time) time zone, such as <strong class="userinput"><code>2005-01-31T23:59:59Z</code></strong>. </p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>ApprovalTime</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> If the Worker has submitted results and the Requester has approved the
+								results, <em class="parameter"><code>ApprovalTime</code></em> is the date and time the
+								Requester approved the results. This value is omitted from the assignment if
+								the Requester has not yet approved the results. </p>
+							<p class="simpara"> Type: a <a class="ulink" href="http://www.w3.org/TR/xmlschema-2/#dateTime" target="_blank">dateTime</a> structure in the Coordinated Universal Time (Greenwich Mean
+								Time) time zone, such as <strong class="userinput"><code>2005-01-31T23:59:59Z</code></strong>. </p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>RejectionTime</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> If the Worker has submitted results and the Requester has rejected the
+								results, <em class="parameter"><code>RejectionTime</code></em> is the date and time the
+								Requester rejected the results. </p>
+							<p class="simpara"> Type: a <a class="ulink" href="http://www.w3.org/TR/xmlschema-2/#dateTime" target="_blank">dateTime</a> structure in the Coordinated Universal Time (Greenwich Mean
+								Time) time zone, such as <strong class="userinput"><code>2005-01-31T23:59:59Z</code></strong>. </p>
+							<p class="simpara"> Default: None. This value is omitted from the assignment if the
+								Requester has not yet rejected the results. </p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>Deadline</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The date and time of the deadline for the assignment. This value is
+								derived from the deadline specification for the HIT and the date and time the
+								Worker accepted the HIT. </p>
+							<p class="simpara"> Type: a <a class="ulink" href="http://www.w3.org/TR/xmlschema-2/#dateTime" target="_blank">dateTime</a> structure in the Coordinated Universal Time (Greenwich Mean
+								Time) time zone, such as <strong class="userinput"><code>2005-01-31T23:59:59Z</code></strong>. </p>
+							<p class="simpara">Default: None</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>Answer</code></em>
+							</p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td><td class="auto-generated">&nbsp;</td></tr><tr><td>
+							<p class="simpara">
+								<em class="parameter"><code>RequesterFeedback</code></em>
+							</p>
+						</td><td>
+							<p class="simpara"> The feedback string included with the call to the <a class="link" href="ApiReference_ApproveAssignmentOperation.html" title="ApproveAssignment">
+								ApproveAssignment</a> operation or the<a class="link" href="ApiReference_RejectAssignmentOperation.html" title="RejectAssignment"> RejectAssignment</a>
+								operation, if the Requester approved or rejected the assignment and specified
+								feedback. </p>
+							<p class="simpara">Type: String</p>
+							<p class="simpara"> Default: None. This field is not returned with assignment data by
+								default. To request this field, specify a response group of
+									<strong class="userinput"><code>AssignmentFeedback</code></strong>. </p>
+						</td><td>
+							<p class="simpara">No</p>
+						</td></tr></tbody></table></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="d0e14134">Example</h2></div></div></div><p> The following example shows an Assignment data structure returned by the <a class="link" href="ApiReference_GetAssignmentsForHITOperation.html" title="GetAssignmentsForHIT">GetAssignmentsForHIT</a> operation.
+			The <a class="link" href="ApiReference_GetAssignmentsForHITOperation.html" title="GetAssignmentsForHIT">GetAssignmentsForHIT</a>
+			operaton returns zero or more <em class="parameter"><code>Assignment</code></em> elements for a
+				<span class="guilabel">Reviewable</span> HIT. </p><pre class="programlisting">
+&lt;Assignment&gt;
+  &lt;AssignmentId&gt;123RVWYBAZW00EXAMPLE456RVWYBAZW00EXAMPLE&lt;/AssignmentId&gt;
+  &lt;WorkerId&gt;AZ3456EXAMPLE&lt;/WorkerId&gt;
+  &lt;HITId&gt;123RVWYBAZW00EXAMPLE&lt;/HITId&gt;
+  &lt;AssignmentStatus&gt;Submitted&lt;/AssignmentStatus&gt;
+  &lt;Deadline&gt;2005-12-01T23:59:59Z&lt;/Deadline&gt;
+  &lt;AcceptTime&gt;2005-12-01T12:00:00Z&lt;/AcceptTime&gt;
+  &lt;SubmitTime&gt;2005-12-07T23:59:59Z&lt;/SubmitTime&gt;
+  &lt;Answer&gt;
+    &amp;lt;QuestionFormAnswers&amp;gt;
+      <em class="replaceable"><code>[XML-encoded Answer data]</code></em>
+    &amp;lt;/QuestionFormAnswers&amp;gt;
+  &lt;/Answer&gt;
+&lt;/Assignment&gt;
+    </pre></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" cellspacing="0" cellpadding="2"><tr><td width="30%" align="left"><a accesskey="p" href="ApiReference_DataStructuresArticle.html"><img src="images/prev.gif" alt="Prev"></a> </td><td width="40%" align="center"><a href="http://survey.amazonwebservices.com/survey/s?s=559&amp;opdata_page=Mturk_API_2008-08-02_ApiReference_AssignmentDataStructureArticle">Documentation Feedback</a><br><a href="copyrightinfo.html">Copyright Information</a></td><td width="30%" align="right"> <a accesskey="n" href="ApiReference_HITDataStructureArticle.html"><img src="images/next.gif" alt="Next"></a></td></tr><tr><td width="30%" align="left" valign="top">&nbsp;</td><td width="40%" align="center"><a accesskey="h" href="#top"><img src="images/home.gif" alt="Home"></a></td><td width="30%" align="right" valign="top">&nbsp;</td></tr></table></div></body></html>