Zend_Service_Amazon
は Amazon ウェブサービスを使用するためのシンプルな
API です。
Zend_Service_Amazon
は 2 つの API を実装しています。
Amazon 自身の API に従った伝統的な API と、
複雑な検索クエリを簡単に作成するためのシンプルな「クエリ API」です。
Zend_Service_Amazon
を使用すると、開発者が
Amazon Web Services API を直接使用して、Amazon.com
の情報を取得できるようになります。
取得できる情報には以下のようなものがあります。
Zend_Service_Amazon
を使用するには、
Amazon デベロッパ API キーが必要です。このキーを取得するには、
Amazon Web Services
のウェブサイトを参照ください。
注意 | |
---|---|
Amazon デベロッパ API キーは Amazon のアカウントと関連付けられます。 取得した API キーは自分自身でのみ使用するようにしましょう。 |
例 15.2. 伝統的な API を使用した Amazon 検索
この例では、Amazon で PHP に関する書籍を検索し、 結果の一覧を表示します。
<?php require_once 'Zend/Service/Amazon.php'; $amazon = new Zend_Service_Amazon('AMAZON_API_KEY&'); $response = $amazon->itemSearch(array('SearchIndex' => 'Books', 'Keywords' => 'php')); foreach ($response as $r) { echo $r->Title .'<br />'; } ?>
例 15.3. クエリ API を使用した Amazon 検索
ここでも Amazon で PHP に関する書籍を検索します。 しかし、ここではクエリ API を使用します。この API は、Fluent Interface パターンと似た形式です。
<?php require_once 'Zend/Service/Amazon/Query.php'; $query = new Zend_Service_Amazon_Query('AMAZON_API_KEY'); $query->category('Books')->Keywords('PHP'); $results = $query->search(); foreach ($results as $result) { echo $result->Title .'<br />'; } ?>
デフォルトでは、Zend_Service_Amazon
は米国 ("US
")
の Amazon Web Service に接続します。他の国のサービスに接続するには、
コンストラクタの 2 番目のパラメータとして、適切な国コード文字列を指定するだけです。
ASIN がわかっている場合は、itemLookup()
メソッドを使用すると Amazon の商品を検索できます。
例 15.5. ASIN を使用した Amazon の商品検索
<?php require_once 'Zend/Service/Amazon.php'; $amazon = new Zend_Service_Amazon('AMAZON_API_KEY'); $item = $amazon->itemLookup('B0000A432X'); ?>
itemLookup()
メソッドにオプションの第 2 パラメータを渡すことで、
検索オプションを指定できます。使用可能なオプションを含む詳細は、
関連する Amazon の文書
を参照ください。
さまざまな条件指定による商品検索を行うには
itemSearch()
メソッドを使用します。
以下に例を示します。
例 15.6. Amazon の商品検索の実行
<?php require_once 'Zend/Service/Amazon.php'; $amazon = new Zend_Service_Amazon('AMAZON_API_KEY'); $response = $amazon->itemSearch(array('SearchIndex' => 'Books', 'Keywords' => 'php')); foreach($response as $r) { echo $r->Title .'<br />'; } ?>
itemSearch()
は配列のパラメータをひとつ受け取り、
このパラメータで検索オプションを指定します。使用可能なオプションを含む詳細は、
関連する Amazon の文書
を参照ください。
ティップ | |
---|---|
Zend_Service_Amazon_Query
クラスを使用すると、これらのメソッドをより簡単に使用できるようになります。
|
Zend_Service_Amazon_Query
は、Amazon Web Service
を使用するためのもうひとつの API を提供します。
この API では Fluent Interface パターンを使用します。
つまり、すべてのコールはメソッド呼び出しを連結した形式になります
(例: $obj->method()->method2($arg)
)。
商品検索の設定を行いやすく、また条件に基づく検索をしやすくするために、
Zend_Service_Amazon_Query
API ではオーバーロードを使用しています。
各オプションの設定はメソッドのコールで行い、メソッドの引数がオプションの値に対応します。
例 15.7. もうひとつのクエリ API を使用した Amazon の検索
この例では、もうひとつのクエリ API のインターフェイスを使用して、 オプションとその値を設定します。
<?php require_once 'Zend/Service/Amazon/Query.php'; $query = new Zend_Service_Amazon_Query('MY_API_KEY'); $query->Category('Books')->Keywords('PHP'); $results = $query->search(); foreach ($results as $result) { echo $result->Title .'<br />'; } ?>
これは、オプション Category
の値を "Books"、
そして Keywords
の値を "PHP" に設定します。
使用可能なオプションについての詳細な情報は、 関連する Amazon の文書 を参照ください。
以下のクラスは、すべて
Zend_Service_Amazon::itemLookup()
および
Zend_Service_Amazon::itemSearch()
から返されるものです。
Zend_Service_Amazon_Item
は、ウェブサービスから返される
Amazon の商品を表すために使用されるクラスです。
商品のタイトル、説明、レビューなどを含むすべての属性を包含します。
Zend_Service_Amazon_Item
が持つプロパティは、
それぞれが標準の Amazon API に直接対応しています。
表 15.1. Zend_Service_Amazon_Item のプロパティ
名前 | 型 | 説明 |
---|---|---|
ASIN | string | Amazon の商品 ID |
DetailPageURL | string | 商品の詳細情報ページの URL |
SalesRank | string | 商品の売上ランキング |
SmallImage | Zend_Service_Amazon_Image | 商品の画像 (小) |
MediumImage | Zend_Service_Amazon_Image | 商品の画像 (中) |
LargeImage | Zend_Service_Amazon_Image | 商品の画像 (大) |
Subjects | array | 商品のテーマ |
Offers |
Zend_Service_Amazon_OfferSet
|
提供内容の概要および商品の提供情報 |
CustomerReviews | array |
Zend_Service_Amazon_CustomerReview
オブジェクトの配列で表されるカスタマーレビュー
|
EditorialReviews | array |
Zend_Service_Amazon_EditorialReview
オブジェクトの配列で表される、出版社/著者からの内容紹介
|
SimilarProducts | array |
Zend_Service_Amazon_SimilarProduct
オブジェクトの配列で表される、似た商品の情報
|
Accessories | array |
Zend_Service_Amazon_Accessories
オブジェクトの配列で表される、関連アクセサリの情報
|
Tracks | array | 音楽 CD や DVD の、トラック番号と曲名の配列 |
ListmaniaLists | array |
Item related Listmania Lists as an array of
Zend_Service_Amazon_ListmainList
オブジェクトの配列で表される、この商品に関連するリストマニアのリスト
|
PromotionalTag | string | 商品の販売促進用のタグ |
Zend_Service_Amazon_Image
は、商品の画像を表します。
Zend_Service_Amazon_ResultSet
オブジェクトは
Zend_Service_Amazon::itemSearch()
から返され、結果が複数返された場合に簡単に処理できるようにします。
注意 | |
---|---|
操作性を高めるため、 |
Each result returned by
Zend_Service_Amazon::itemSearch()
および
Zend_Service_Amazon::itemLookup()
から返される各結果には
Zend_Service_Amazon_OfferSet
オブジェクトが含まれており、
ここから商品の販売情報が取得できます。
表 15.3. Zend_Service_Amazon_OfferSet のプロパティ
名前 | 型 | 説明 |
---|---|---|
LowestNewPrice | int | "新品" の最低価格 |
LowestNewPriceCurrency | string |
LowestNewPrice の通貨単位
|
LowestOldPrice | int | "ユーズド商品" の最低価格 |
LowestOldPriceCurrency | string |
LowestOldPrice の通貨単位
|
TotalNew | int | "新品" の在庫数 |
TotalUsed | int | "ユーズド商品" の在庫数 |
TotalCollectible | int | "コレクター商品" の在庫数 |
TotalRefurbished | int | "refurbished" の在庫数 |
Offers | array |
Zend_Service_Amazon_Offer
オブジェクトの配列
|
商品の個々の販売情報が
Zend_Service_Amazon_Offer
オブジェクトとして返されます。
表 15.4. Zend_Service_Amazon_Offer のプロパティ
名前 | 型 | 説明 |
---|---|---|
MerchantId | string | 出品者の Amazon ID |
GlancePage | string | 出品者の概要が掲載されているページの URL |
Condition | string | 商品のコンディション |
OfferListingId | string | 販売情報リストの ID |
Price | int | 商品の価格 |
CurrencyCode | string | 商品価格の通貨コード |
Availability | string | 商品の在庫状況 |
IsEligibleForSuperSaverShipping | boolean | Super Saver Shipping に対応しているか否か |
商品を検索した際に、Amazon は検索結果の商品と似た商品の一覧も返します。
個々のデータは Zend_Service_Amazon_SimilarProduct
オブジェクトとして返されます。
各オブジェクトに含まれる情報を元にして、 その商品の完全な情報を取得するリクエストを行うことができます。
返される結果の中の「アクセサリ」については
Zend_Service_Amazon_Accessories
オブジェクトで表されます。
カスタマーレビューのデータは
Zend_Service_Amazon_CustomerReview
オブジェクトで返されます。
出版社/著者からの内容紹介は
Zend_Service_Amazon_EditorialReview
オブジェクトで返されます。
リストマニアのリストデータは
Zend_Service_Amazon_Listmania
オブジェクトで返されます。