ExtendHIT | R Documentation |
Extend the time remaining on a HIT or the number of assignments available for the HIT.
ExtendHIT(
hit = NULL,
hit.type = NULL,
annotation = NULL,
add.assignments = NULL,
add.seconds = NULL,
unique.request.token = NULL,
verbose = getOption("pyMTurkR.verbose", TRUE)
)
hit |
An optional character string containing a HITId or a vector of
character strings containing multiple HITIds. Must specify |
hit.type |
An optional character string containing a HITTypeId (or a
vector of HITTypeIds). Must specify |
annotation |
An optional character string specifying the value of the
|
add.assignments |
An optional character string containing the number of assignments to add to the HIT. Must be between 1 and 1000000000. |
add.seconds |
An optional character string containing the amount of
time to extend the HIT, in seconds (for example, returned by
|
unique.request.token |
An optional character string, included only for advanced users. |
verbose |
Optionally print the results of the API request to the
standard output. Default is taken from |
A useful function for adding time and/or additional assignments to a HIT. If the HIT is already expired, this reactivates the HIT for the specified amount of time. If all assignments have already been submitted, this reactivates the HIT with the specified number of assignments and previously specified expiration. Must specify a HITId xor a HITTypeId. If multiple HITs or a HITTypeId are specified, each HIT is extended by the specified amount.
extend()
is an alias.
A data frame containing the HITId, assignment increment, time increment, and whether each extension request was valid.
Tyler Burleigh, Thomas J. Leeper
API Reference: Update Expiration API Reference: Create Additional Assignments for HIT
## Not run:
a <- GenerateExternalQuestion("https://www.example.com/","400")
hit1 <- CreateHIT(title = "Example",
description = "Simple Example HIT",
reward = ".01",
expiration = seconds(days = 4),
duration = seconds(hours = 1),
keywords = "example",
question = a$string)
# add assignments
ExtendHIT(hit = hit1$HITId, add.assignments = "20")
# add time
ExtendHIT(hit = hit1$HITId, add.seconds = seconds(days=1))
# add assignments and time
ExtendHIT(hit = hit1$HITId, add.assignments = "20", add.seconds = seconds(days=1))
# cleanup
DisableHIT(hit = hit1$HITId)
## End(Not run)
## Not run:
# Extend all HITs of a given batch from the RUI
ExtendHIT(annotation="BatchId:78382;", add.assignments = "20")
## End(Not run)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.