RelatedItems レスポンスグループ

RelatedItemsレスポンスグループは、 ItemLookup リクエストで指定した商品に関連する商品を返します。関連商品としては、個別に販売されている TV シーズンの全ての Unbox エピソードや、MP3アルバムの全ての MP3Download 曲目などが考えられます。

RelatedItemsで返されるデータは、ASIN と ItemAttributes に限られます。これは、他のデータを返す Large などのレスポンスグループを追加指定した場合にも当てはまります。

商品間の関係は一方向です。ある商品が親になり、別の商品が子になります。ただし、ある関連タイプに対し、商品に複数の子や親が存在する場合があります。

商品の関連付けは、RelationshipType パラメータで指定します。このパラメータは、RelatedItems レスポンスグループを使用する場合に必要です。値の例としては、Episode、Season、Tracks、Variation などがあります。全ての関連タイプの一覧については、 ItemLookup をご参照ください。

通常、関連タイプは、関連の子商品の名前を使って命名されます。例えば、MP3 の曲目が MP3 アルバムに関連する場合、関連のタイプは Track になります。この関連では、アルバムが親になります。MP3 の曲目に対して ItemLookup を実行し、RelatedItemsをリクエストする際に Tracks を RelationshipType として使用すると、その曲目の親要素であるアルバムが返されます。逆に、Tracksを RelationshipType として使用してアルバムを検索すると、そのアルバム上の曲目のリストが返されます。

ItemLookup リクエストは、最大で10個の関連商品を返します。追加の商品を返すには、RelatedItemsPage パラメータを使用します。例えば、値に2を指定すると、10個ずつひとまとまりとした場合の2番目の関連商品を返します。

関連オペレーション

このレスポンスグループを使用できるオペレーションは以下の通りです:

レスポンス要素

以下の要素がRelatedItems では返されます:

RelatedItemsは、全てのレスポンスグループが返す要素も返します。詳細については、全てのレスポンスグループに共通のレスポンス要素をご参照ください。

親レスポンスグループ

次のレスポンスグループは、 RelatedItems の親レスポンスグループです。

  • なし

子レスポンスグループ

次のレスポンスグループは、RelatedItems の子レスポンスグループです。

  • なし

REST 利用例

次のリクエストを使用して、RelatedItems によって返される XML レスポンス要素を説明しています。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=ItemLookup&
RelationshipType=Tracks&
ItemId=B0013D8EQK&
ItemType=ASIN&
ResponseGroup=RelatedItems,Small&
Version=2008-08-19

レスポンス例

次のレスポンス例は、RelatedItems で返される要素をまとめたものです。

<Item>
  <ASIN>B0013D8EQK</ASIN>
  <DetailPageURL>http://www.amazon.com/gp/redirect.html%3FASIN=B0013D8EQK%26tag=<AssociateTag>XXXX3FSubscriptionId=[AWS Access Key ID]&
</DetailPageURL>
  <ItemAttributes>
    <Creator Role="Primary Contributor">Johnny Cash</Creator>
    <Manufacturer>Columbia/Legacy</Manufacturer>
    <ProductGroup>Digital Music Album</ProductGroup>
    <Title>At San Quentin</Title>
  </ItemAttributes>
  <RelatedItems>
    <Relationship>Children</Relationship>
    <RelationshipType>Tracks</RelationshipType>
    <RelatedItemCount>31</RelatedItemCount>
    <RelatedItemPageCount>4</RelatedItemPageCount>
    <RelatedItemPage>1</RelatedItemPage>
    <RelatedItem>
      <Item>
        <ASIN>B0013D4KJK</ASIN>
        <ItemAttributes>
          <Creator Role="Primary Contributor">Johnny Cash</Creator>
          <Manufacturer>Columbia/Legacy</Manufacturer>
          <ProductGroup>Digital Music Track</ProductGroup>
          <Title>The Long Black Veil/Give My Love To Rose (Live)</Title>
        </ItemAttributes>
      </Item>
    </RelatedItem>
    <RelatedItem>
      <Item>
        <ASIN>B0013D7VG4</ASIN>
        <ItemAttributes>
          <Creator Role="Primary Contributor">Johnny Cash</Creator>
          <Manufacturer>Columbia/Legacy</Manufacturer>
          <ProductGroup>Digital Music Track</ProductGroup>
          <Title>Folsom Prison Blues (Live)</Title>
        </ItemAttributes>
      </Item>
    </RelatedItem>
    ...
  </RelatedItems>
</Item>