頑張らない!でも諦めない!必死にならずにええかげん

Amazonアソシエイトの「&ResponseGroup=」パラメータの種類

Amazonアソシエイト(アフィリエイト)ではAPIを利用して、
膨大なAmazonデータベースから商品情報を利用してアフィリエイトを行う事ができますが、
その商品情報から何を取得するのかを制御するのが
「&ResponseGroup=」で指定するパラメータ値です。
このパラメータの使用についてご紹介します。

Amazonアソシエイトの「&ResponseGroup=」パラメータの種類

Amazonアソシエイト(アフィリエイト)でAPI商品情報を取得する場合、
商品情報の「何を」取得するかを選択し指定する必要があります。

それを「&ResponseGroup=」パラメータで指定することが出来ます。

英語ではありますが、ヘルプが充実しているので、
翻訳などを使いながら読み解けば大抵は推測がつくであろう内容です。

このヘルプの存在に行き着くまでに意外と遠回りした感じはありますが。

その後、日本語ヘルプのページがありましたので、追記しておきます。

レスポンスグループ|Product Advertising API(日本語)

Response Groups

Response groups help filter the product information you want returned. Each operation can only use some of the available response groups. Each section includes the following:

  • Description of the response group.
  • Descriptions of the XML elements returned by the response group.
  • The ancestry of the element presented using X-path notation.
  • Child response groups. For example, if you specify the Large response group, the response includes the child response group, ItemAttributes.
  • Parent response groups. For example, the Large response group is a parent of the ItemAttributes response group.

-以下略-

(抜粋引用)Response Groups – Product Advertising API

(G訳)レスポンスグループ

応答グループは、返される製品情報をフィルタリングするのに役立ちます。 各操作では、使用可能な応答グループの一部しか使用できません。 各セクションには以下が含まれます:

応答グループの説明。
応答グループによって返されたXML要素の説明。
要素の祖先は、Xパス表記法を使用して提示されます。
子応答グループ。 たとえば、Large応答グループを指定した場合、応答には子応答グループItemAttributesが含まれます。
親応答グループ。 たとえば、Large応答グループはItemAttributes応答グループの親です。

 

ばっくり、レスポンスグループには親子関係があって、
子は親に包含されて応答が返ってくると説明されていますが、
レスポンスグループと返される応答内容は以下のようになっています。

「Operations」がその「Response Groups」を指定する事ができる事を意味しています。
AmazonAPIで受け取りたい情報は「Response Elements」に表示されている項目で判断できます。

「Description」には様々な注意事項なども書かれていますので、
原文ページの各項目内の記述をご確認をお願いします。

Response Groups – Product Advertising API

Google翻訳経由でブラウズするようであれば、以下リンクから日本語ブラウズができます。
この場合、変数名も翻訳されて逆に読みにくいかもしれませんけど。

https://translate.google.co.jp/translate?sl=en&tl=ja&js=y&prev=_t&hl=ja&ie=UTF-8&u=https%3A%2F%2Fdocs.aws.amazon.com%2Fja_jp%2FAWSECommerceService%2Flatest%2FDG%2FCHAP_ResponseGroupsList.html&edit-text=&act=url

