The following figure shows how two simple requests can be combined into one batch request.
The new syntax introduced in the batch request centers on the ways in which the operation parameters
are defined. Either the parameter values are different or they are shared between the simple requests in
the batch request.
Batch requests can contain up to two sets of parameters.
Note
The Product Advertising API supports
ItemLookup
batch requests only when the
ItemType
is
an EAN (European Article Number), ISBN (International Standard Book Number), EISBN
(Electronic International Standard Book Number), or ASIN (Amazon Standard Item Number ).
Parameters That Differ
Parameters that differ between the simple requests in a batch request are identified by a reference number.
The following parameter declaration syntax shows where the reference number goes.
OperationName.ReferenceNumber.Parameter=Value
The following request snippet shows an example of a reference number, 1.
ItemLookup.1.ItemId=0976925524
The
ReferenceNumber
is a positive integer that associates the parameters in the simple request. For
example, the following parameters are part of the same simple request because they use the same
reference number.
ItemLookup.1.ItemId=0976925524&
ItemLookup.1.ResponseGroup=Images
These parameters might be different from a second simple request, which is part of the same batch
request.
ItemLookup.2.ItemId=0485935524&
ItemLookup.2.ResponseGroup=Collections
So, if the previous two request snippets were part of one batch request, the
ItemLookup
operation would
be executed twice, each time with a different
ItemId
and
ResponseGroup
.
API Version 2011-08-01
73
Product Advertising API Developer Guide
Batch Requests
