Prev		Next

Collections Response Group

For every item returned in a response, the items associated with it are also returned if the Collections response group is used in the request. Items in collections are related thematically. For example, all of the linens that go into a bedroom might be associated in a bedding collection. The Collections response group returns the ASINs and titles of the items in a collection.

For more information, see Displaying Collections.

If an item is part of a collection and that item is returned in a response, all of the other items in the collection are also returned if the request contains the Collections response group.

Relevant Operations

Operations that can use this response group include:

ItemLookup
ItemSearch

Response Elements

The following table describes and shows the parentage of the elements returned by Collections. The elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.

Response Element	Ancestry	Definition
`ASIN`	Collections/Collection/CollectionParent Collections/Collection/CollectionItem	The ASIN of the parent or child item, respectively. An ASIN is an alphanumeric token that uniquely identifies an item.
`Collection`	Collections	A container for one CollectionParent and one or more CollectionItems.
`CollectionItem`	Collections/Collection/	An item in a collection, which is specified by its ASIN and Title. In a collection, there is one CollectionParent and one or more CollectionItems.
`CollectionParent`	Collections/Collection/	An item that characterizes all of the items in a collection. In a collection, there is one CollectionParent and one or more CollectionItems.
`Collections`		Container for one or more Collection elements.
`Title`	Collections/Collection/CollectionParent Collections/Collection/CollectionItem	The title of the parent or child item, respectively.

Parent Response Group

The following response groups are parent response groups of Collections.

None

Child Response Group

The following response groups are children response groups of Collections.

None

Sample REST Use Case

The folllowing request was used to illustrate the XML response elements returned by Collections.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKey=[AWS Access Key]&
Operation=ItemLookup&
ItemId=B000ALMQ9C&
ResponseGroup=ItemIds,Collections&
Version=2006-09-13

Sample Response Snippet

The following response snippet shows the elements returned by Collections.

<Collections>
  <Collection>
    <CollectionParent>
      <ASIN>B0006PLAOE</ASIN> 
      <Title>Fieldcrest® Classic Bedding Collection GarnetIvory</Title> 
    </CollectionParent>
    <CollectionItem>
      <ASIN>B00067IV8U</ASIN> 
      <Title>Fieldcrest® Classic Solid Sheets Garnet</Title> 
    </CollectionItem>
    <CollectionItem>
      <ASIN>B000673NE2</ASIN> 
      <Title>Fieldcrest® Classic Solid Pillowcases Set of 2 Garnet</Title> 
    </CollectionItem>
    <CollectionItem>
      <ASIN>B00065WTJY</ASIN> 
      <Title>Fieldcrest® Classic Dobby Pillowcases Set of 2 Garnet</Title> 
    </CollectionItem>
  </Collection>
</Collections>