Response Groups Operations Response Elements Description
Accessories SimilarityLookup
ItemLookup
ItemSearch
ASIN / Title / TotalPages / TotalResults アクセサリーレスポンスグループは、最大5つのASINと、レスポンス内のアイテムに関連するアクセサリーのタイトルを返します。 たとえば、カメラのItemLookupを実行し、アクセサリ応答グループをリクエストに含めた場合、レスポンスにはデフォルトでASINに関連付けられているアクセサリのタイトルとASINが含まれます。 カメラのアクセサリには、カメラケース、レンズ、フィルタなどが含まれている場合があります。
AlternateVersions ItemSearch(*1)
ItemLookup(*2)
AlternateVersion / ASIN / Binding / Title AlternateVersionsレスポンスグループは、書籍または音楽タイトルの利用可能なすべてのメディア形式を返します。 サンプル形式には、ペーパーバック、オーディオCD、MP3ダウンロードなどがあります。 このレスポンスグループは、Books、ForeignBooks、KindleStore、MP3Downloads、Musicの各製品カテゴリでのみ動作します。
*1)検索インデックスがMusic、KindleStore、MP3Downloads、またはBooks、または米国以外のロケールの場合はForeignBooks
*2)指定された項目が音楽、本または外国の本の場合。 検索インデックスが指定されている場合、その値はMusic、KindleStore、MP3Downloads、またはBooks、または米国以外のロケールの場合はForeignBooksでなければなりません
BrowseNodeInfo BrowseNodeLookup BrowseNodeId / Name 特定のブラウズノードIDの場合、BrowseNodeInfoレスポンスグループは、ブラウズノード名と、子および親のブラウズノードのIDを返します。

この情報の1つのアプリケーションは、ブラウズノード階層を横断して検索を絞り込む(子ノード)、または検索を一般化する(親ノード)、子および親のブラウズノードを使用することです。 これを行うには、BrowseNodeLookupを1回以上使用します。 検索を絞り込むことで、よりターゲットを絞り込んだ結果を返すことができます。 レスポンスを一般化すると、ブラウズノードが属する商品カテゴリを見つけることができます。

この応答グループは、BrowseNodes応答グループに似ています。 違いは、BrowseNodesレスポンスグループは、ItemSearch、ItemLookup、SimilarityLookupなどのアイテム属性、検索インデックス、リスト、および潜在的に複数のアイテムを返す操作に使用されることです。 BrowseNodeInfoはBrowseNodeLookupでのみ使用でき、検索は常にブラウズノードIDで行われます。

BrowseNodes ItemLookup
ItemSearch
SimilarityLookup
BrowseNodeId / IsCategoryRoot / Name / TotalPages / TotalResults BrowseNodesレスポンスグループは、レスポンスで返されたアイテムに関連付けられたブラウズノード名とIDを返します。 また、レスポンスグループは、レスポンスで返される項目の子および親参照ノードの名前とIDを返します。

1つのアイテムが複数のブラウズノードに属している可能性があるので、1つのアイテムに対して複数のブラウズノードの階層を表示するのが一般的です。

親ASINなどの一部の製品は、BrowsesNodesレスポンスグループの情報を返しません。

この応答グループは、BrowseNodeInfo応答グループに似ています。 違いは、BrowseNodesレスポンスグループは、アイテム属性、検索インデックス、およびリストに基づく操作で使用されることです。 通常、これらの操作では複数の項目が返されます。 BrowseNodeInfoはBrowseNodeLookupでのみ使用でき、検索は常にブラウズノードIDで行われます。

Cart CartAdd
CartCreate
CartModify
CartGet
CartClear
Amount / ASIN / CartId / CartItem / CartItemId / CartItems / CurrencyCode / FormattedPrice / HMAC / ParentASIN / Price / ProductGroup / PurchaseURL / Quantity / SavedForLaterItem / Title / URLEncodedHMAC カートレスポンスグループは、指定されたリモートショッピングカートおよびその中のアイテムに関する情報を提供します。 カートの情報には、
CartId
HMAC
PurchaseURLSavedForLaterItemsを含むカート内の各アイテムについて、レスポンスグループは以下を返します。
CartItemId
ProductName
ASIN
Quantity
ListPrice
OurPrice
CartNewReleases CartAdd
CartCreate
CartModify
CartGet
ASIN / Title CartNewReleasesレスポンスグループは、カート操作で指定されたアイテムのルートカテゴリにある上位5つの新リリースのASINとタイトルを返します。 たとえば、テレビをカートに追加すると、ルートカテゴリであるエレクトロニクスの上位5つの新しいリリースが返されます。

この応答グループを使用して、顧客に追加項目を提案します。

