Zend_Service_Amazon は Amazon ウェブサービスを使用するためのシンプルな API です。 Zend_Service_Amazon は、ふたつの API を実装しています。 Amazon 自身の API に従った伝統的な API と、 複雑な検索クエリを簡単に作成するためのシンプルな「クエリ API」です。

Zend_Service_Amazon を使用すると、開発者が Amazon Web Services API を直接使用して、Amazon.com の情報を取得できるようになります。 取得できる情報には以下のようなものがあります。

• 商品の情報、例えば画像や説明や価格など

• カスタマーレビュー

• 似た製品やアクセサリの情報

• Amazon.com のおすすめ

• リストマニアのリスト

Zend_Service_Amazon を使用するには、 Amazon デベロッパ API キーが必要です。このキーを取得するには、 » Amazon Web Services のウェブサイトを参照ください。

注意: 注意
Amazon デベロッパ API キーは Amazon のアカウントと関連付けられます。 取得した API キーは自分自身でのみ使用するようにしましょう。

<?php
require_once 'Zend/Service/Amazon.php';
$amazon = new Zend_Service_Amazon('AMAZON_API_KEY');
$results = $amazon->itemSearch(array('SearchIndex' => 'Books', 'Keywords' => 'php'));
foreach ($results as $result) {
    echo $result->Title . '<br />';
}
            

<?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 番目のパラメータとして、適切な国コード文字列を指定するだけです。

<?php
// 日本の Amazon に接続します
require_once 'Zend/Service/Amazon.php';
$amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'JP');
            

注意: 国コード
使用できる国コードは CA、DE、FR、JP、 UK および US です。

ASIN がわかっている場合は、itemLookup() メソッドを使用すると Amazon の商品を検索できます。

<?php
require_once 'Zend/Service/Amazon.php';
$amazon = new Zend_Service_Amazon('AMAZON_API_KEY');
$item = $amazon->itemLookup('B0000A432X');
            

itemLookup() メソッドにオプションの第 2 パラメータを渡すことで、 検索オプションを指定できます。使用可能なオプションを含む詳細は、 » 関連する Amazon の文書 を参照ください。

注意: 画像の情報
検索結果の画像情報を取得するには、オプション ResponseGroup を Medium あるいは Large に設定しなければなりません。

さまざまな条件指定による商品検索を行うには itemSearch() メソッドを使用します。 以下に例を示します。

<?php
require_once 'Zend/Service/Amazon.php';
$amazon = new Zend_Service_Amazon('AMAZON_API_KEY');
$results = $amazon->itemSearch(array('SearchIndex' => 'Books', 'Keywords' => 'php'));
foreach ($results as $result) {
    echo $result->Title . '<br />';
}
            

<?php
require_once 'Zend/Service/Amazon.php';
$amazon = new Zend_Service_Amazon('AMAZON_API_KEY');
$results = $amazon->itemSearch(array(
    'SearchIndex'   => 'Books',
    'Keywords'      => 'php',
    'ResponseGroup' => 'Small,ItemAttributes,Images,SalesRank,Reviews,EditorialReview,Similarities,ListmaniaLists'
    ));
foreach ($results as $result) {
    echo $result->Title . '<br />';
}
            

itemSearch() は配列のパラメータをひとつ受け取り、 このパラメータで検索オプションを指定します。使用可能なオプションを含む詳細は、 » 関連する Amazon の文書 を参照ください。

以下のクラスは、すべて Zend_Service_Amazon::itemLookup() および Zend_Service_Amazon::itemSearch() から返されるものです。

• Zend_Service_Amazon_Item

• Zend_Service_Amazon_Image

• Zend_Service_Amazon_ResultSet

• Zend_Service_Amazon_OfferSet

• Zend_Service_Amazon_Offer

• Zend_Service_Amazon_SimilarProduct

• Zend_Service_Amazon_Accessories

• Zend_Service_Amazon_CustomerReview

• Zend_Service_Amazon_EditorialReview

• Zend_Service_Amazon_ListMania