Zend_Service_Amazon.xml 45 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 17232 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.service.amazon">
  5. <title>Zend_Service_Amazon</title>
  6. <sect2 id="zend.service.amazon.introduction">
  7. <title>Einführung</title>
  8. <para>
  9. <classname>Zend_Service_Amazon</classname> ist eine einfach <acronym>API</acronym> für
  10. die Benutzung des Amazon Web Services. <classname>Zend_Service_Amazon</classname> hat 2
  11. <acronym>API</acronym>s: eine traditionellere welche Amazon's eigener
  12. <acronym>API</acronym> folgt, und eine simplere "Abfrage <acronym>API</acronym>" um
  13. sogar komplexe Suchabfragen einfachst machen zu können.
  14. </para>
  15. <para>
  16. <classname>Zend_Service_Amazon</classname> erlaubt es Entwicklern, Informationen von
  17. allen Amazon.com Web Seiten durch das Amazon Web Services <acronym>API</acronym> zu
  18. empfangen. Beispiele beinhalten:
  19. <itemizedlist>
  20. <listitem>
  21. <para>
  22. Informationen speichern, wie Bilder, Beschreibungen, Preise uvm.
  23. </para>
  24. </listitem>
  25. <listitem>
  26. <para>
  27. Kunden und Editorial Reviews
  28. </para>
  29. </listitem>
  30. <listitem>
  31. <para>
  32. Ähnliche Produkte und Zubehör
  33. </para>
  34. </listitem>
  35. <listitem>
  36. <para>
  37. Amazon.com Angebote
  38. </para>
  39. </listitem>
  40. <listitem>
  41. <para>
  42. ListMania Listen
  43. </para>
  44. </listitem>
  45. </itemizedlist>
  46. </para>
  47. <para>
  48. Um <classname>Zend_Service_Amazon</classname> benutzen zu können, benötigt man einen
  49. Amazon Entwickler <acronym>API</acronym> Schlüssel sowie einen geheimen Schlüssel. Um
  50. den Schlüssel zu bekommen und für weiter führende Informationen besuchen Sie bitte die
  51. <ulink url="http://aws.amazon.com/">Amazon Web Service</ulink> Web
  52. Seite. Seit dem 15. August 2009 kann man die Amazon Produkt Advertising
  53. <acronym>API</acronym> über <classname>Zend_Service_Amazon</classname> nur dann
  54. verwenden wenn man einen zusätzlichen geheimen Schlüssel spezifiziert.
  55. </para>
  56. <note>
  57. <title>Achtung</title>
  58. <para>
  59. Der eigene Amazon Entwickler <acronym>API</acronym> und der geheime Schlüssel sind
  60. mit der eigenen Amazon Identität verknüpft. Deswegen sollte man darauf achten das
  61. die Schlüssel privat bleibt.
  62. </para>
  63. </note>
  64. <example id="zend.service.amazon.introduction.example.itemsearch">
  65. <title>Suchen in Amazon mit der traditionellen API</title>
  66. <para>
  67. In diesem Beispiel suchen wir nach <acronym>PHP</acronym> Büchern bei Amazon,
  68. blättern durch die Resultate und Drucken diese aus.
  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>Suchen in Amazon mit der Abfrage API</title>
  81. <para>
  82. Hier suchen wir auch nach <acronym>PHP</acronym> Büchern bei Amazon. Aber wir
  83. verwenden stattdessen die Abfrage <acronym>API</acronym>, welche das Fluent
  84. Interface Design Pattern verwendet.
  85. </para>
  86. <programlisting language="php"><![CDATA[
  87. $query = new Zend_Service_Amazon_Query('AMAZON_API_KEY', 'US', 'AMAZON_SECRET_KEY');
  88. $query->category('Books')->Keywords('PHP');
  89. $results = $query->search();
  90. foreach ($results as $result) {
  91. echo $result->Title . '<br />';
  92. }
  93. ]]></programlisting>
  94. </example>
  95. </sect2>
  96. <sect2 id="zend.service.amazon.countrycodes">
  97. <title>Ländercodes</title>
  98. <para>
  99. Standardmäßig verbindet sich <classname>Zend_Service_Amazon</classname> zum Amazon Web
  100. Service der Vereinigten Staaten ("<code>US</code>"). Um sich zu einem anderen Land zu
  101. verbinden, muß einfach der entsprechende String des Landercodes als zweiter Parameter an
  102. den Konstruktor übergeben werden:
  103. </para>
  104. <example id="zend.service.amazon.countrycodes.example.country_code">
  105. <title>Auswahl eines Amazon Web Service Landes</title>
  106. <programlisting language="php"><![CDATA[
  107. // Zu Amazon in Japan verbinden
  108. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'JP', 'AMAZON_SECRET_KEY');
  109. ]]></programlisting>
  110. </example>
  111. <note>
  112. <title>Ländercodes</title>
  113. <para>
  114. Gültige Ländercodes sind: <code>CA</code>, <code>DE</code>, <code>FR</code>,
  115. <code>JP</code>, <code>UK</code>, and <code>US</code>.
  116. </para>
  117. </note>
  118. </sect2>
  119. <sect2 id="zend.service.amazon.itemlookup">
  120. <title>Betrachten eines speziellen Teils bei Amazon durch ASIN</title>
  121. <para>
  122. Die <methodname>itemLookup()</methodname> Methode ermöglicht es ein bestimmtes Teil bei
  123. Amazon zu erhalten wenn der <acronym>ASIN</acronym> bekannt ist.
  124. </para>
  125. <example id="zend.service.amazon.itemlookup.example.asin">
  126. <title>Betrachten eines speziellen Teils bei Amazon durch ASIN</title>
  127. <programlisting language="php"><![CDATA[
  128. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'US', 'AMAZON_SECRET_KEY');
  129. $item = $amazon->itemLookup('B0000A432X');
  130. ]]></programlisting>
  131. </example>
  132. <para>
  133. Die <methodname>itemLookup()</methodname> Methode akzeptiert auch einen optionalen
  134. zweiten Parameter für die Handhabung der Suchoptionen. Für komplette Details, inklusive
  135. einer Liste der möglichen Optionen sehen Sie bitte in die <ulink
  136. url="http://www.amazon.com/gp/aws/sdk/main.html/103-9285448-4703844?s=AWSEcommerceService&amp;v=2005-10-05&amp;p=ApiReference/ItemLookupOperation">relevante
  137. Amazon Dokumentation</ulink>.
  138. </para>
  139. <note>
  140. <title>Bildinformationen</title>
  141. <para>
  142. Um Bildinformationen für deine Suchergebnisse zu erhalten, musst du die
  143. <code>ResponseGroup</code> Option auf <code>Medium</code> oder <code>Large</code>
  144. setzen.
  145. </para>
  146. </note>
  147. </sect2>
  148. <sect2 id="zend.service.amazon.itemsearch">
  149. <title>Suchen nach Teilen bei Amazon</title>
  150. <para>
  151. Das Suchen nach Teilen, basierend auf den unterschiedlichen möglichen Kriterien ist
  152. einfach gehalten durch benutzen der <methodname>itemSearch()</methodname> Methode wie im
  153. folgenden Beispiel:
  154. </para>
  155. <example id="zend.service.amazon.itemsearch.example.basic">
  156. <title>Suchen nach Teilen bei 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>Verwenden der ResponseGroup Option</title>
  168. <para>
  169. Die <code>ResponseGroup</code> Option wird verwendet um die spezielle Information
  170. zu kontrollieren die in der Antwort zurückgegeben wird.
  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. Die <methodname>itemSearch()</methodname> Methode akzeptiert einen einzelnen Parameter
  187. als Array für die Handhabung der Suchoptionen. Für komplette Details, inklusive eine
  188. Liste der möglichen Optionen sehen Sie bitte in die <ulink
  189. url="http://www.amazon.com/gp/aws/sdk/main.html/103-9285448-4703844?s=AWSEcommerceService&amp;v=2005-10-05&amp;p=ApiReference/ItemSearchOperation">relevante
  190. Amazon Dokumentation</ulink>
  191. </para>
  192. <tip>
  193. <para>
  194. Die <link
  195. linkend="zend.service.amazon.query"><classname>Zend_Service_Amazon_Query</classname></link>
  196. Klasse ist ein einfach zu benutzender Wrapper für diese Methode.
  197. </para>
  198. </tip>
  199. </sect2>
  200. <sect2 id="zend.service.amazon.query">
  201. <title>Benutzen der alternativen Abfrage API</title>
  202. <sect3 id="zend.service.amazon.query.introduction">
  203. <title>Einführung</title>
  204. <para>
  205. <classname>Zend_Service_Amazon_Query</classname> bietet eine alternative
  206. <acronym>API</acronym> für die Benutzung der Amazon Web Services. Die alternative
  207. <acronym>API</acronym> benutzt das Fluent Interface Pattern. Das bedeutet, alle
  208. Aufrufe können durchgeführt werden durch Benutzen von verketteten Methoden Aufrufen.
  209. (z.B., <code>$obj->method()->method2($arg)</code>)
  210. </para>
  211. <para>
  212. Die <classname>Zend_Service_Amazon_Query</classname> <acronym>API</acronym> benutzt
  213. Überladung um einfachst eine Teile Suche zu realisieren, und ermöglicht es,
  214. basierend auf den spezifizierten Kriterien, zu suchen. Jede der Optionen wird als
  215. Methoden Aufruf angeboten, und jedes Methoden Argument korrespondiert mit dem
  216. beschriebenen Options Wert:
  217. </para>
  218. <example id="zend.service.amazon.query.introduction.example.basic">
  219. <title>Suchen in Amazon durch Benutzen der alternativen Abfrage API</title>
  220. <para>
  221. In diesem Beispiel wird die alternative Abfrage <acronym>API</acronym> als
  222. Fluent Interface benutzt um Optionen und Ihre Werte festzulegen:
  223. </para>
  224. <programlisting language="php"><![CDATA[
  225. $query = new Zend_Service_Amazon_Query('MY_API_KEY', 'US', 'AMAZON_SECRET_KEY');
  226. $query->Category('Books')->Keywords('PHP');
  227. $results = $query->search();
  228. foreach ($results as $result) {
  229. echo $result->Title . '<br />';
  230. }
  231. ]]></programlisting>
  232. <para>
  233. Das setzt die Option <code>Category</code> auf "Books" und <code>Keywords</code>
  234. auf "PHP".
  235. </para>
  236. <para>
  237. Für weitere Informationen über die möglichen Optionen, sehen Sie bitte in die
  238. <ulink
  239. url="http://www.amazon.com/gp/aws/sdk/main.html/102-9041115-9057709?s=AWSEcommerceService&amp;v=2005-10-05&amp;p=ApiReference/ItemSearchOperation">relevante
  240. Amazon Dokumentation</ulink>.
  241. </para>
  242. </example>
  243. </sect3>
  244. </sect2>
  245. <sect2 id="zend.service.amazon.classes">
  246. <title>Zend_Service_Amazon Klassen</title>
  247. <para>
  248. Die folgenden klassen werden alle zurückgegeben durch <link
  249. linkend="zend.service.amazon.itemlookup"><methodname>Zend_Service_Amazon::itemLookup()</methodname></link>
  250. und <link
  251. linkend="zend.service.amazon.itemsearch"><methodname>Zend_Service_Amazon::itemSearch()</methodname></link>:
  252. <itemizedlist>
  253. <listitem>
  254. <para>
  255. <link linkend="zend.service.amazon.classes.item"><classname>Zend_Service_Amazon_Item</classname></link>
  256. </para>
  257. </listitem>
  258. <listitem>
  259. <para>
  260. <link linkend="zend.service.amazon.classes.image"><classname>Zend_Service_Amazon_Image</classname></link>
  261. </para>
  262. </listitem>
  263. <listitem>
  264. <para>
  265. <link linkend="zend.service.amazon.classes.resultset"><classname>Zend_Service_Amazon_ResultSet</classname></link>
  266. </para>
  267. </listitem>
  268. <listitem>
  269. <para>
  270. <link linkend="zend.service.amazon.classes.offerset"><classname>Zend_Service_Amazon_OfferSet</classname></link>
  271. </para>
  272. </listitem>
  273. <listitem>
  274. <para>
  275. <link linkend="zend.service.amazon.classes.offer"><classname>Zend_Service_Amazon_Offer</classname></link>
  276. </para>
  277. </listitem>
  278. <listitem>
  279. <para>
  280. <link linkend="zend.service.amazon.classes.similarproduct"><classname>Zend_Service_Amazon_SimilarProduct</classname></link>
  281. </para>
  282. </listitem>
  283. <listitem>
  284. <para>
  285. <link linkend="zend.service.amazon.classes.accessories"><classname>Zend_Service_Amazon_Accessories</classname></link>
  286. </para>
  287. </listitem>
  288. <listitem>
  289. <para>
  290. <link linkend="zend.service.amazon.classes.customerreview"><classname>Zend_Service_Amazon_CustomerReview</classname></link>
  291. </para>
  292. </listitem>
  293. <listitem>
  294. <para>
  295. <link linkend="zend.service.amazon.classes.editorialreview"><classname>Zend_Service_Amazon_EditorialReview</classname></link>
  296. </para>
  297. </listitem>
  298. <listitem>
  299. <para>
  300. <link linkend="zend.service.amazon.classes.listmania"><classname>Zend_Service_Amazon_ListMania</classname></link>
  301. </para>
  302. </listitem>
  303. </itemizedlist>
  304. </para>
  305. <sect3 id="zend.service.amazon.classes.item">
  306. <title>Zend_Service_Amazon_Item</title>
  307. <para>
  308. <classname>Zend_Service_Amazon_Item</classname> ist ein Klassen Typ der benutzt wird
  309. um ein Amazon Teil darzustellen welches durch das Web Service zurück gegeben wird.
  310. Es enthält alle Attribute des Teils wie z.B. Titel, Beschreibung, Reviews, usw.
  311. </para>
  312. <sect4 id="zend.service.amazon.classes.item.asxml">
  313. <title>Zend_Service_Amazon_Item::asXML()</title>
  314. <para>
  315. <methodsynopsis>
  316. <type>string</type>
  317. <methodname>asXML</methodname>
  318. <void />
  319. </methodsynopsis>
  320. </para>
  321. <para>Gibt das original <acronym>XML</acronym> für dieses Teil zurück</para>
  322. </sect4>
  323. <sect4 id="zend.service.amazon.classes.item.properties">
  324. <title>Eigenschaften</title>
  325. <para>
  326. <classname>Zend_Service_Amazon_Item</classname> hat eine Anzahl an Eigenschaften
  327. welche eine direkte Beziehung zu Ihren Standard Amazon <acronym>API</acronym>
  328. Gegenstücken haben.
  329. </para>
  330. <table id="zend.service.amazon.classes.item.properties.table-1">
  331. <title>Zend_Service_Amazon_Item Eigenschaften</title>
  332. <tgroup cols="3">
  333. <thead>
  334. <row>
  335. <entry>Name</entry>
  336. <entry>Typ</entry>
  337. <entry>Beschreibung</entry>
  338. </row>
  339. </thead>
  340. <tbody>
  341. <row>
  342. <entry><acronym>ASIN</acronym></entry>
  343. <entry>string</entry>
  344. <entry>Amazon Teil ID</entry>
  345. </row>
  346. <row>
  347. <entry>DetailPageURL</entry>
  348. <entry>string</entry>
  349. <entry>URL zur Detailseite des Teils</entry>
  350. </row>
  351. <row>
  352. <entry>SalesRank</entry>
  353. <entry>int</entry>
  354. <entry>Verkaufs Rang des Teils</entry>
  355. </row>
  356. <row>
  357. <entry>SmallImage</entry>
  358. <entry>Zend_Service_Amazon_Image</entry>
  359. <entry>Kleines Bild des Tiles</entry>
  360. </row>
  361. <row>
  362. <entry>MediumImage</entry>
  363. <entry>Zend_Service_Amazon_Image</entry>
  364. <entry>Mittleres Bild des Teils</entry>
  365. </row>
  366. <row>
  367. <entry>LargeImage</entry>
  368. <entry>Zend_Service_Amazon_Image</entry>
  369. <entry>Großes Bild des Teils</entry>
  370. </row>
  371. <row>
  372. <entry>Subjects</entry>
  373. <entry>array</entry>
  374. <entry>Inhalte des Teils</entry>
  375. </row>
  376. <row>
  377. <entry>Offers</entry>
  378. <entry>
  379. <code>
  380. <link
  381. linkend="zend.service.amazon.classes.offerset">Zend_Service_Amazon_OfferSet</link>
  382. </code>
  383. </entry>
  384. <entry>Summe der Angebote und Angebote für dieses Teil</entry>
  385. </row>
  386. <row>
  387. <entry>CustomerReviews</entry>
  388. <entry>array</entry>
  389. <entry>
  390. Kunden Reviews dargestellt als Array von
  391. <code>
  392. <link
  393. linkend="zend.service.amazon.classes.customerreview">Zend_Service_Amazon_CustomerReview</link>
  394. </code>
  395. Objekten
  396. </entry>
  397. </row>
  398. <row>
  399. <entry>EditorialReviews</entry>
  400. <entry>array</entry>
  401. <entry>
  402. Editorial Reviews dargestellt als Array von
  403. <code>
  404. <link
  405. linkend="zend.service.amazon.classes.editorialreview">Zend_Service_Amazon_EditorialReview</link>
  406. </code>
  407. Objekten
  408. </entry>
  409. </row>
  410. <row>
  411. <entry>SimilarProducts</entry>
  412. <entry>array</entry>
  413. <entry>
  414. Ähnliche Produkte dargestellt als Array von
  415. <code>
  416. <link
  417. linkend="zend.service.amazon.classes.similarproduct">Zend_Service_Amazon_SimilarProduct</link>
  418. </code>
  419. Objekten
  420. </entry>
  421. </row>
  422. <row>
  423. <entry>Accessories</entry>
  424. <entry>array</entry>
  425. <entry>
  426. Zubehör für dieses Teil dargestellt als Array von
  427. <code>
  428. <link
  429. linkend="zend.service.amazon.classes.accessories">Zend_Service_Amazon_Accessories</link>
  430. </code>
  431. Objekten
  432. </entry>
  433. </row>
  434. <row>
  435. <entry>Tracks</entry>
  436. <entry>array</entry>
  437. <entry>
  438. Ein Array mit Track Nummern und Namen für Musik CDs und
  439. <constant>DVD</constant>s
  440. </entry>
  441. </row>
  442. <row>
  443. <entry>ListmaniaLists</entry>
  444. <entry>array</entry>
  445. <entry>
  446. Passende Listmania Liste für diese Teil, als Array von
  447. <code>
  448. <link
  449. linkend="zend.service.amazon.classes.listmania">Zend_Service_Amazon_ListmainList</link>
  450. </code>
  451. Objekten
  452. </entry>
  453. </row>
  454. <row>
  455. <entry>PromotionalTag</entry>
  456. <entry>string</entry>
  457. <entry>Promotion Tag des Teils</entry>
  458. </row>
  459. </tbody>
  460. </tgroup>
  461. </table>
  462. <para>
  463. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  464. </para>
  465. </sect4>
  466. </sect3>
  467. <sect3 id="zend.service.amazon.classes.image">
  468. <title>Zend_Service_Amazon_Image</title>
  469. <para>
  470. <classname>Zend_Service_Amazon_Image</classname> repräsentiert ein entferntes Bild
  471. für ein Produkt.
  472. </para>
  473. <sect4 id="zend.service.amazon.classes.image.properties">
  474. <title>Eigenschaften</title>
  475. <table id="zend.service.amazon.classes.image.properties.table-1">
  476. <title>Zend_Service_Amazon_Image Eigenschaften</title>
  477. <tgroup cols="3">
  478. <thead>
  479. <row>
  480. <entry>Name</entry>
  481. <entry>Typ</entry>
  482. <entry>Beschreibung</entry>
  483. </row>
  484. </thead>
  485. <tbody>
  486. <row>
  487. <entry>Url</entry>
  488. <entry>Zend_Uri</entry>
  489. <entry>Entfernte <acronym>URL</acronym> für das Bild</entry>
  490. </row>
  491. <row>
  492. <entry>Height</entry>
  493. <entry>int</entry>
  494. <entry>Die Höhe des Bildes als Pixel</entry>
  495. </row>
  496. <row>
  497. <entry>Width</entry>
  498. <entry>int</entry>
  499. <entry>Die Breite des Bildes als Pixel</entry>
  500. </row>
  501. </tbody>
  502. </tgroup>
  503. </table>
  504. <para>
  505. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  506. </para>
  507. </sect4>
  508. </sect3>
  509. <sect3 id="zend.service.amazon.classes.resultset">
  510. <title>Zend_Service_Amazon_ResultSet</title>
  511. <para>
  512. <classname>Zend_Service_Amazon_ResultSet</classname> Objekte werden zurückgegeben
  513. durch <link
  514. linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link>
  515. und erlauben es, die vielfach zurück gelieferten Resultate, einfachst zu Handhaben.
  516. </para>
  517. <note>
  518. <title>SeekableIterator</title>
  519. <para>
  520. Implementiert den <code>SeekableIterator</code> für einfach Iteration
  521. (z.B. benutzen von <code>foreach</code>), sowie direkten Zugriff auf ein
  522. Spezielles Resultat mit <methodname>seek()</methodname>.
  523. </para>
  524. </note>
  525. <sect4 id="zend.service.amazon.classes.resultset.totalresults">
  526. <title>Zend_Service_Amazon_ResultSet::totalResults()</title>
  527. <methodsynopsis>
  528. <type>int</type>
  529. <methodname>totalResults</methodname>
  530. <void />
  531. </methodsynopsis>
  532. <para>
  533. Liefert die Gesamtanzahl der Resultate welche die Suche zurückgegeben hat
  534. </para>
  535. <para>
  536. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  537. </para>
  538. </sect4>
  539. </sect3>
  540. <sect3 id="zend.service.amazon.classes.offerset">
  541. <title>Zend_Service_Amazon_OfferSet</title>
  542. <para>
  543. Jedes Resultat welches durch <link
  544. linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link>
  545. und <link
  546. linkend="zend.service.amazon.itemlookup">Zend_Service_Amazon::itemLookup()</link>
  547. zurückgegeben wird beinhaltet ein
  548. <classname>Zend_Service_Amazon_OfferSet</classname>
  549. Objekt durch welches Preisinformationen für das Teil empfangen werden können.
  550. </para>
  551. <sect4 id="zend.service.amazon.classes.offerset.parameters">
  552. <title>Eigenschaften</title>
  553. <table id="zend.service.amazon.classes.offerset.parameters.table-1">
  554. <title>Zend_Service_Amazon_OfferSet Properties</title>
  555. <tgroup cols="3">
  556. <thead>
  557. <row>
  558. <entry>Name</entry>
  559. <entry>Typ</entry>
  560. <entry>Beschreibung</entry>
  561. </row>
  562. </thead>
  563. <tbody>
  564. <row>
  565. <entry>LowestNewPrice</entry>
  566. <entry>int</entry>
  567. <entry>Niedrigster Preis des Teiles als &quot;Neuwert&quot;</entry>
  568. </row>
  569. <row>
  570. <entry>LowestNewPriceCurrency</entry>
  571. <entry>string</entry>
  572. <entry>
  573. Die Währung für
  574. <code>LowestNewPrice</code>
  575. </entry>
  576. </row>
  577. <row>
  578. <entry>LowestOldPrice</entry>
  579. <entry>int</entry>
  580. <entry>
  581. Niedrigster Preis des Teiles als &quot;Gebrauchtwert&quot;
  582. </entry>
  583. </row>
  584. <row>
  585. <entry>LowestOldPriceCurrency</entry>
  586. <entry>string</entry>
  587. <entry>
  588. Die Währung für
  589. <code>LowestOldPrice</code>
  590. </entry>
  591. </row>
  592. <row>
  593. <entry>TotalNew</entry>
  594. <entry>int</entry>
  595. <entry>
  596. Erhältliche Gesamtanzahl dieses Teils mit &quot;Neuwert&quot;
  597. </entry>
  598. </row>
  599. <row>
  600. <entry>TotalUsed</entry>
  601. <entry>int</entry>
  602. <entry>
  603. Erhältliche Gesamtanzahl dieses Teils mit
  604. &quot;Gebrauchtwert&quot;
  605. </entry>
  606. </row>
  607. <row>
  608. <entry>TotalCollectible</entry>
  609. <entry>int</entry>
  610. <entry>
  611. Erhältliche Gesamtanzahl dieses Teils die &quot;Sammelbar&quot;
  612. sind
  613. </entry>
  614. </row>
  615. <row>
  616. <entry>TotalRefurbished</entry>
  617. <entry>int</entry>
  618. <entry>
  619. Erhältliche Gesamtanzahl dieses Teils die
  620. &quot;Wiederhergestellt&quot; sind
  621. </entry>
  622. </row>
  623. <row>
  624. <entry>Offers</entry>
  625. <entry>array</entry>
  626. <entry>
  627. Ein Array von
  628. <classname>Zend_Service_Amazon_Offer</classname>
  629. Objekten.
  630. </entry>
  631. </row>
  632. </tbody>
  633. </tgroup>
  634. </table>
  635. <para>
  636. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  637. </para>
  638. </sect4>
  639. </sect3>
  640. <sect3 id="zend.service.amazon.classes.offer">
  641. <title>Zend_Service_Amazon_Offer</title>
  642. <para>
  643. Jedes Angebot für ein Teil wird als
  644. <classname>Zend_Service_Amazon_Offer</classname>
  645. Objekt zurück gegeben.
  646. </para>
  647. <sect4 id="zend.service.amazon.classes.offer.properties">
  648. <title>Zend_Service_Amazon_Offer Eigenschaften</title>
  649. <table id="zend.service.amazon.classes.offer.properties.table-1">
  650. <title>Eigenschaften</title>
  651. <tgroup cols="3">
  652. <thead>
  653. <row>
  654. <entry>Name</entry>
  655. <entry>Typ</entry>
  656. <entry>Beschreibung</entry>
  657. </row>
  658. </thead>
  659. <tbody>
  660. <row>
  661. <entry>MerchantId</entry>
  662. <entry>string</entry>
  663. <entry>Amazon ID des Anbieters</entry>
  664. </row>
  665. <row>
  666. <entry>GlancePage</entry>
  667. <entry>string</entry>
  668. <entry>
  669. URL einer Seite mit einer Zusammenfassung des Anbieters
  670. </entry>
  671. </row>
  672. <row>
  673. <entry>Condition</entry>
  674. <entry>string</entry>
  675. <entry>Kondition des Teils</entry>
  676. </row>
  677. <row>
  678. <entry>OfferListingId</entry>
  679. <entry>string</entry>
  680. <entry>ID der Angebots Liste</entry>
  681. </row>
  682. <row>
  683. <entry>Price</entry>
  684. <entry>int</entry>
  685. <entry>Preis für das Teil</entry>
  686. </row>
  687. <row>
  688. <entry>CurrencyCode</entry>
  689. <entry>string</entry>
  690. <entry>Währungscode des Preises für das Teil</entry>
  691. </row>
  692. <row>
  693. <entry>Availability</entry>
  694. <entry>string</entry>
  695. <entry>Erhältlichkeit des Teils</entry>
  696. </row>
  697. <row>
  698. <entry>IsEligibleForSuperSaverShipping</entry>
  699. <entry>boolean</entry>
  700. <entry>
  701. Ob das Teil erhältlich ist für Super Sicheren Versand oder nicht
  702. </entry>
  703. </row>
  704. </tbody>
  705. </tgroup>
  706. </table>
  707. <para>
  708. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  709. </para>
  710. </sect4>
  711. </sect3>
  712. <sect3 id="zend.service.amazon.classes.similarproduct">
  713. <title>Zend_Service_Amazon_SimilarProduct</title>
  714. <para>
  715. Bei der Suche nach Teilen gibt Amazon auch eine Liste an ähnlichen Produkten zurück,
  716. welche dem Suchenden empfohlen werden. Jedes dieser Produkte wird als
  717. <classname>Zend_Service_Amazon_SimilarProduct</classname> Objekt zurückgegeben.
  718. </para>
  719. <para>
  720. Jedes Objekt enthält die Informationen welche es erlauben eine Subanfrage zu machen,
  721. um die kompletten Informationen zu diesem Teil zu bekommen.
  722. </para>
  723. <sect4 id="zend.service.amazon.classes.similarproduct.properties">
  724. <title>Eigenschaften</title>
  725. <table id="zend.service.amazon.classes.similarproduct.properties.table-1">
  726. <title>Zend_Service_Amazon_SimilarProduct Eigenschaften</title>
  727. <tgroup cols="3">
  728. <thead>
  729. <row>
  730. <entry>Name</entry>
  731. <entry>Typ</entry>
  732. <entry>Beschreibung</entry>
  733. </row>
  734. </thead>
  735. <tbody>
  736. <row>
  737. <entry><acronym>ASIN</acronym></entry>
  738. <entry>string</entry>
  739. <entry>Eindeutige Amazon ID des Produkts (ASIN)</entry>
  740. </row>
  741. <row>
  742. <entry>Title</entry>
  743. <entry>string</entry>
  744. <entry>Produkt Überschrift</entry>
  745. </row>
  746. </tbody>
  747. </tgroup>
  748. </table>
  749. <para>
  750. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  751. </para>
  752. </sect4>
  753. </sect3>
  754. <sect3 id="zend.service.amazon.classes.accessories">
  755. <title>Zend_Service_Amazon_Accessories</title>
  756. <para>
  757. Zubehör für das zurückgegebene Teil werden als
  758. <classname>Zend_Service_Amazon_Accessories</classname> Objekte dargestellt.
  759. </para>
  760. <sect4 id="zend.service.amazon.classes.accessories.properties">
  761. <title>Eigenschaften</title>
  762. <table id="zend.service.amazon.classes.accessories.properties.table-1">
  763. <title>Zend_Service_Amazon_Accessories Eigenschaften</title>
  764. <tgroup cols="3">
  765. <thead>
  766. <row>
  767. <entry>Name</entry>
  768. <entry>Typ</entry>
  769. <entry>Beschreibung</entry>
  770. </row>
  771. </thead>
  772. <tbody>
  773. <row>
  774. <entry><acronym>ASIN</acronym></entry>
  775. <entry>string</entry>
  776. <entry>Eindeutige Amazon ID des Produkts (ASIN)</entry>
  777. </row>
  778. <row>
  779. <entry>Title</entry>
  780. <entry>string</entry>
  781. <entry>Produkt Überschrift</entry>
  782. </row>
  783. </tbody>
  784. </tgroup>
  785. </table>
  786. <para>
  787. <link linkend="zend.service.amazon.classes">Back to Class List</link>
  788. </para>
  789. </sect4>
  790. </sect3>
  791. <sect3 id="zend.service.amazon.classes.customerreview">
  792. <title>Zend_Service_Amazon_CustomerReview</title>
  793. <para>
  794. Jede Kunden Review wird als
  795. <classname>Zend_Service_Amazon_CustomerReview</classname> Objekt zurückgegeben.
  796. </para>
  797. <sect4 id="zend.service.amazon.classes.customerreview.properties">
  798. <title>Eigenschaften</title>
  799. <table id="zend.service.amazon.classes.customerreview.properties.table-1">
  800. <title>Zend_Service_Amazon_CustomerReview Eigenschaften</title>
  801. <tgroup cols="3">
  802. <thead>
  803. <row>
  804. <entry>Name</entry>
  805. <entry>Typ</entry>
  806. <entry>Beschreibung</entry>
  807. </row>
  808. </thead>
  809. <tbody>
  810. <row>
  811. <entry>Rating</entry>
  812. <entry>string</entry>
  813. <entry>Bewertung des Teils</entry>
  814. </row>
  815. <row>
  816. <entry>HelpfulVotes</entry>
  817. <entry>string</entry>
  818. <entry>Stimmen wie hilfreich die Review ist</entry>
  819. </row>
  820. <row>
  821. <entry>CustomerId</entry>
  822. <entry>string</entry>
  823. <entry>Kunden ID</entry>
  824. </row>
  825. <row>
  826. <entry>TotalVotes</entry>
  827. <entry>string</entry>
  828. <entry>Gesamtzahl der Stimmen</entry>
  829. </row>
  830. <row>
  831. <entry>Date</entry>
  832. <entry>string</entry>
  833. <entry>Datum der Review</entry>
  834. </row>
  835. <row>
  836. <entry>Summary</entry>
  837. <entry>string</entry>
  838. <entry>Zusammenfassung der Review</entry>
  839. </row>
  840. <row>
  841. <entry>Content</entry>
  842. <entry>string</entry>
  843. <entry>Inhalt der Review</entry>
  844. </row>
  845. </tbody>
  846. </tgroup>
  847. </table>
  848. <para>
  849. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  850. </para>
  851. </sect4>
  852. </sect3>
  853. <sect3 id="zend.service.amazon.classes.editorialreview">
  854. <title>Zend_Service_Amazon_EditorialReview</title>
  855. <para>
  856. Jede Editorial review des Teils wird als
  857. <classname>Zend_Service_Amazon_EditorialReview</classname> Objekt zurückgegeben.
  858. </para>
  859. <sect4 id="zend.service.amazon.classes.editorialreview.properties">
  860. <title>Eigenschaften</title>
  861. <table id="zend.service.amazon.classes.editorialreview.properties.table-1">
  862. <title>Zend_Service_Amazon_EditorialReview Eigenschaften</title>
  863. <tgroup cols="3">
  864. <thead>
  865. <row>
  866. <entry>Name</entry>
  867. <entry>Typ</entry>
  868. <entry>Beschreibung</entry>
  869. </row>
  870. </thead>
  871. <tbody>
  872. <row>
  873. <entry>Source</entry>
  874. <entry>string</entry>
  875. <entry>Quelle der Editorial Review</entry>
  876. </row>
  877. <row>
  878. <entry>Content</entry>
  879. <entry>string</entry>
  880. <entry>Inhalt des Reviews</entry>
  881. </row>
  882. </tbody>
  883. </tgroup>
  884. </table>
  885. <para>
  886. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  887. </para>
  888. </sect4>
  889. </sect3>
  890. <sect3 id="zend.service.amazon.classes.listmania">
  891. <title>Zend_Service_Amazon_Listmania</title>
  892. <para>
  893. Jedes List Mania List Ergebnis des Teils wird als
  894. <classname>Zend_Service_Amazon_Listmania</classname> Objekt zurückgegeben.
  895. </para>
  896. <sect4 id="zend.service.amazon.classes.listmania.properties">
  897. <title>Eigenschaften</title>
  898. <table id="zend.service.amazon.classes.listmania.properties.table-1">
  899. <title>Zend_Service_Amazon_Listmania Eigenschaften</title>
  900. <tgroup cols="3">
  901. <thead>
  902. <row>
  903. <entry>Name</entry>
  904. <entry>Typ</entry>
  905. <entry>Beschreibung</entry>
  906. </row>
  907. </thead>
  908. <tbody>
  909. <row>
  910. <entry>ListId</entry>
  911. <entry>string</entry>
  912. <entry>ID der Liste</entry>
  913. </row>
  914. <row>
  915. <entry>ListName</entry>
  916. <entry>string</entry>
  917. <entry>Name der Liste</entry>
  918. </row>
  919. </tbody>
  920. </tgroup>
  921. </table>
  922. <para>
  923. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  924. </para>
  925. </sect4>
  926. </sect3>
  927. </sect2>
  928. </sect1>
  929. <!--
  930. vim:se ts=4 sw=4 et:
  931. -->