可用性
この応答グループは、米国のロケールでのみ使用できます。

CartTopSellers CartAdd
CartCreate
CartModify
CartGet
ASIN /
Title
CartTopSellersレスポンスグループは、カート操作で指定されたアイテムのルートカテゴリにある上位5位のベストセラーのASINとタイトルを返します。 たとえば、テレビをカートに追加すると、最上位の販売用コンピュータ、MP3プレーヤー、またはカメラなど、ルートカテゴリのトップ5の売り手であるエレクトロニクスが返されます。

この応答グループを使用して、購入する関連アイテムを指定します。

可用性
この応答グループは、米国のロケールでのみ使用できます。

CartSimilarities CartAdd
CartCreate
CartModify
CartGet
ASIN /
OtherCategoriesSimilarProducts /
SimilarProducts /
SimilarViewedProducts /
Title
CartSimilaritiesレスポンスグループは、以下のアイテムのタイトルとASINを返します。

要求で指定された項目に似ています。これらの結果は<SimilarProducts>と<SimilarProduct>のXMLレスポンスでタグ付けされ、小売ウェブサイトの「このアイテムを購入した顧客も購入しました」の下に表示されます。

リクエストで指定されたアイテムを閲覧した顧客からも閲覧されました。これらの結果は、<SimilarViewedProducts>と<SimilarViewedProduct>のXMLレスポンスでタグ付けされ、小売ウェブサイトの “このアイテムを見た顧客も見た顧客”の下に表示されます。

リクエストで指定された項目に類似する他のカテゴリにもあります。これらの結果は、<OtherCategoriesSimilarProducts>と<OtherCategoriesSimilarProduct>というXMLレスポンスでタグ付けされ、小売ウェブサイトの「類似アイテムの探索」という見出しの下に「このアイテムを購入した顧客も購入しました。

このレスポンスグループは、顧客がショッピングカートに追加したものと同様のアイテムを返します。応答グループは、顧客が追加アイテムを購入するよう促すために使用されます。

EditorialReview ItemLookup
ItemSearch
SimilarityLookup
EditorialReviewIsLinkSuppressed /
Source
EditorialReviewレスポンスグループはAmazonのアイテムレビューを返します。レスポンスの各アイテムのProduct Detailページに表示されます。
Images ItemLookup
ItemSearch
SimilarityLookup
Height / LargeImage / MediumImage / SmallImage / SwatchImage / ThumbnailImage / TinyImage / TotalPages / TotalResults / URL / Width Imagesレスポンスグループは、アイテムの3つのサイズ(小、中、大)で利用可能なすべての画像にURLを返します。 たとえば、ブレンダーに4つのイメージがある場合、このレスポンスグループは12イメージのURLを返します。それぞれ4つのイメージが3つのサイズです。

レスポンスグループは、イメージURLを返すだけでなく、各イメージの高さと幅のディメンションを返します。 これらの値を使用して、画像を正しく表示します。

ItemAttributes ItemLookup
ItemSearch
SimilarityLookup
Actor / Artist / AspectRatio / AudienceRating / AudioFormat / Author / Binding / Brand / Category / CEROAgeRating / ClothingSize / Color / Creator / Role / Department / Director / EAN / EANList / EANListElement / Edition / EISBN / EpisodeSequence / ESRBAgeRating / Feature / Format / Genre / HardwarePlatform / HazardousMaterialType / IsAdultProduct / IsAutographed / ISBN / IsEligibleForTradeIn / IsMemorabilia / IssuesPerYear / ItemDimensions / Height / Length / Weight / Width / ItemPartNumber / Label / Languages / Language / Name / Type / AudioFormat / LegalDisclaimer / ListPrice / Manufacturer / ManufacturerMaximumAge / ManufacturerMinimumAge / ManufacturerPartsWarrantyDescription / MediaType / Model / MPN / NumberOfDiscs / NumberOfIssues / NumberOfItems / NumberOfPages / NumberOfTracks / OperatingSystem / PackageQuantity / PartNumber / Platform / ProductGroup / ProductTypeSubcategory / PublicationDate / Publisher / RegionCode / ReleaseDate / RunningTime / SeikodoProductCode / Size / SKU / Studio / SubscriptionLength / Title / TradeInValue / UPC / UPCList / UPCListElement / Warranty / WEEETaxValue ItemAttributesレスポンスグループは、アイテムを記述する潜在的に多数の属性を返します。 たとえば、Camera and Photo検索インデックスの項目は、属性、高さ、幅、重さ、タイトル、UPC、価格、製造元、ズーム率、メガピクセル数、キャリングケースを返します。

