Zend_Service_Amazon.xml 44 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- Reviewed: no -->
  3. <!-- EN-Revision: 24782 -->
  4. <sect1 id="zend.service.amazon">
  5. <title>Zend_Service_Amazon(日本語)</title>
  6. <sect2 id="zend.service.amazon.introduction">
  7. <title>導入</title>
  8. <para>
  9. <classname>Zend_Service_Amazon</classname> は Amazon
  10. ウェブサービスを使用するためのシンプルな <acronym>API</acronym> です。
  11. <classname>Zend_Service_Amazon</classname> は、ふたつの <acronym>API</acronym> を実装しています。
  12. Amazon 自身の <acronym>API</acronym> に従った伝統的な <acronym>API</acronym> と、
  13. 複雑な検索クエリを簡単に作成するためのシンプルな「クエリ <acronym>API</acronym>」です。
  14. </para>
  15. <para>
  16. <classname>Zend_Service_Amazon</classname> を使用すると、開発者が
  17. Amazon Web Services <acronym>API</acronym> を直接使用して、Amazon.com
  18. の情報を取得できるようになります。
  19. 取得できる情報には以下のようなものがあります。
  20. <itemizedlist>
  21. <listitem>
  22. <para>
  23. 商品の情報、例えば画像や説明や価格など
  24. </para>
  25. </listitem>
  26. <listitem>
  27. <para>
  28. カスタマーレビュー
  29. </para>
  30. </listitem>
  31. <listitem>
  32. <para>
  33. 似た製品やアクセサリの情報
  34. </para>
  35. </listitem>
  36. <listitem>
  37. <para>
  38. Amazon.com のおすすめ
  39. </para>
  40. </listitem>
  41. <listitem>
  42. <para>
  43. リストマニアのリスト
  44. </para>
  45. </listitem>
  46. </itemizedlist>
  47. </para>
  48. <para>
  49. <classname>Zend_Service_Amazon</classname> を使用するには、
  50. Amazon デベロッパ <acronym>API</acronym> キーとシークレットキーが必要です。
  51. このキーを取得するには、
  52. <ulink url="http://aws.amazon.com/">Amazon Web Services</ulink>
  53. のウェブサイトを参照ください。
  54. 2009年8月15日以降、Amazon Product Advertising <acronym>API</acronym>
  55. を <classname>Zend_Service_Amazon</classname> で使うにはシークレットキーが必要となります。
  56. </para>
  57. <note>
  58. <title>注意</title>
  59. <para>
  60. Amazon デベロッパ <acronym>API</acronym> キーおよびシークレットキーは Amazon のアカウントと関連付けられます。
  61. 取得した <acronym>API</acronym> キーは自分自身でのみ使用するようにしましょう。
  62. </para>
  63. </note>
  64. <example id="zend.service.amazon.introduction.example.itemsearch">
  65. <title>伝統的な API を使用した Amazon 検索</title>
  66. <para>
  67. この例では、Amazon で PHP に関する書籍を検索し、
  68. 結果の一覧を表示します。
  69. </para>
  70. <programlisting language="php"><![CDATA[
  71. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'US', 'AMAZON_SECRET_KEY');
  72. $results = $amazon->itemSearch(array('SearchIndex' => 'Books',
  73. 'Keywords' => 'php'));
  74. foreach ($results as $result) {
  75. echo $result->Title . '<br />';
  76. }
  77. ]]></programlisting>
  78. </example>
  79. <example id="zend.service.amazon.introduction.example.query_api">
  80. <title>クエリ API を使用した Amazon 検索</title>
  81. <para>
  82. ここでも Amazon で PHP に関する書籍を検索します。
  83. しかし、ここではクエリ <acronym>API</acronym> を使用します。この <acronym>API</acronym>
  84. は、Fluent Interface パターンと似た形式です。
  85. </para>
  86. <programlisting language="php"><![CDATA[
  87. $query = new Zend_Service_Amazon_Query('AMAZON_API_KEY',
  88. 'US',
  89. 'AMAZON_SECRET_KEY');
  90. $query->category('Books')->Keywords('PHP');
  91. $results = $query->search();
  92. foreach ($results as $result) {
  93. echo $result->Title . '<br />';
  94. }
  95. ]]></programlisting>
  96. </example>
  97. </sect2>
  98. <sect2 id="zend.service.amazon.countrycodes">
  99. <title>国コード</title>
  100. <para>
  101. デフォルトでは、<classname>Zend_Service_Amazon</classname> は米国 ("<code>US</code>")
  102. の Amazon Web Service に接続します。他の国のサービスに接続するには、
  103. コンストラクタの 2 番目のパラメータとして、適切な国コード文字列を指定するだけです。
  104. </para>
  105. <example id="zend.service.amazon.countrycodes.example.country_code">
  106. <title>Amazon Web Service の国の選択</title>
  107. <programlisting language="php"><![CDATA[
  108. // 日本の Amazon に接続します
  109. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'JP', 'AMAZON_SECRET_KEY');
  110. ]]></programlisting>
  111. </example>
  112. <note>
  113. <title>国コード</title>
  114. <para>
  115. 使用できる国コードは <code>CA</code>、<code>DE</code>、<code>FR</code>、<code>JP</code>、
  116. <code>UK</code> および <code>US</code> です。
  117. </para>
  118. </note>
  119. </sect2>
  120. <sect2 id="zend.service.amazon.itemlookup">
  121. <title>ASIN を使用した商品の検索</title>
  122. <para>
  123. <acronym>ASIN</acronym> がわかっている場合は、<methodname>itemLookup()</methodname>
  124. メソッドを使用すると Amazon の商品を検索できます。
  125. </para>
  126. <example id="zend.service.amazon.itemlookup.example.asin">
  127. <title>ASIN を使用した Amazon の商品検索</title>
  128. <programlisting language="php"><![CDATA[
  129. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'US', 'AMAZON_SECRET_KEY');
  130. $item = $amazon->itemLookup('B0000A432X');
  131. ]]></programlisting>
  132. </example>
  133. <para>
  134. <methodname>itemLookup()</methodname> メソッドにオプションの第 2 パラメータを渡すことで、
  135. 検索オプションを指定できます。使用可能なオプションを含む詳細は、
  136. <ulink
  137. url="http://www.amazon.com/gp/aws/sdk/main.html/103-9285448-4703844?s=AWSEcommerceService&amp;v=2011-08-01&amp;p=ApiReference/ItemLookupOperation">関連する Amazon の文書</ulink>
  138. を参照ください。
  139. </para>
  140. <note>
  141. <title>画像の情報</title>
  142. <para>
  143. 検索結果の画像情報を取得するには、オプション <code>ResponseGroup</code>
  144. を <code>Medium</code> あるいは <code>Large</code> に設定しなければなりません。
  145. </para>
  146. </note>
  147. </sect2>
  148. <sect2 id="zend.service.amazon.itemsearch">
  149. <title>Amazon の商品検索の実行</title>
  150. <para>
  151. さまざまな条件指定による商品検索を行うには
  152. <methodname>itemSearch()</methodname> メソッドを使用します。
  153. 以下に例を示します。
  154. </para>
  155. <example id="zend.service.amazon.itemsearch.example.basic">
  156. <title>Amazon の商品検索の実行</title>
  157. <programlisting language="php"><![CDATA[
  158. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'US', 'AMAZON_SECRET_KEY');
  159. $results = $amazon->itemSearch(array('SearchIndex' => 'Books',
  160. 'Keywords' => 'php'));
  161. foreach ($results as $result) {
  162. echo $result->Title . '<br />';
  163. }
  164. ]]></programlisting>
  165. </example>
  166. <example id="zend.service.amazon.itemsearch.example.responsegroup">
  167. <title>ResponseGroup オプションの使用法</title>
  168. <para>
  169. <code>ResponseGroup</code> オプションを使用すると、
  170. レスポンスで返される情報を制御できます。
  171. </para>
  172. <programlisting language="php"><![CDATA[
  173. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'US', 'AMAZON_SECRET_KEY');
  174. $results = $amazon->itemSearch(array(
  175. 'SearchIndex' => 'Books',
  176. 'Keywords' => 'php',
  177. 'ResponseGroup' => 'Small,ItemAttributes,Images,SalesRank,Reviews,' .
  178. 'EditorialReview,Similarities,ListmaniaLists'
  179. ));
  180. foreach ($results as $result) {
  181. echo $result->Title . '<br />';
  182. }
  183. ]]></programlisting>
  184. </example>
  185. <para>
  186. <methodname>itemSearch()</methodname> は配列のパラメータをひとつ受け取り、
  187. このパラメータで検索オプションを指定します。使用可能なオプションを含む詳細は、
  188. <ulink
  189. url="http://www.amazon.com/gp/aws/sdk/main.html/103-9285448-4703844?s=AWSEcommerceService&amp;v=2011-08-01&amp;p=ApiReference/ItemSearchOperation">関連する Amazon の文書</ulink>
  190. を参照ください。
  191. </para>
  192. <tip>
  193. <para>
  194. <link linkend="zend.service.amazon.query"><classname>Zend_Service_Amazon_Query</classname></link>
  195. クラスを使用すると、これらのメソッドをより簡単に使用できるようになります。
  196. </para>
  197. </tip>
  198. </sect2>
  199. <sect2 id="zend.service.amazon.query">
  200. <title>もうひとつのクエリ API の使用法</title>
  201. <sect3 id="zend.service.amazon.query.introduction">
  202. <title>導入</title>
  203. <para>
  204. <classname>Zend_Service_Amazon_Query</classname> は、Amazon Web Service
  205. を使用するためのもうひとつの <acronym>API</acronym> を提供します。
  206. この <acronym>API</acronym> では Fluent Interface パターンを使用します。
  207. つまり、すべてのコールはメソッド呼び出しを連結した形式になります
  208. (例: <code>$obj->method()->method2($arg)</code>)。
  209. </para>
  210. <para>
  211. 商品検索の設定を行いやすく、また条件に基づく検索をしやすくするために、
  212. <classname>Zend_Service_Amazon_Query</classname> <acronym>API</acronym> ではオーバーロードを使用しています。
  213. 各オプションの設定はメソッドのコールで行い、メソッドの引数がオプションの値に対応します。
  214. </para>
  215. <example id="zend.service.amazon.query.introduction.example.basic">
  216. <title>もうひとつのクエリ API を使用した Amazon の検索</title>
  217. <para>
  218. この例では、もうひとつのクエリ <acronym>API</acronym> のインターフェイスを使用して、
  219. オプションとその値を設定します。
  220. </para>
  221. <programlisting language="php"><![CDATA[
  222. $query = new Zend_Service_Amazon_Query('MY_API_KEY');
  223. $query->Category('Books')->Keywords('PHP');
  224. $results = $query->search();
  225. foreach ($results as $result) {
  226. echo $result->Title . '<br />';
  227. }
  228. ]]></programlisting>
  229. <para>
  230. これは、オプション <code>Category</code> の値を "Books"、
  231. そして <code>Keywords</code> の値を "PHP" に設定します。
  232. </para>
  233. <para>
  234. 使用可能なオプションについての詳細な情報は、
  235. <ulink
  236. url="http://www.amazon.com/gp/aws/sdk/main.html/102-9041115-9057709?s=AWSEcommerceService&amp;v=2011-08-01&amp;p=ApiReference/ItemSearchOperation">関連する Amazon の文書</ulink>
  237. を参照ください。
  238. </para>
  239. </example>
  240. </sect3>
  241. </sect2>
  242. <sect2 id="zend.service.amazon.classes">
  243. <title>Zend_Service_Amazon クラス群</title>
  244. <para>
  245. 以下のクラスは、すべて
  246. <link linkend="zend.service.amazon.itemlookup"><methodname>Zend_Service_Amazon::itemLookup()</methodname></link>
  247. および
  248. <link linkend="zend.service.amazon.itemsearch"><methodname>Zend_Service_Amazon::itemSearch()</methodname></link>
  249. から返されるものです。
  250. <itemizedlist>
  251. <listitem><para><link linkend="zend.service.amazon.classes.item"><classname>Zend_Service_Amazon_Item</classname></link></para></listitem>
  252. <listitem><para><link linkend="zend.service.amazon.classes.image"><classname>Zend_Service_Amazon_Image</classname></link></para></listitem>
  253. <listitem><para><link linkend="zend.service.amazon.classes.resultset"><classname>Zend_Service_Amazon_ResultSet</classname></link></para></listitem>
  254. <listitem><para><link linkend="zend.service.amazon.classes.offerset"><classname>Zend_Service_Amazon_OfferSet</classname></link></para></listitem>
  255. <listitem><para><link linkend="zend.service.amazon.classes.offer"><classname>Zend_Service_Amazon_Offer</classname></link></para></listitem>
  256. <listitem><para><link linkend="zend.service.amazon.classes.similarproduct"><classname>Zend_Service_Amazon_SimilarProduct</classname></link></para></listitem>
  257. <listitem><para><link linkend="zend.service.amazon.classes.accessories"><classname>Zend_Service_Amazon_Accessories</classname></link></para></listitem>
  258. <listitem><para><link linkend="zend.service.amazon.classes.customerreview"><classname>Zend_Service_Amazon_CustomerReview</classname></link></para></listitem>
  259. <listitem><para><link linkend="zend.service.amazon.classes.editorialreview"><classname>Zend_Service_Amazon_EditorialReview</classname></link></para></listitem>
  260. <listitem><para><link linkend="zend.service.amazon.classes.listmania"><classname>Zend_Service_Amazon_ListMania</classname></link></para></listitem>
  261. </itemizedlist>
  262. </para>
  263. <sect3 id="zend.service.amazon.classes.item">
  264. <title>Zend_Service_Amazon_Item</title>
  265. <para>
  266. <classname>Zend_Service_Amazon_Item</classname> は、ウェブサービスから返される
  267. Amazon の商品を表すために使用されるクラスです。
  268. 商品のタイトル、説明、レビューなどを含むすべての属性を包含します。
  269. </para>
  270. <sect4 id="zend.service.amazon.classes.item.asxml">
  271. <title>Zend_Service_Amazon_Item::asXML()</title>
  272. <para>
  273. <methodsynopsis>
  274. <type>string</type>
  275. <methodname>asXML</methodname>
  276. <void />
  277. </methodsynopsis>
  278. </para>
  279. <para>商品情報を、元の XML で返します。</para>
  280. </sect4>
  281. <sect4 id="zend.service.amazon.classes.item.properties">
  282. <title>プロパティ</title>
  283. <para>
  284. <classname>Zend_Service_Amazon_Item</classname> が持つプロパティは、
  285. それぞれが標準の Amazon <acronym>API</acronym> に直接対応しています。
  286. </para>
  287. <table id="zend.service.amazon.classes.item.properties.table-1">
  288. <title>Zend_Service_Amazon_Item のプロパティ</title>
  289. <tgroup cols="3">
  290. <thead>
  291. <row>
  292. <entry>名前</entry>
  293. <entry>型</entry>
  294. <entry>説明</entry>
  295. </row>
  296. </thead>
  297. <tbody>
  298. <row>
  299. <entry><acronym>ASIN</acronym></entry>
  300. <entry>string</entry>
  301. <entry>Amazon の商品 ID</entry>
  302. </row>
  303. <row>
  304. <entry>DetailPageURL</entry>
  305. <entry>string</entry>
  306. <entry>商品の詳細情報ページの URL</entry>
  307. </row>
  308. <row>
  309. <entry>SalesRank</entry>
  310. <entry>int</entry>
  311. <entry>商品の売上ランキング</entry>
  312. </row>
  313. <row>
  314. <entry>SmallImage</entry>
  315. <entry>Zend_Service_Amazon_Image</entry>
  316. <entry>商品の画像 (小)</entry>
  317. </row>
  318. <row>
  319. <entry>MediumImage</entry>
  320. <entry>Zend_Service_Amazon_Image</entry>
  321. <entry>商品の画像 (中)</entry>
  322. </row>
  323. <row>
  324. <entry>LargeImage</entry>
  325. <entry>Zend_Service_Amazon_Image</entry>
  326. <entry>商品の画像 (大)</entry>
  327. </row>
  328. <row>
  329. <entry>Subjects</entry>
  330. <entry>array</entry>
  331. <entry>商品のテーマ</entry>
  332. </row>
  333. <row>
  334. <entry>Offers</entry>
  335. <entry>
  336. <code>
  337. <link
  338. linkend="zend.service.amazon.classes.offerset">Zend_Service_Amazon_OfferSet</link>
  339. </code>
  340. </entry>
  341. <entry>提供内容の概要および商品の提供情報</entry>
  342. </row>
  343. <row>
  344. <entry>CustomerReviews</entry>
  345. <entry>array</entry>
  346. <entry>
  347. <code>
  348. <link
  349. linkend="zend.service.amazon.classes.customerreview">Zend_Service_Amazon_CustomerReview</link>
  350. </code>
  351. オブジェクトの配列で表されるカスタマーレビュー
  352. </entry>
  353. </row>
  354. <row>
  355. <entry>EditorialReviews</entry>
  356. <entry>array</entry>
  357. <entry>
  358. <code>
  359. <link
  360. linkend="zend.service.amazon.classes.editorialreview">Zend_Service_Amazon_EditorialReview</link>
  361. </code>
  362. オブジェクトの配列で表される、出版社/著者からの内容紹介
  363. </entry>
  364. </row>
  365. <row>
  366. <entry>SimilarProducts</entry>
  367. <entry>array</entry>
  368. <entry>
  369. <code>
  370. <link
  371. linkend="zend.service.amazon.classes.similarproduct">Zend_Service_Amazon_SimilarProduct</link>
  372. </code>
  373. オブジェクトの配列で表される、似た商品の情報
  374. </entry>
  375. </row>
  376. <row>
  377. <entry>Accessories</entry>
  378. <entry>array</entry>
  379. <entry>
  380. <code>
  381. <link
  382. linkend="zend.service.amazon.classes.accessories">Zend_Service_Amazon_Accessories</link>
  383. </code>
  384. オブジェクトの配列で表される、関連アクセサリの情報
  385. </entry>
  386. </row>
  387. <row>
  388. <entry>Tracks</entry>
  389. <entry>array</entry>
  390. <entry>音楽 CD や <acronym>DVD</acronym> の、トラック番号と曲名の配列</entry>
  391. </row>
  392. <row>
  393. <entry>ListmaniaLists</entry>
  394. <entry>array</entry>
  395. <entry>
  396. <code>
  397. <link
  398. linkend="zend.service.amazon.classes.listmania">Zend_Service_Amazon_ListmainList</link>
  399. </code>
  400. オブジェクトの配列で表される、この商品に関連するリストマニアのリスト
  401. </entry>
  402. </row>
  403. <row>
  404. <entry>PromotionalTag</entry>
  405. <entry>string</entry>
  406. <entry>商品の販売促進用のタグ</entry>
  407. </row>
  408. </tbody>
  409. </tgroup>
  410. </table>
  411. <para>
  412. <link linkend="zend.service.amazon.classes">クラス一覧に戻る</link>
  413. </para>
  414. </sect4>
  415. </sect3>
  416. <sect3 id="zend.service.amazon.classes.image">
  417. <title>Zend_Service_Amazon_Image</title>
  418. <para><classname>Zend_Service_Amazon_Image</classname> は、商品の画像を表します。</para>
  419. <sect4 id="zend.service.amazon.classes.image.properties">
  420. <title>プロパティ</title>
  421. <table id="zend.service.amazon.classes.image.properties.table-1">
  422. <title>Zend_Service_Amazon_Image のプロパティ</title>
  423. <tgroup cols="3">
  424. <thead>
  425. <row>
  426. <entry>名前</entry>
  427. <entry>型</entry>
  428. <entry>説明</entry>
  429. </row>
  430. </thead>
  431. <tbody>
  432. <row>
  433. <entry>Url</entry>
  434. <entry>Zend_Uri</entry>
  435. <entry>画像のリモート <acronym>URL</acronym></entry>
  436. </row>
  437. <row>
  438. <entry>Height</entry>
  439. <entry>int</entry>
  440. <entry>画像の高さ (ピクセル単位)</entry>
  441. </row>
  442. <row>
  443. <entry>Width</entry>
  444. <entry>int</entry>
  445. <entry>画像の幅 (ピクセル単位)</entry>
  446. </row>
  447. </tbody>
  448. </tgroup>
  449. </table>
  450. <para>
  451. <link linkend="zend.service.amazon.classes">クラス一覧に戻る</link>
  452. </para>
  453. </sect4>
  454. </sect3>
  455. <sect3 id="zend.service.amazon.classes.resultset">
  456. <title>Zend_Service_Amazon_ResultSet</title>
  457. <para>
  458. <classname>Zend_Service_Amazon_ResultSet</classname> オブジェクトは
  459. <link linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link>
  460. から返され、結果が複数返された場合に簡単に処理できるようにします。
  461. </para>
  462. <note>
  463. <title>SeekableIterator</title>
  464. <para>
  465. 操作性を高めるため、<code>SeekableIterator</code> を実装しています。
  466. これにより、一般的な順次処理 (例えば <code>foreach</code> など)
  467. だけでなく <methodname>seek()</methodname> を使用した特定の結果への直接アクセスも可能です。
  468. </para>
  469. </note>
  470. <sect4 id="zend.service.amazon.classes.resultset.totalresults">
  471. <title>Zend_Service_Amazon_ResultSet::totalResults()</title>
  472. <methodsynopsis>
  473. <type>int</type>
  474. <methodname>totalResults</methodname>
  475. <void />
  476. </methodsynopsis>
  477. <para>検索結果の総数を返します。</para>
  478. <para>
  479. <link linkend="zend.service.amazon.classes">クラス一覧に戻る</link>
  480. </para>
  481. </sect4>
  482. </sect3>
  483. <sect3 id="zend.service.amazon.classes.offerset">
  484. <title>Zend_Service_Amazon_OfferSet</title>
  485. <para>
  486. Each result returned by
  487. <link linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link>
  488. および
  489. <link linkend="zend.service.amazon.itemlookup">Zend_Service_Amazon::itemLookup()</link>
  490. から返される各結果には
  491. <classname>Zend_Service_Amazon_OfferSet</classname> オブジェクトが含まれており、
  492. ここから商品の販売情報が取得できます。
  493. </para>
  494. <sect4 id="zend.service.amazon.classes.offerset.parameters">
  495. <title>プロパティ</title>
  496. <table id="zend.service.amazon.classes.offerset.parameters.table-1">
  497. <title>Zend_Service_Amazon_OfferSet のプロパティ</title>
  498. <tgroup cols="3">
  499. <thead>
  500. <row>
  501. <entry>名前</entry>
  502. <entry>型</entry>
  503. <entry>説明</entry>
  504. </row>
  505. </thead>
  506. <tbody>
  507. <row>
  508. <entry>LowestNewPrice</entry>
  509. <entry>int</entry>
  510. <entry>&quot;新品&quot; の最低価格</entry>
  511. </row>
  512. <row>
  513. <entry>LowestNewPriceCurrency</entry>
  514. <entry>string</entry>
  515. <entry>
  516. <code>LowestNewPrice</code> の通貨単位
  517. </entry>
  518. </row>
  519. <row>
  520. <entry>LowestOldPrice</entry>
  521. <entry>int</entry>
  522. <entry>&quot;ユーズド商品&quot; の最低価格</entry>
  523. </row>
  524. <row>
  525. <entry>LowestOldPriceCurrency</entry>
  526. <entry>string</entry>
  527. <entry>
  528. <code>LowestOldPrice</code> の通貨単位
  529. </entry>
  530. </row>
  531. <row>
  532. <entry>TotalNew</entry>
  533. <entry>int</entry>
  534. <entry>&quot;新品&quot; の在庫数</entry>
  535. </row>
  536. <row>
  537. <entry>TotalUsed</entry>
  538. <entry>int</entry>
  539. <entry>&quot;ユーズド商品&quot; の在庫数</entry>
  540. </row>
  541. <row>
  542. <entry>TotalCollectible</entry>
  543. <entry>int</entry>
  544. <entry>&quot;コレクター商品&quot; の在庫数</entry>
  545. </row>
  546. <row>
  547. <entry>TotalRefurbished</entry>
  548. <entry>int</entry>
  549. <entry>&quot;refurbished&quot; の在庫数</entry>
  550. </row>
  551. <row>
  552. <entry>Offers</entry>
  553. <entry>array</entry>
  554. <entry>
  555. <classname>Zend_Service_Amazon_Offer</classname>
  556. オブジェクトの配列
  557. </entry>
  558. </row>
  559. </tbody>
  560. </tgroup>
  561. </table>
  562. <para>
  563. <link linkend="zend.service.amazon.classes">クラス一覧に戻る</link>
  564. </para>
  565. </sect4>
  566. </sect3>
  567. <sect3 id="zend.service.amazon.classes.offer">
  568. <title>Zend_Service_Amazon_Offer</title>
  569. <para>
  570. 商品の個々の販売情報が
  571. <classname>Zend_Service_Amazon_Offer</classname>
  572. オブジェクトとして返されます。
  573. </para>
  574. <sect4 id="zend.service.amazon.classes.offer.properties">
  575. <title>Zend_Service_Amazon_Offer のプロパティ</title>
  576. <table id="zend.service.amazon.classes.offer.properties.table-1">
  577. <title>プロパティ</title>
  578. <tgroup cols="3">
  579. <thead>
  580. <row>
  581. <entry>名前</entry>
  582. <entry>型</entry>
  583. <entry>説明</entry>
  584. </row>
  585. </thead>
  586. <tbody>
  587. <row>
  588. <entry>MerchantId</entry>
  589. <entry>string</entry>
  590. <entry>出品者の Amazon ID</entry>
  591. </row>
  592. <row>
  593. <entry>MerchantName</entry>
  594. <entry>string</entry>
  595. <entry>出品者の Amazon 名。
  596. <!-- TODO : to be translated -->
  597. Requires setting the <code>ResponseGroup</code> option to <code>OfferFull</code> to retrieve.</entry>
  598. </row>
  599. <row>
  600. <entry>GlancePage</entry>
  601. <entry>string</entry>
  602. <entry>出品者の概要が掲載されているページの URL</entry>
  603. </row>
  604. <row>
  605. <entry>Condition</entry>
  606. <entry>string</entry>
  607. <entry>商品のコンディション</entry>
  608. </row>
  609. <row>
  610. <entry>OfferListingId</entry>
  611. <entry>string</entry>
  612. <entry>販売情報リストの ID</entry>
  613. </row>
  614. <row>
  615. <entry>Price</entry>
  616. <entry>int</entry>
  617. <entry>商品の価格</entry>
  618. </row>
  619. <row>
  620. <entry>CurrencyCode</entry>
  621. <entry>string</entry>
  622. <entry>商品価格の通貨コード</entry>
  623. </row>
  624. <row>
  625. <entry>Availability</entry>
  626. <entry>string</entry>
  627. <entry>商品の在庫状況</entry>
  628. </row>
  629. <row>
  630. <entry>IsEligibleForSuperSaverShipping</entry>
  631. <entry>boolean</entry>
  632. <entry>Super Saver Shipping に対応しているか否か</entry>
  633. </row>
  634. </tbody>
  635. </tgroup>
  636. </table>
  637. <para>
  638. <link linkend="zend.service.amazon.classes">クラス一覧に戻る</link>
  639. </para>
  640. </sect4>
  641. </sect3>
  642. <sect3 id="zend.service.amazon.classes.similarproduct">
  643. <title>Zend_Service_Amazon_SimilarProduct</title>
  644. <para>
  645. 商品を検索した際に、Amazon は検索結果の商品と似た商品の一覧も返します。
  646. 個々のデータは <classname>Zend_Service_Amazon_SimilarProduct</classname>
  647. オブジェクトとして返されます。
  648. </para>
  649. <para>
  650. 各オブジェクトに含まれる情報を元にして、
  651. その商品の完全な情報を取得するリクエストを行うことができます。
  652. </para>
  653. <sect4 id="zend.service.amazon.classes.similarproduct.properties">
  654. <title>プロパティ</title>
  655. <table id="zend.service.amazon.classes.similarproduct.properties.table-1">
  656. <title>Zend_Service_Amazon_SimilarProduct のプロパティ</title>
  657. <tgroup cols="3">
  658. <thead>
  659. <row>
  660. <entry>名前</entry>
  661. <entry>型</entry>
  662. <entry>説明</entry>
  663. </row>
  664. </thead>
  665. <tbody>
  666. <row>
  667. <entry><acronym>ASIN</acronym></entry>
  668. <entry>string</entry>
  669. <entry>Amazon 商品 ID (<acronym>ASIN</acronym>)</entry>
  670. </row>
  671. <row>
  672. <entry>Title</entry>
  673. <entry>string</entry>
  674. <entry>商品名</entry>
  675. </row>
  676. </tbody>
  677. </tgroup>
  678. </table>
  679. <para>
  680. <link linkend="zend.service.amazon.classes">クラス一覧に戻る</link>
  681. </para>
  682. </sect4>
  683. </sect3>
  684. <sect3 id="zend.service.amazon.classes.accessories">
  685. <title>Zend_Service_Amazon_Accessories</title>
  686. <para>
  687. 返される結果の中の「アクセサリ」については
  688. <classname>Zend_Service_Amazon_Accessories</classname>
  689. オブジェクトで表されます。
  690. </para>
  691. <sect4 id="zend.service.amazon.classes.accessories.properties">
  692. <title>プロパティ</title>
  693. <table id="zend.service.amazon.classes.accessories.properties.table-1">
  694. <title>Zend_Service_Amazon_Accessories のプロパティ</title>
  695. <tgroup cols="3">
  696. <thead>
  697. <row>
  698. <entry>名前</entry>
  699. <entry>型</entry>
  700. <entry>説明</entry>
  701. </row>
  702. </thead>
  703. <tbody>
  704. <row>
  705. <entry><acronym>ASIN</acronym></entry>
  706. <entry>string</entry>
  707. <entry>Amazon 商品 ID (<acronym>ASIN</acronym>)</entry>
  708. </row>
  709. <row>
  710. <entry>Title</entry>
  711. <entry>string</entry>
  712. <entry>商品名</entry>
  713. </row>
  714. </tbody>
  715. </tgroup>
  716. </table>
  717. <para>
  718. <link linkend="zend.service.amazon.classes">クラス一覧に戻る</link>
  719. </para>
  720. </sect4>
  721. </sect3>
  722. <sect3 id="zend.service.amazon.classes.customerreview">
  723. <title>Zend_Service_Amazon_CustomerReview</title>
  724. <para>
  725. カスタマーレビューのデータは
  726. <classname>Zend_Service_Amazon_CustomerReview</classname>
  727. オブジェクトで返されます。
  728. </para>
  729. <sect4 id="zend.service.amazon.classes.customerreview.properties">
  730. <title>プロパティ</title>
  731. <table id="zend.service.amazon.classes.customerreview.properties.table-1">
  732. <title>Zend_Service_Amazon_CustomerReview のプロパティ</title>
  733. <tgroup cols="3">
  734. <thead>
  735. <row>
  736. <entry>名前</entry>
  737. <entry>型</entry>
  738. <entry>説明</entry>
  739. </row>
  740. </thead>
  741. <tbody>
  742. <row>
  743. <entry>Rating</entry>
  744. <entry>string</entry>
  745. <entry>商品のおすすめ度</entry>
  746. </row>
  747. <row>
  748. <entry>HelpfulVotes</entry>
  749. <entry>string</entry>
  750. <entry>「このレビューが参考になった」の投票</entry>
  751. </row>
  752. <row>
  753. <entry>CustomerId</entry>
  754. <entry>string</entry>
  755. <entry>カスタマー ID</entry>
  756. </row>
  757. <row>
  758. <entry>TotalVotes</entry>
  759. <entry>string</entry>
  760. <entry>全投票数</entry>
  761. </row>
  762. <row>
  763. <entry>Date</entry>
  764. <entry>string</entry>
  765. <entry>レビューされた日付</entry>
  766. </row>
  767. <row>
  768. <entry>Summary</entry>
  769. <entry>string</entry>
  770. <entry>レビューの概要</entry>
  771. </row>
  772. <row>
  773. <entry>Content</entry>
  774. <entry>string</entry>
  775. <entry>レビューの内容</entry>
  776. </row>
  777. </tbody>
  778. </tgroup>
  779. </table>
  780. <para>
  781. <link linkend="zend.service.amazon.classes">クラス一覧に戻る</link>
  782. </para>
  783. </sect4>
  784. </sect3>
  785. <sect3 id="zend.service.amazon.classes.editorialreview">
  786. <title>Zend_Service_Amazon_EditorialReview</title>
  787. <para>
  788. 出版社/著者からの内容紹介は
  789. <classname>Zend_Service_Amazon_EditorialReview</classname>
  790. オブジェクトで返されます。
  791. </para>
  792. <sect4 id="zend.service.amazon.classes.editorialreview.properties">
  793. <title>プロパティ</title>
  794. <table id="zend.service.amazon.classes.editorialreview.properties.table-1">
  795. <title>Zend_Service_Amazon_EditorialReview のプロパティ</title>
  796. <tgroup cols="3">
  797. <thead>
  798. <row>
  799. <entry>名前</entry>
  800. <entry>型</entry>
  801. <entry>説明</entry>
  802. </row>
  803. </thead>
  804. <tbody>
  805. <row>
  806. <entry>Source</entry>
  807. <entry>string</entry>
  808. <entry>レビュー元</entry>
  809. </row>
  810. <row>
  811. <entry>Content</entry>
  812. <entry>string</entry>
  813. <entry>レビューの内容</entry>
  814. </row>
  815. </tbody>
  816. </tgroup>
  817. </table>
  818. <para>
  819. <link linkend="zend.service.amazon.classes">クラス一覧に戻る</link>
  820. </para>
  821. </sect4>
  822. </sect3>
  823. <sect3 id="zend.service.amazon.classes.listmania">
  824. <title>Zend_Service_Amazon_Listmania</title>
  825. <para>
  826. リストマニアのリストデータは
  827. <classname>Zend_Service_Amazon_Listmania</classname>
  828. オブジェクトで返されます。
  829. </para>
  830. <sect4 id="zend.service.amazon.classes.listmania.properties">
  831. <title>プロパティ</title>
  832. <table id="zend.service.amazon.classes.listmania.properties.table-1">
  833. <title>Zend_Service_Amazon_Listmania のプロパティ</title>
  834. <tgroup cols="3">
  835. <thead>
  836. <row>
  837. <entry>名前</entry>
  838. <entry>型</entry>
  839. <entry>説明</entry>
  840. </row>
  841. </thead>
  842. <tbody>
  843. <row>
  844. <entry>ListId</entry>
  845. <entry>string</entry>
  846. <entry>リスト ID</entry>
  847. </row>
  848. <row>
  849. <entry>ListName</entry>
  850. <entry>string</entry>
  851. <entry>リスト名</entry>
  852. </row>
  853. </tbody>
  854. </tgroup>
  855. </table>
  856. <para>
  857. <link linkend="zend.service.amazon.classes">クラス一覧に戻る</link>
  858. </para>
  859. </sect4>
  860. </sect3>
  861. </sect2>
  862. </sect1>
  863. <!--
  864. vim:se ts=4 sw=4 et:
  865. -->