Zend_Service_Amazon(日本語)導入Zend_Service_Amazon は Amazon ウェブサービスを使用するためのシンプルな API です。 Zend_Service_Amazon は、ふたつの API を実装しています。 Amazon 自身の API に従った伝統的な API と、 複雑な検索クエリを簡単に作成するためのシンプルな「クエリ API」です。 Zend_Service_Amazon を使用すると、開発者が Amazon Web Services API を直接使用して、Amazon.com の情報を取得できるようになります。 取得できる情報には以下のようなものがあります。
Zend_Service_Amazon を使用するには、 Amazon デベロッパ API キーとシークレットキーが必要です。 このキーを取得するには、 » Amazon Web Services のウェブサイトを参照ください。 2009年8月15日以降、Amazon Product Advertising API を Zend_Service_Amazon で使うにはシークレットキーが必要となります。
Example #1 伝統的な API を使用した Amazon 検索 この例では、Amazon で PHP に関する書籍を検索し、 結果の一覧を表示します。 Example #2 クエリ API を使用した Amazon 検索 ここでも Amazon で PHP に関する書籍を検索します。 しかし、ここではクエリ API を使用します。この API は、Fluent Interface パターンと似た形式です。
国コード
デフォルトでは、Zend_Service_Amazon は米国 (" Example #3 Amazon Web Service の国の選択
ASIN を使用した商品の検索ASIN がわかっている場合は、 itemLookup() メソッドを使用すると Amazon の商品を検索できます。 Example #4 ASIN を使用した Amazon の商品検索
itemLookup() メソッドにオプションの第 2 パラメータを渡すことで、 検索オプションを指定できます。使用可能なオプションを含む詳細は、 » 関連する Amazon の文書 を参照ください。
Amazon の商品検索の実行さまざまな条件指定による商品検索を行うには itemSearch() メソッドを使用します。 以下に例を示します。 Example #5 Amazon の商品検索の実行 Example #6 ResponseGroup オプションの使用法
itemSearch() は配列のパラメータをひとつ受け取り、 このパラメータで検索オプションを指定します。使用可能なオプションを含む詳細は、 » 関連する Amazon の文書 を参照ください。 Tip
Zend_Service_Amazon_Query クラスを使用すると、これらのメソッドをより簡単に使用できるようになります。 もうひとつのクエリ API の使用法導入
Zend_Service_Amazon_Query は、Amazon Web Service
を使用するためのもうひとつの API を提供します。
この API では Fluent Interface パターンを使用します。
つまり、すべてのコールはメソッド呼び出しを連結した形式になります
(例: 商品検索の設定を行いやすく、また条件に基づく検索をしやすくするために、 Zend_Service_Amazon_Query API ではオーバーロードを使用しています。 各オプションの設定はメソッドのコールで行い、メソッドの引数がオプションの値に対応します。 Example #7 もうひとつのクエリ API を使用した Amazon の検索 この例では、もうひとつのクエリ API のインターフェイスを使用して、 オプションとその値を設定します。
これは、オプション 使用可能なオプションについての詳細な情報は、 » 関連する Amazon の文書 を参照ください。 Zend_Service_Amazon クラス群以下のクラスは、すべて Zend_Service_Amazon::itemLookup() および Zend_Service_Amazon::itemSearch() から返されるものです。 Zend_Service_Amazon_ItemZend_Service_Amazon_Item は、ウェブサービスから返される Amazon の商品を表すために使用されるクラスです。 商品のタイトル、説明、レビューなどを含むすべての属性を包含します。 Zend_Service_Amazon_Item::asXML()
string
asXML
( void
商品情報を、元の XML で返します。 プロパティZend_Service_Amazon_Item が持つプロパティは、 それぞれが標準の Amazon API に直接対応しています。
Zend_Service_Amazon_ImageZend_Service_Amazon_Image は、商品の画像を表します。 プロパティ
Zend_Service_Amazon_ResultSetZend_Service_Amazon_ResultSet オブジェクトは Zend_Service_Amazon::itemSearch() から返され、結果が複数返された場合に簡単に処理できるようにします。
Zend_Service_Amazon_OfferSetEach result returned by Zend_Service_Amazon::itemSearch() および Zend_Service_Amazon::itemLookup() から返される各結果には Zend_Service_Amazon_OfferSet オブジェクトが含まれており、 ここから商品の販売情報が取得できます。 プロパティ
Zend_Service_Amazon_Offer商品の個々の販売情報が Zend_Service_Amazon_Offer オブジェクトとして返されます。 Zend_Service_Amazon_Offer のプロパティ
Zend_Service_Amazon_SimilarProduct商品を検索した際に、Amazon は検索結果の商品と似た商品の一覧も返します。 個々のデータは Zend_Service_Amazon_SimilarProduct オブジェクトとして返されます。 各オブジェクトに含まれる情報を元にして、 その商品の完全な情報を取得するリクエストを行うことができます。 プロパティ
Zend_Service_Amazon_Accessories返される結果の中の「アクセサリ」については Zend_Service_Amazon_Accessories オブジェクトで表されます。 プロパティ
Zend_Service_Amazon_CustomerReviewカスタマーレビューのデータは Zend_Service_Amazon_CustomerReview オブジェクトで返されます。 プロパティ
Zend_Service_Amazon_EditorialReview出版社/著者からの内容紹介は Zend_Service_Amazon_EditorialReview オブジェクトで返されます。 プロパティ
Zend_Service_Amazon_Listmaniaリストマニアのリストデータは Zend_Service_Amazon_Listmania オブジェクトで返されます。 プロパティ
|
|