すべての検索インデックスは、すべてのアイテム属性を返すことができます。 ただし、返されるアイテム属性の数はASINによって異なります。 通常、同じ検索インデックス内のASINは同じアイテム属性を返します。 たとえば、「Books」検索インデックスの項目に返される項目属性は、「Camera and Photo」検索インデックスの項目に対して返される項目属性とは異なります。 ただし、単一の検索インデックス内の項目は必ずしも同じ属性を返すわけではありません。

ItemIds ItemLookup
ItemSearch
SimilarityLookup
ASIN / CorrectedQuery / Keywords / Message / TotalPages / TotalResults ItemIdsレスポンスグループは、レスポンスに返されるすべてのアイテムのASINを返します。
Large ItemLookup
ItemSearch
SimilarityLookup
Actor / Amount / Artist / ASIN / AspectRatio / AudienceRating / AudioFormat / Author / Binding / Brand / BrowseNodeId / ClothingSize / Color / Creator / CurrencyCode / Department / Director / EAN / Edition / EISBN / ESRBAgeRating / Feature / Format / FormattedPrice / Height / IsAutographed / ISBN / IsMemorabilia / IssuesPerYear / Keywords / Label / LegalDisclaimer / Length / Manufacturer / ManufacturerMaximumAge / ManufacturerMinimumAge / ManufacturerPartsWarrantyDescription / MaterialType / Message / MetalType / Model / MPN / NumberOfDiscs / NumberOfIssues / NumberOfItems / NumberOfPages / NumberOfTracks / Platform / ProductGroup / PublicationDate / Publisher / RegionCode / ReleaseDate / Role / RunningTime / SalesRank / Size / SKU / Source / Studio / SubscriptionLength / Title / TotalCollectible / TotalUsed / TotalNew / TotalPages / TotalRefurbished / TotalResults / Type / UPC / URL / Warranty / Weight / Width Large応答グループは、応答内の項目に関する多くの情報を返します。 Largeレスポンスグループは、デモンストレーション目的のみです。 本番用アプリケーション用ではありません。 アプリケーションでは、必要な応答グループを正確に使用して、待ち時間と応答サイズを削減する必要があります。

Largeは、次の応答グループの結果を返す親応答グループです。
Accessories
BrowseNodes
Medium
Offers
Reviews
Similarities
Tracks

Medium ItemLookup
ItemSearch
SimilarityLookup
Actor / Amount / Artist / ASIN / AspectRatio / AudienceRating / AudioFormat / Author / Binding / Brand / ClothingSize / Color / Creator / CurrencyCode / Department / Director / EAN / Edition / EISBN / ESRBAgeRating / Feature / Format / FormattedPrice / Height / IsAutographed / ISBN / IsMemorabilia / IssuesPerYear / Keywords / Label / LegalDisclaimer / Length / Manufacturer / ManufacturerMaximumAge / ManufacturerMinimumAge / ManufacturerPartWarrantyDescription / MaterialType / Message / MetalType / Model / MPN / NumberOfDiscs / NumberOfIssues / NumberOfItems / NumberOfPages / NumberOfTracks / Platform / ProductGroup / PublicationDate / Publisher / RegionCode / ReleaseDate / Role / RunningTime / SalesRank / Size / SKU / Source / Studio / SubscriptionLength / Title / TotalCollectible / TotalUsed / TotalNew / TotalPages / TotalRefurbished / TotalResults / Type / UPC / URL / Warranty / Weight / Width Medium応答グループは、応答内のアイテムに関する多くの情報を返します。 ミディアムレスポンスグループは、デモンストレーション目的のみです。 本番用アプリケーション用ではありません。 アプリケーションでは、必要な応答グループを正確に使用して、待ち時間と応答サイズを削減する必要があります。

