Zend_Service_Amazon.xml 45 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 17175 -->
  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 ASIN 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>ASIN</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 DVDs
  439. </entry>
  440. </row>
  441. <row>
  442. <entry>ListmaniaLists</entry>
  443. <entry>array</entry>
  444. <entry>
  445. Passende Listmania Liste für diese Teil, als Array von
  446. <code>
  447. <link
  448. linkend="zend.service.amazon.classes.listmania">Zend_Service_Amazon_ListmainList</link>
  449. </code>
  450. Objekten
  451. </entry>
  452. </row>
  453. <row>
  454. <entry>PromotionalTag</entry>
  455. <entry>string</entry>
  456. <entry>Promotion Tag des Teils</entry>
  457. </row>
  458. </tbody>
  459. </tgroup>
  460. </table>
  461. <para>
  462. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  463. </para>
  464. </sect4>
  465. </sect3>
  466. <sect3 id="zend.service.amazon.classes.image">
  467. <title>Zend_Service_Amazon_Image</title>
  468. <para>
  469. <classname>Zend_Service_Amazon_Image</classname> repräsentiert ein entferntes Bild
  470. für ein Produkt.
  471. </para>
  472. <sect4 id="zend.service.amazon.classes.image.properties">
  473. <title>Eigenschaften</title>
  474. <table id="zend.service.amazon.classes.image.properties.table-1">
  475. <title>Zend_Service_Amazon_Image Eigenschaften</title>
  476. <tgroup cols="3">
  477. <thead>
  478. <row>
  479. <entry>Name</entry>
  480. <entry>Typ</entry>
  481. <entry>Beschreibung</entry>
  482. </row>
  483. </thead>
  484. <tbody>
  485. <row>
  486. <entry>Url</entry>
  487. <entry>Zend_Uri</entry>
  488. <entry>Entfernte URL für das Bild</entry>
  489. </row>
  490. <row>
  491. <entry>Height</entry>
  492. <entry>int</entry>
  493. <entry>Die Höhe des Bildes als Pixel</entry>
  494. </row>
  495. <row>
  496. <entry>Width</entry>
  497. <entry>int</entry>
  498. <entry>Die Breite des Bildes als Pixel</entry>
  499. </row>
  500. </tbody>
  501. </tgroup>
  502. </table>
  503. <para>
  504. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  505. </para>
  506. </sect4>
  507. </sect3>
  508. <sect3 id="zend.service.amazon.classes.resultset">
  509. <title>Zend_Service_Amazon_ResultSet</title>
  510. <para>
  511. <classname>Zend_Service_Amazon_ResultSet</classname> Objekte werden zurückgegeben
  512. durch <link
  513. linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link>
  514. und erlauben es, die vielfach zurück gelieferten Resultate, einfachst zu Handhaben.
  515. </para>
  516. <note>
  517. <title>SeekableIterator</title>
  518. <para>
  519. Implementiert den <code>SeekableIterator</code> für einfach Iteration
  520. (z.B. benutzen von <code>foreach</code>), sowie direkten Zugriff auf ein
  521. Spezielles Resultat mit <methodname>seek()</methodname>.
  522. </para>
  523. </note>
  524. <sect4 id="zend.service.amazon.classes.resultset.totalresults">
  525. <title>Zend_Service_Amazon_ResultSet::totalResults()</title>
  526. <methodsynopsis>
  527. <type>int</type>
  528. <methodname>totalResults</methodname>
  529. <void />
  530. </methodsynopsis>
  531. <para>
  532. Liefert die Gesamtanzahl der Resultate welche die Suche zurückgegeben hat
  533. </para>
  534. <para>
  535. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  536. </para>
  537. </sect4>
  538. </sect3>
  539. <sect3 id="zend.service.amazon.classes.offerset">
  540. <title>Zend_Service_Amazon_OfferSet</title>
  541. <para>
  542. Jedes Resultat welches durch <link
  543. linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link>
  544. und <link
  545. linkend="zend.service.amazon.itemlookup">Zend_Service_Amazon::itemLookup()</link>
  546. zurückgegeben wird beinhaltet ein
  547. <classname>Zend_Service_Amazon_OfferSet</classname>
  548. Objekt durch welches Preisinformationen für das Teil empfangen werden können.
  549. </para>
  550. <sect4 id="zend.service.amazon.classes.offerset.parameters">
  551. <title>Eigenschaften</title>
  552. <table id="zend.service.amazon.classes.offerset.parameters.table-1">
  553. <title>Zend_Service_Amazon_OfferSet Properties</title>
  554. <tgroup cols="3">
  555. <thead>
  556. <row>
  557. <entry>Name</entry>
  558. <entry>Typ</entry>
  559. <entry>Beschreibung</entry>
  560. </row>
  561. </thead>
  562. <tbody>
  563. <row>
  564. <entry>LowestNewPrice</entry>
  565. <entry>int</entry>
  566. <entry>Niedrigster Preis des Teiles als &quot;Neuwert&quot;</entry>
  567. </row>
  568. <row>
  569. <entry>LowestNewPriceCurrency</entry>
  570. <entry>string</entry>
  571. <entry>
  572. Die Währung für
  573. <code>LowestNewPrice</code>
  574. </entry>
  575. </row>
  576. <row>
  577. <entry>LowestOldPrice</entry>
  578. <entry>int</entry>
  579. <entry>
  580. Niedrigster Preis des Teiles als &quot;Gebrauchtwert&quot;
  581. </entry>
  582. </row>
  583. <row>
  584. <entry>LowestOldPriceCurrency</entry>
  585. <entry>string</entry>
  586. <entry>
  587. Die Währung für
  588. <code>LowestOldPrice</code>
  589. </entry>
  590. </row>
  591. <row>
  592. <entry>TotalNew</entry>
  593. <entry>int</entry>
  594. <entry>
  595. Erhältliche Gesamtanzahl dieses Teils mit &quot;Neuwert&quot;
  596. </entry>
  597. </row>
  598. <row>
  599. <entry>TotalUsed</entry>
  600. <entry>int</entry>
  601. <entry>
  602. Erhältliche Gesamtanzahl dieses Teils mit
  603. &quot;Gebrauchtwert&quot;
  604. </entry>
  605. </row>
  606. <row>
  607. <entry>TotalCollectible</entry>
  608. <entry>int</entry>
  609. <entry>
  610. Erhältliche Gesamtanzahl dieses Teils die &quot;Sammelbar&quot;
  611. sind
  612. </entry>
  613. </row>
  614. <row>
  615. <entry>TotalRefurbished</entry>
  616. <entry>int</entry>
  617. <entry>
  618. Erhältliche Gesamtanzahl dieses Teils die
  619. &quot;Wiederhergestellt&quot; sind
  620. </entry>
  621. </row>
  622. <row>
  623. <entry>Offers</entry>
  624. <entry>array</entry>
  625. <entry>
  626. Ein Array von
  627. <classname>Zend_Service_Amazon_Offer</classname>
  628. Objekten.
  629. </entry>
  630. </row>
  631. </tbody>
  632. </tgroup>
  633. </table>
  634. <para>
  635. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  636. </para>
  637. </sect4>
  638. </sect3>
  639. <sect3 id="zend.service.amazon.classes.offer">
  640. <title>Zend_Service_Amazon_Offer</title>
  641. <para>
  642. Jedes Angebot für ein Teil wird als
  643. <classname>Zend_Service_Amazon_Offer</classname>
  644. Objekt zurück gegeben.
  645. </para>
  646. <sect4 id="zend.service.amazon.classes.offer.properties">
  647. <title>Zend_Service_Amazon_Offer Eigenschaften</title>
  648. <table id="zend.service.amazon.classes.offer.properties.table-1">
  649. <title>Eigenschaften</title>
  650. <tgroup cols="3">
  651. <thead>
  652. <row>
  653. <entry>Name</entry>
  654. <entry>Typ</entry>
  655. <entry>Beschreibung</entry>
  656. </row>
  657. </thead>
  658. <tbody>
  659. <row>
  660. <entry>MerchantId</entry>
  661. <entry>string</entry>
  662. <entry>Amazon ID des Anbieters</entry>
  663. </row>
  664. <row>
  665. <entry>GlancePage</entry>
  666. <entry>string</entry>
  667. <entry>
  668. URL einer Seite mit einer Zusammenfassung des Anbieters
  669. </entry>
  670. </row>
  671. <row>
  672. <entry>Condition</entry>
  673. <entry>string</entry>
  674. <entry>Kondition des Teils</entry>
  675. </row>
  676. <row>
  677. <entry>OfferListingId</entry>
  678. <entry>string</entry>
  679. <entry>ID der Angebots Liste</entry>
  680. </row>
  681. <row>
  682. <entry>Price</entry>
  683. <entry>int</entry>
  684. <entry>Preis für das Teil</entry>
  685. </row>
  686. <row>
  687. <entry>CurrencyCode</entry>
  688. <entry>string</entry>
  689. <entry>Währungscode des Preises für das Teil</entry>
  690. </row>
  691. <row>
  692. <entry>Availability</entry>
  693. <entry>string</entry>
  694. <entry>Erhältlichkeit des Teils</entry>
  695. </row>
  696. <row>
  697. <entry>IsEligibleForSuperSaverShipping</entry>
  698. <entry>boolean</entry>
  699. <entry>
  700. Ob das Teil erhältlich ist für Super Sicheren Versand oder nicht
  701. </entry>
  702. </row>
  703. </tbody>
  704. </tgroup>
  705. </table>
  706. <para>
  707. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  708. </para>
  709. </sect4>
  710. </sect3>
  711. <sect3 id="zend.service.amazon.classes.similarproduct">
  712. <title>Zend_Service_Amazon_SimilarProduct</title>
  713. <para>
  714. Bei der Suche nach Teilen gibt Amazon auch eine Liste an ähnlichen Produkten zurück,
  715. welche dem Suchenden empfohlen werden. Jedes dieser Produkte wird als
  716. <classname>Zend_Service_Amazon_SimilarProduct</classname> Objekt zurückgegeben.
  717. </para>
  718. <para>
  719. Jedes Objekt enthält die Informationen welche es erlauben eine Subanfrage zu machen,
  720. um die kompletten Informationen zu diesem Teil zu bekommen.
  721. </para>
  722. <sect4 id="zend.service.amazon.classes.similarproduct.properties">
  723. <title>Eigenschaften</title>
  724. <table id="zend.service.amazon.classes.similarproduct.properties.table-1">
  725. <title>Zend_Service_Amazon_SimilarProduct Eigenschaften</title>
  726. <tgroup cols="3">
  727. <thead>
  728. <row>
  729. <entry>Name</entry>
  730. <entry>Typ</entry>
  731. <entry>Beschreibung</entry>
  732. </row>
  733. </thead>
  734. <tbody>
  735. <row>
  736. <entry>ASIN</entry>
  737. <entry>string</entry>
  738. <entry>Eindeutige Amazon ID des Produkts (ASIN)</entry>
  739. </row>
  740. <row>
  741. <entry>Title</entry>
  742. <entry>string</entry>
  743. <entry>Produkt Überschrift</entry>
  744. </row>
  745. </tbody>
  746. </tgroup>
  747. </table>
  748. <para>
  749. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  750. </para>
  751. </sect4>
  752. </sect3>
  753. <sect3 id="zend.service.amazon.classes.accessories">
  754. <title>Zend_Service_Amazon_Accessories</title>
  755. <para>
  756. Zubehör für das zurückgegebene Teil werden als
  757. <classname>Zend_Service_Amazon_Accessories</classname> Objekte dargestellt.
  758. </para>
  759. <sect4 id="zend.service.amazon.classes.accessories.properties">
  760. <title>Eigenschaften</title>
  761. <table id="zend.service.amazon.classes.accessories.properties.table-1">
  762. <title>Zend_Service_Amazon_Accessories Eigenschaften</title>
  763. <tgroup cols="3">
  764. <thead>
  765. <row>
  766. <entry>Name</entry>
  767. <entry>Typ</entry>
  768. <entry>Beschreibung</entry>
  769. </row>
  770. </thead>
  771. <tbody>
  772. <row>
  773. <entry>ASIN</entry>
  774. <entry>string</entry>
  775. <entry>Eindeutige Amazon ID des Produkts (ASIN)</entry>
  776. </row>
  777. <row>
  778. <entry>Title</entry>
  779. <entry>string</entry>
  780. <entry>Produkt Überschrift</entry>
  781. </row>
  782. </tbody>
  783. </tgroup>
  784. </table>
  785. <para>
  786. <link linkend="zend.service.amazon.classes">Back to Class List</link>
  787. </para>
  788. </sect4>
  789. </sect3>
  790. <sect3 id="zend.service.amazon.classes.customerreview">
  791. <title>Zend_Service_Amazon_CustomerReview</title>
  792. <para>
  793. Jede Kunden Review wird als
  794. <classname>Zend_Service_Amazon_CustomerReview</classname> Objekt zurückgegeben.
  795. </para>
  796. <sect4 id="zend.service.amazon.classes.customerreview.properties">
  797. <title>Eigenschaften</title>
  798. <table id="zend.service.amazon.classes.customerreview.properties.table-1">
  799. <title>Zend_Service_Amazon_CustomerReview Eigenschaften</title>
  800. <tgroup cols="3">
  801. <thead>
  802. <row>
  803. <entry>Name</entry>
  804. <entry>Typ</entry>
  805. <entry>Beschreibung</entry>
  806. </row>
  807. </thead>
  808. <tbody>
  809. <row>
  810. <entry>Rating</entry>
  811. <entry>string</entry>
  812. <entry>Bewertung des Teils</entry>
  813. </row>
  814. <row>
  815. <entry>HelpfulVotes</entry>
  816. <entry>string</entry>
  817. <entry>Stimmen wie hilfreich die Review ist</entry>
  818. </row>
  819. <row>
  820. <entry>CustomerId</entry>
  821. <entry>string</entry>
  822. <entry>Kunden ID</entry>
  823. </row>
  824. <row>
  825. <entry>TotalVotes</entry>
  826. <entry>string</entry>
  827. <entry>Gesamtzahl der Stimmen</entry>
  828. </row>
  829. <row>
  830. <entry>Date</entry>
  831. <entry>string</entry>
  832. <entry>Datum der Review</entry>
  833. </row>
  834. <row>
  835. <entry>Summary</entry>
  836. <entry>string</entry>
  837. <entry>Zusammenfassung der Review</entry>
  838. </row>
  839. <row>
  840. <entry>Content</entry>
  841. <entry>string</entry>
  842. <entry>Inhalt der Review</entry>
  843. </row>
  844. </tbody>
  845. </tgroup>
  846. </table>
  847. <para>
  848. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  849. </para>
  850. </sect4>
  851. </sect3>
  852. <sect3 id="zend.service.amazon.classes.editorialreview">
  853. <title>Zend_Service_Amazon_EditorialReview</title>
  854. <para>
  855. Jede Editorial review des Teils wird als
  856. <classname>Zend_Service_Amazon_EditorialReview</classname> Objekt zurückgegeben.
  857. </para>
  858. <sect4 id="zend.service.amazon.classes.editorialreview.properties">
  859. <title>Eigenschaften</title>
  860. <table id="zend.service.amazon.classes.editorialreview.properties.table-1">
  861. <title>Zend_Service_Amazon_EditorialReview Eigenschaften</title>
  862. <tgroup cols="3">
  863. <thead>
  864. <row>
  865. <entry>Name</entry>
  866. <entry>Typ</entry>
  867. <entry>Beschreibung</entry>
  868. </row>
  869. </thead>
  870. <tbody>
  871. <row>
  872. <entry>Source</entry>
  873. <entry>string</entry>
  874. <entry>Quelle der Editorial Review</entry>
  875. </row>
  876. <row>
  877. <entry>Content</entry>
  878. <entry>string</entry>
  879. <entry>Inhalt des Reviews</entry>
  880. </row>
  881. </tbody>
  882. </tgroup>
  883. </table>
  884. <para>
  885. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  886. </para>
  887. </sect4>
  888. </sect3>
  889. <sect3 id="zend.service.amazon.classes.listmania">
  890. <title>Zend_Service_Amazon_Listmania</title>
  891. <para>
  892. Jedes List Mania List Ergebnis des Teils wird als
  893. <classname>Zend_Service_Amazon_Listmania</classname> Objekt zurückgegeben.
  894. </para>
  895. <sect4 id="zend.service.amazon.classes.listmania.properties">
  896. <title>Eigenschaften</title>
  897. <table id="zend.service.amazon.classes.listmania.properties.table-1">
  898. <title>Zend_Service_Amazon_Listmania Eigenschaften</title>
  899. <tgroup cols="3">
  900. <thead>
  901. <row>
  902. <entry>Name</entry>
  903. <entry>Typ</entry>
  904. <entry>Beschreibung</entry>
  905. </row>
  906. </thead>
  907. <tbody>
  908. <row>
  909. <entry>ListId</entry>
  910. <entry>string</entry>
  911. <entry>ID der Liste</entry>
  912. </row>
  913. <row>
  914. <entry>ListName</entry>
  915. <entry>string</entry>
  916. <entry>Name der Liste</entry>
  917. </row>
  918. </tbody>
  919. </tgroup>
  920. </table>
  921. <para>
  922. <link linkend="zend.service.amazon.classes">Zurück zur Liste der Klassen</link>
  923. </para>
  924. </sect4>
  925. </sect3>
  926. </sect2>
  927. </sect1>
  928. <!--
  929. vim:se ts=4 sw=4 et:
  930. -->