TagLookup

[重要] 重要

利用率低下により、このオペレーションおよび関連レスポンスグループは2010年07月25日をもってサポート終了となっておりますので、ご利用にならないようご注意ください。

説明

TagLookup オペレーションは、指定した1~5個のタグを基準にしてエンティティを返します。タグは、Amazon リテール Web サイトのエンティティにカスタマーが設定する説明用ラベルのようなものです。エンティティとは、出品されている商品、リストマニアリスト、ガイドなどです。例えば、あるエンティティに "BestCookbook" というタグを設定します。詳細については、 Tags をご参照ください。

タグ関連のレスポンスグループでは、Tags とTagSummary で返される情報量を指定します。その他のタグ関連のレスポンスグループ TaggedGuides、TaggedItems、TaggedListmaniaLists は、タグが設定されているエンティティの種類を指定します。

利用可能なサイト

US のみ

リクエストパラメータ

名前説明必須
Count

タグごとに返されるタグが設定されたエンティティの数。デフォルトは5、最大値は20です

タイプ: 整数

タイプ: 文字列

デフォルト: 5

いいえ
CustomerId

カスタマーを一意に識別する半角英数字の文字列。このパラメータを指定すると、特定のカスタマーが設定したタグだけを返します。

タイプ: 文字列

デフォルト: なし

有効な値: 文字列

いいえ
Item商品を説明する多くの属性のコンテナ。このパラメータは、SOAPリクエストでのみ有効です。

制約事項: SOAPリクエスト専用

制約事項
Items1つ以上の Item オブジェクトのコンテナ。このパラメータは、SOAPリクエストでのみ有効です。

制約事項: SOAPリクエスト専用

制約事項
TagPage

返される結果のページを指定します。各ページに20件の結果が表示されます。

タイプ: 整数

タイプ: 文字列

デフォルト: なし

いいえ
TagName

カンマ区切りのタグ名のリストです。1回のリクエストで5個まで指定できます。

タイプ: 文字列

タイプ: 文字列

デフォルト: なし

はい
TagSort

結果の並べ替え順序を指定します。

タイプ: 文字列

デフォルト: - Usages

有効な値:

  • FirstUsed-商品が最初に使用された日付を基準に並べ替え

  • - FirstUsed-商品が最後に使用された日付を基準に並べ替え

  • LastUsed-商品が最後に使用された日付を基準に並べ替え

    - LastUsed

  • Name-アルファベットのAからZの順

  • - Name-アルファベットのZからAの順

  • Usages-商品の使用頻度が低い順

商品を降順に並べ替えるには、値の先頭にマイナス記号(-)を付けます。

いいえ
ResponseGroup

返される値の種類を指定します。1つのリクエストに複数のレスポンスグループをカンマで区切って指定できます。

タイプ: 文字列

デフォルト: Request | TagsSummary | TaggedItems

有効な値: EditorialReview | ItemAttributes | ItemIds | Large | Medium | Small | TaggedGuides | TaggedListmaniaLists | Tags |

いいえ

TagLookup には、全てのオペレーションで使用できるパラメータを指定できます。詳細については、共通のリクエストパラメータをご参照ください。

レスポンス

名前説明
ASIN商品を識別する半角英数字の文字列。
カスタマーID カスタマーを一意に識別する半角英数字の文字列。
DistinctUsersエンティティのタグを作成した異なるユーザーの数。
FirstTagging初めてエンティティにタグを設定したときの関連情報のコンテナ。
Item商品に関する情報のコンテナ。
LastTagging最後にエンティティにタグを設定したときの関連情報のコンテナ。
NameTag名。
TagTag に関連した情報のコンテナ。
TaggedItemsItem や DistinctUsers などの Tag 要素のコンテナ。
TagNameタグの名前。
Tags全ての Tag 要素のコンテナ。
TagTypeタグが付けられたエンティティの説明 (Itemsなど)。
Timeエンティティにタグ付けされた時刻。
TotalUsagesタグのアクセス回数。
UserIdカスタマーIDと同じ。

これらのタグの親要素に関する詳細については、レスポンスグループの該当するレスポンスグループをご参照ください。

特定のカスタマーによってタグ付けされた商品を検索します。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[アクセスキー ID]&
AssociateTag=[Associate Tag]&
Operation=TagLookup&
ItemId=0545010225&
ResponseGroup=Tags&
Marketplace=us&
Version=2008-08-19&
TagName=tai&
CustomerId=[カスタマーID]

このリクエストに対するレスポンスをレスポンス例に示します。

レスポンス例

次に示すのは、上の例の最初のリクエストで返されるレスポンスの一部です。

<Tag>
  <Name>tai</Name> 
  <TagType>Items</TagType> 
  <DistinctItems>1</DistinctItems> 
  <DistinctUsers>1</DistinctUsers> 
  <TotalUsages>1</TotalUsages> 
  <FirstTagging>
    <EntityId>B00005A1UV</EntityId> 
    <UserId>A2ELLA3OQ06A6Z</UserId> 
    <Time>2005-12-07 14:41:52</Time> 
  </FirstTagging>
  <LastTagging>
    <EntityId>B00005A1UV</EntityId> 
    <UserId>A2ELLA3OQ06A6Z</UserId> 
    <Time>2005-12-07 14:41:52</Time> 
  </LastTagging>
  <TaggedItems>
    <Item>
      <ASIN>B00005A1UV</ASIN> 
    </Item>
  </TaggedItems>
</Tag>

関連オペレーション

  • Tags および TagSummary レスポンスグループを使用した ItemLookup

  • Tags および TagSummary レスポンスグループを使用した ItemSearch