Mediumは、次の応答グループの結果を返す親応答グループです。
EditorialReview
Images
ItemAttributes
OfferSummary
Request
SalesRank
Small

MostGifted BrowseNodeLookup Actors / Artist / ASIN / Authors / ProductGroup / Title MostGiftedレスポンスグループは、指定されたブラウズノード内のギフトとして与えられた10項目のASINとタイトルを返します。
MostWishedFor BrowseNodeLookup Actors / Artist / ASIN / Authors / ProductGroup / Title MostWishedForレスポンスグループは、指定されたブラウズノード内のウィッシュリストで最も人気のある10項目のASINとタイトルを返します。
NewReleases BrowseNodeLookup Actors for the Video search index / Artist for the Music search index / ASIN / Authors for the Books search index / ProductGroup / Title / TopItemSet NewReleasesレスポンスグループは、指定されたブラウズノードに新しくリリースされたアイテムのASINとタイトルを返します。
OfferFull ItemLookup
ItemSearch
SimilarityLookup
Amount / Availability / Condition / CurrencyCode / FormattedPrice / IsEligibleForPrime / IsEligibleForSuperSaverShipping / MoreOffersUrl / Name / OfferListingId / TotalCollectible / TotalNew / TotalOfferPages / TotalOffers / TotalRefurbished / TotalUsed OfferFullレスポンスグループは、オファーに関する包括的な情報を返します。 OfferFullは、オファーレスポンスグループの結果を返す親レスポンスグループです。

注意

この応答グループは、Amazon Kindleデジタルブックでは返されません。 Amazon Kindle ASINは、Binding、Format、およびProductTypeNameレスポンス要素を通じて検証できます。

OfferFullレスポンスグループは、アイテム条件ごとに1つのオファーを返します。 たとえば、New、Used、およびCollectibleの条件で書籍が利用可能な場合、OfferFullリクエストは、New、Used、およびCollectibleの合計3つのオファーを返します。

OfferListings ItemLookup
ItemSearch
SimilarityLookup
Amount / Availability / Code / Condition / CurrencyCode / FormattedPrice / IsEligibleForPrime / IsEligibleForPrimeFreeDigitalVideo / IsEligibleForSuperSaverShipping / MoreOffersUrl / Name / OfferListingId / TotalOfferPages / TotalOffers OfferListings応答グループは、応答で返されたアイテムのOfferListingsを返します。 返される値は、オファーレスポンスグループによって返された値から、OfferSummaryレスポンスグループによって返された値を引いた値に似ています。 OfferListingsは、アイテムがスーパーセーバー出荷に適しているかどうかを指定するIsEligibleForSuperSavingShippingを含む出荷オプションを返します。

注意

この応答グループは、Amazon Kindleデジタルブックでは返されません。 Amazon Kindle ASINは、Binding、Format、およびProductTypeNameレスポンス要素を通じて検証できます。

