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翻訳経由でブラウズするようであれば、以下リンクから日本語ブラウズができます。
この場合、変数名も翻訳されて逆に読みにくいかもしれませんけど。
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は、次の応答グループの結果を返す親応答グループです。 |
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は、次の応答グループの結果を返す親応答グループです。 |
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 |
RelatedItems | ItemLookup ItemSearch |
ItemAttributes / RelatedItems | RelatedItemsレスポンスグループは、ItemLookupリクエストで指定されたアイテムに関連するアイテムを返します。たとえば、関連アイテムは、別個に販売されているTV季節のすべてのUnboxエピソード、またはMP3アルバムのMP3Downloadトラックのすべてである可能性があります。
RelatedItemsで返されるデータは、ASINおよびItemAttributesに制限されています。これは、その他の場合は追加のデータを返すような、応答グループ(Largeなど)を追加しても同じです。 項目間の関係は単方向です。 1つは親、もう1つは子供です。ただし、項目は、特定の関係タイプに対して複数の子または複数の親を持つことができます。 項目が関連する方法は、RelationshipTypeパラメーターで指定します。このパラメーターは、RelatedItems応答グループを使用する場合に必要です。一部の値には、エピソード、シーズン、トラック、バリエーションが含まれます。すべてのリレーションシップタイプのリストについては、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」に含まれているかを調べて、
カンマ区切りで指定するといいでしょう。
商品ページからの取得例を一発でコードに変換するのは実は一発操作
実は、こうしたパラメータを考えるのは地味に面倒で、
目的が商品ページ程度なら、サンプルソース(スニペット)は、
Webで一回の操作で自動的に生成してくれる機能があります。
以下でご紹介していますので、ご参考になれば幸いです。
当サイト内のコンテンツおよび画像を含むすべてにおいて、管理人が著作権を保持しております。
当サイトでご紹介しております写真につきましては著作権の放棄はしませんが、
ライセンスフリーでご利用いただいて構いません。
コンテンツを有益であると感じていただけましたら非常に光栄です。
ありがとうございます。
サイト内コンテンツを引用される際には、出典元として当サイト(個別記事)へのリンクをお願いいたします。
申し訳ございませんが、無断転載、複製をお断りさせて頂いております。
公開日:
最終更新日:2018/08/26