Offers ItemLookup
ItemSearch
SimilarityLookup
Amount / Availability / Condition / CurrencyCode / FormattedPrice / IsEligibleForPrime / IsEligibleForPrimeFreeDigitalVideo / IsEligibleForSuperSaverShipping / LoyaltyPoints / MoreOffersUrl / Name / OfferListingId / TotalCollectible / TotalNew / TotalOfferPages / TotalOffers / TotalRefurbished / TotalUsed Offers応答グループは、OfferSummary応答グループの内容を返す親応答グループです。 また、デフォルトでオファー情報を返します。 オファーレスポンスグループは、オプションの入力パラメータとしてConditionとMerchantIdを使用できます。 デフォルトでは、顧客が商品をショッピングカートに追加できるようにするアイテムの詳細ページのボックスにリストされているアイテムである、「購入ボックス」受賞者のオファーが返されます。
注意オファー応答グループは、各アイテム条件に対して1つのオファーを返します。 たとえば、New、Used、およびCollectibleの条件で書籍が利用可能な場合、オファーリクエストでは、New、Used、およびCollectibleの合計3つのオファーが返されます。
OfferSummary ItemLookup
ItemSearch
SimilarityLookup
Amount / CurrencyCode / FormattedPrice / TotalCollectible / TotalNew / TotalRefurbished / TotalUsed OfferSummary応答グループは、オファーリストの数とレスポンスの各項目の各条件タイプの最低価格を返します。 条件タイプは、新規、使用済み、コレクティブ、リニューアル済みです。 たとえば、このレスポンスグループは各条件の最低価格を返します。
New item(新商品)
Used item(中古品)
Collectible item(コレクターアイテム)
Refurbished item(リサーチアイテム)
PromotionSummary ItemLookup
ItemSearch
SimilarityLookup
BenefitDescription / Category / EligibilityRequirementDescription / Promotion / PromotionId / Promotions / Summary / TermsAndConditions PromotionSummaryレスポンスグループは、プロモーションの種類、プロモーションID、適格要件、プロモーションの詳細を説明するテキストなど、プロモーションに関する要約情報を返します。

PromotionSummaryは、次のいずれかの応答グループで使用する必要があります。

Large
OfferFull
Offers

RelatedItems ItemLookup
ItemSearch
ItemAttributes / RelatedItems RelatedItemsレスポンスグループは、ItemLookupリクエストで指定されたアイテムに関連するアイテムを返します。たとえば、関連アイテムは、別個に販売されているTV季節のすべてのUnboxエピソード、またはMP3アルバムのMP3Downloadトラックのすべてである可能性があります。

RelatedItemsで返されるデータは、ASINおよびItemAttributesに制限されています。これは、その他の場合は追加のデータを返すような、応答グループ(Largeなど)を追加しても同じです。

項目間の関係は単方向です。 1つは親、もう1つは子供です。ただし、項目は、特定の関係タイプに対して複数の子または複数の親を持つことができます。

項目が関連する方法は、RelationshipTypeパラメーターで指定します。このパラメーターは、R​​elatedItems応答グループを使用する場合に必要です。一部の値には、エピソード、シーズン、トラック、バリエーションが含まれます。すべてのリレーションシップタイプのリストについては、ItemLookupページを参照してください。

リレーションシップタイプは、通常、リレーションシップの子アイテムの名前に基づいて命名されます。例えば、MP3トラックはMP3アルバムに関連し、関係のタイプはトラックである。この関係では、アルバムは親です。 MP3トラックのItemLookupを行い、RelationshipTypeとしてトラックを使用してRelatedItemsをリクエストした場合、そのトラックの親アルバム(または複数のアルバム)を受け取ります。逆に、TracksをRelationshipTypeとして使用してアルバムを検索すると、そのアルバムのトラックのリストが返されます。

各ItemLookupリクエストは、最大でも10個の関連項目を返すことができます。追加アイテムを返すには、RelateditemsPageパラメーターを使用します。たとえば、2という値は、10の関連項目の2番目のセットを返します。

Request この応答グループを使用できる操作には、次のものがあります。

すべてのProduct Advertising API操作では、デフォルトで要求応答グループが使用されます。

Code / IsValid / Message / Name / RequestId / UserAgent 要求応答グループは、要求で送信されたすべてのパラメーターとその値を戻します。 この情報を使用して、要求をデバッグします。

すべてのProduct Advertising API操作は、デフォルトでこの応答グループを返します。 各リクエストには最大10個のパラメータがあります。

Reviews ItemLookup
ItemSearch
SimilarityLookup
IFrameURL レビュー応答グループは、顧客のレビューを含むiframeにURLを返します。 任意のWebページにiframeを埋め込んで、応答内容を表示することができます。 要求にはiframe URLのみが返されます。

重要

各iframe URLは24時間有効です。 iframeのURLが期限切れになると、403 Forbiddenエラーコードが表示されます。
レビューの詳細については、カスタマーレビューの取得を参照してください。

各顧客のレビューには、次の内容が含まれます。

評価
概要
レビューの日付
レビューのテキスト

SalesRank ItemLookup
ItemSearch
SimilarityLookup
ASIN / SalesRank / TotalPages / TotalResults SalesRank応答グループは、応答内の各アイテムの売上ランクを返します。 1つは最高の評価ですが、大きい数字は商品が人気がないことを意味します。 販売ランクは検索インデックスごとにあるため、1つのレスポンスに複数のアイテムを同じランクにすることは可能です。
SearchBins ItemSearch BinItemCount / BinName / Name / SearchBinSets SearchBinsレスポンスグループは、ItemSearchによって返されたアイテムをビンにグループ化します。 たとえば、ビンのセットは、製品の価格帯のセットとすることができます。 女性の靴の場合、$ 0〜$ 50の靴のASINを返すビン、$ 50〜$ 100の靴の第二のビン、$ 100を超える靴の第三のビンがあります。 アイテムがビンに分割される基準は、SearchBinSetタグのNarrowBy属性によって指定されます。 検索を絞り込むには、NarrowBy値を使用して繰り返し要求を行います。

ItemSearchは結果の最初の25個のビンを返します。

検索ビンの詳細については、「検索ビンを使用したアイテムの検索」を参照してください。
可用性
米国のロケールのみ。

Similarities ItemLookup
ItemSearch
SimilarityLookup
ASIN / Title / TotalPages / TotalResults Similaritiesレスポンスグループは、リクエストで指定されたアイテムに類似する5つのアイテムのタイトルとASINを返します。 このレスポンスグループは、ItemLookupでよく使用されます。
Small ItemLookup
ItemSearch
SimilarityLookup
Actor / Artist / ASIN / Author / CorrectedQuery / Creator / Director / Keywords / Manufacturer / Message / ProductGroup / Role / Title / TotalPages / TotalResults Smallレスポンスグループは、レスポンス内の各アイテムに関する基本情報を返します。 情報には、アイテムのASIN、タイトル、製品グループ、および著者が含まれます。

この応答グループは、ItemLookup、ItemSearch、またはSimilarityLookupとともに、レスポンス内の項目に関する基本情報を返すためによく使用されます。

TopSellers BrowseNodeLookup Actor for the Video search index / Artist for the Music search index / ASIN / Authors for the Books search index / ProductGroup / Title / TopItemSet TopSellersレスポンスグループは、指定されたブラウズノード内の10のベストセラーのASINとタイトルを返します。
Tracks ItemLookup
ItemSearch
SimilarityLookup
Number / TotalPages / TotalResults / Track トラック応答グループは、応答内の各CDの各トラックのタイトルと番号を返します。 たとえば、ItemLookupを使用して、指定されたCDに関するトラック情報を返すことができます。
Variations ItemLookup
ItemSearch
SimilarityLookup
Amount / ASIN / CurrencyCode / FormattedPrice バリエーションレスポンスグループは、VariationSummaryレスポンスグループの内容と、レスポンスのバリエーションごとのアイテム属性、クーポン、オファーリストなどのバリエーションの詳細を返す親レスポンスグループです。
VariationImages ItemLookup Height / LargeImage / MediumImage / SmallImage / SwatchImage / ThumbnailImage / TinyImage / URL / Width VariationImagesレスポンスグループは、同じアイテムの異なる画像バリエーションを4つのサイズ(小、中、大、およびスウォッチ)で表示します。 スウォッチ画像は最小サイズです。 VariationImagesは、販売する商品のバリエーションがある場合に使用されます。 たとえば、販売するシャツは4色で表示されます。 VariationImagesがレスポンスグループとして使用されている場合、シャツは4つの画像サイズの4つの画像サイズで表示されます。

親ASINには必ずしも関連する画像がありません。 子どもたちはイメージを持っているはずです。

VariationMatrix ItemLookup
ItemSearch
ClothingSize / Color / HardwarePlatform / ItemDimensions/Length / ItemDimensions/Width / MaterialType / MetalType / Model / OperatingSystem / PackageQuantity / ProductTypeSubcategory / Size / VariationDimension VariationMatrixレスポンスグループは、指定された親ASINの各ディメンションのディメンション名と各子ASINの値を返します。 返される項目にバリエーションがない場合、VariationMatrixレスポンスグループはデータを返しません。 たとえば、リングはリングサイズによって異なります。 したがって、RingSizeはこのアイテムに関連するディメンションです。 VariationMatrixレスポンスグループは、この例では<RingSize>要素のみを返します。 返されたアイテムにバリエーションがない場合、VariationMatrixレスポンスグループは何も返しません。 詳細については、「変動ディメンション情報の返却」を参照してください。
VariationOffers ItemLookup
ItemSearch
Amount / ASIN / Availability / AvailabilityAttributes / Condition / CurrencyCode / FormattedPrice / IsEligibleForSuperSaverShipping / LoyaltyPoints / MaximumHours / MinimumHours / Name / OfferListingId / TotalCollectible / TotalNew / TotalOfferPages / TotalOffers VariationOffersレスポンスグループは、親ASINの子のオファーを取得します。 VariationOffersはVariationsレスポンスグループに似ています。 ただし、個々のバリエーションについてアイテム属性は返されません。 VariationsはVariationOffersの親応答グループです。

MerchantIdの有効な値は、AmazonとAll(デフォルト値)のみです。 下位互換性を保つため、オファーレスポンスグループは、特典または特集バイヤボックス受賞者のMerchantID値をデフォルト値(All)として扱います。

次の表は、対応するMerchantId入力パラメータの親および子バリエーションオファーの予想される動作を示しています。

VariationSummary Amount / CurrencyCode / FormattedPrice VariationSummaryレスポンスグループは、応答内のすべての子ASINの最低価格、最高価格、最低販売価格、最高販売価格を提供します。

親ASINにはオファーはありませんが、子どもたちは行います。 たとえば、シャツ(親ASIN)を購入することはできませんが、特定の色とサイズ(子供ASIN)のシャツを購入することができます。

 

今回私は、Amazon商品ページの代表以外の画像(2番目以降の画像)を
取得したいと言う目的で調べ始めたのですが、

手っ取り早い「Response Groups」指定は「Large」だと思っていました。
しかし「Large」や「Medium」はプロ―モーション用で本番用ではないと書かれています。

となると「Images」辺りを採用することになるかなと思います。

AmazonAPIのサンプルで「Response Groups」を複数指定している例では、

&ResponseGroup=ItemAttributes,Offers,Images,Reviews

 

の、ように指定し、代替イメージや商品の詳細情報を取得するように指定しています。

必要な情報がどの「Response Group」に含まれているかを調べて、
カンマ区切りで指定するといいでしょう。

 

プロモーション(btm)

Google or AdMax Promotion (it)

商品ページからの取得例を一発でコードに変換するのは実は一発操作

実は、こうしたパラメータを考えるのは地味に面倒で、
目的が商品ページ程度なら、サンプルソース(スニペット)は、
Webで一回の操作で自動的に生成してくれる機能があります。

以下でご紹介していますので、ご参考になれば幸いです。

 


公開日:
最終更新日:2018/08/26

最後までお読みいただきありがとうございました。

ページ
すべて展開 | すべて省略

Rakuten Promotion

ブログ記事のご紹介
すべて展開 | すべて省略