Zend_Service_Amazon.xml 43 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 15617 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.service.amazon">
  5. <title>Zend_Service_Amazon</title>
  6. <sect2 id="zend.service.amazon.introduction">
  7. <title>Introduction</title>
  8. <para>
  9. <classname>Zend_Service_Amazon</classname> est une API simple pour utiliser les
  10. Web services d'Amazon. <classname>Zend_Service_Amazon</classname> a deux APIs : une
  11. plutôt traditionnelle qui suit la propre API d'Amazon, et un "Query API" simplifiée pour
  12. construire facilement des requêtes de recherche, même compliquées.
  13. </para>
  14. <para>
  15. <classname>Zend_Service_Amazon</classname> permet aux développeurs de récupérer
  16. des informations disponible sur le site Amazon.com directement à travers l'API Amazon
  17. Web Services. Les exemples incluent : <itemizedlist>
  18. <listitem>
  19. <para>
  20. Le stockage de données informatives, comme des images, des
  21. descriptions, le prix et plus
  22. </para>
  23. </listitem>
  24. <listitem>
  25. <para>Revues éditoriales et commerciales</para>
  26. </listitem>
  27. <listitem>
  28. <para>Des produits et accessoires similaires</para>
  29. </listitem>
  30. <listitem>
  31. <para>Les offres Amazon.com</para>
  32. </listitem>
  33. <listitem>
  34. <para>Les listes ListMania</para>
  35. </listitem>
  36. </itemizedlist>
  37. </para>
  38. <para>
  39. Pour pouvoir utiliser <classname>Zend_Service_Amazon</classname>, vous devez avant
  40. tout avoir une clé "developer API" Amazon. Pour obtenir une telle clé et pour plus
  41. d'informations, vous pouvez visitez le site Web <ulink
  42. url="http://www.amazon.com/gp/aws/landing.html">Amazon Web Services</ulink>.
  43. </para>
  44. <note>
  45. <title>Attention</title>
  46. <para>
  47. Votre clé "developer API" est liée à votre identité Amazon, donc faites en
  48. sorte de conserver votre clé d'API privée.
  49. </para>
  50. </note>
  51. <example id="zend.service.amazon.introduction.example.itemsearch">
  52. <title>Recherche sur Amazon en utilisant l'API traditionnelle</title>
  53. <para>
  54. Dans cet exemple, nous recherchons les livres sur PHP disponibles chez Amazon
  55. et boucler sur les résultats pour les afficher.
  56. </para>
  57. <programlisting language="php"><![CDATA[
  58. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY');
  59. $response = $amazon->itemSearch(array('SearchIndex' => 'Books',
  60. 'Keywords' => 'php'));
  61. $results = $amazon->itemSearch(array('SearchIndex' => 'Books',
  62. 'Keywords' => 'php'));
  63. foreach ($results as $result) {
  64. echo $result->Title . '<br />';
  65. }
  66. ]]></programlisting>
  67. </example>
  68. <example id="zend.service.amazon.introduction.example.query_api">
  69. <title>Recherche sur Amazon en utilisant l'API de requête</title>
  70. <para>
  71. Ici nous cherchons aussi les livres sur PHP disponibles chez Amazon, mais en
  72. utilisant l'API de requête, qui ressemble au modèle de conception Interface
  73. Fluide.
  74. </para>
  75. <programlisting language="php"><![CDATA[
  76. $query = new Zend_Service_Amazon_Query('AMAZON_API_KEY');
  77. $query->category('Books')->Keywords('PHP');
  78. $results = $query->search();
  79. foreach ($results as $result) {
  80. echo $result->Title . '<br />';
  81. }
  82. ]]></programlisting>
  83. </example>
  84. </sect2>
  85. <sect2 id="zend.service.amazon.countrycodes">
  86. <title>Codes de pays</title>
  87. <para>
  88. Par défaut, <classname>Zend_Service_Amazon</classname> se connecte au Web service
  89. Amazon américain ("<code>US</code>"). Pour se connecter depuis un pays différent, il
  90. vous suffit simplement de définir, comme second paramètre du constructeur, la chaîne de
  91. caractère correspondant au code du pays :
  92. </para>
  93. <example id="zend.service.amazon.countrycodes.example.country_code">
  94. <title>Choisir un service Web Amazon d'un pays</title>
  95. <programlisting language="php"><![CDATA[
  96. // Connexion à Amazon France
  97. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'FR');
  98. ]]></programlisting>
  99. </example>
  100. <note>
  101. <title>Codes de pays</title>
  102. <para>
  103. Les codes de pays valides sont <code>CA</code>, <code>DE</code>,
  104. <code>FR</code>, <code>JP</code>, <code>UK</code>, et <code>US</code>.
  105. </para>
  106. </note>
  107. </sect2>
  108. <sect2 id="zend.service.amazon.itemlookup">
  109. <title>Rechercher un produit Amazon spécifique avec son ASIN</title>
  110. <para>
  111. La méthode <code>itemLookup()</code> fournit la possibilité de rechercher un
  112. produit Amazon particulier lorsque son ASIN est connu.
  113. </para>
  114. <example>
  115. <title>Rechercher une produit Amazon spécifique avec son ASIN</title>
  116. <programlisting language="php"><![CDATA[
  117. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY');
  118. $item = $amazon->itemLookup('B0000A432X');
  119. ]]></programlisting>
  120. </example>
  121. <para>
  122. La méthode <code>itemLookup()</code> accepte aussi un second paramètre optionnel
  123. pour gérer les options de recherche. Pour les détails complets et une liste des options
  124. disponibles, visitez <ulink
  125. url="http://www.amazon.com/gp/aws/sdk/main.html/103-9285448-4703844?s=AWSEcommerceService&amp;v=2005-10-05&amp;p=ApiReference/ItemLookupOperation">
  126. la documentation Amazon correspondante. </ulink>.
  127. </para>
  128. <note>
  129. <title>Information sur les images</title>
  130. <para>
  131. Pour récupérer les informations d'images pour vos résultats de recherche, vous
  132. devez définir l'option <code>ResponseGroup</code> à <code>Medium</code> ou
  133. <code>Large</code>.
  134. </para>
  135. </note>
  136. </sect2>
  137. <sect2 id="zend.service.amazon.itemsearch">
  138. <title>Lancer des recherches de produits sur Amazon</title>
  139. <para>
  140. Rechercher des produits basés sur tous les divers critères disponibles sont rendus
  141. simples grâce à la méthode <code>itemSearch()</code>, comme le montre l'exemple suivant
  142. :
  143. </para>
  144. <example id="zend.service.amazon.itemsearch.example.basic">
  145. <title>Lancer des recherches de produits sur Amazon</title>
  146. <programlisting language="php"><![CDATA[
  147. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY');
  148. $results = $amazon->itemSearch(array('SearchIndex' => 'Books',
  149. 'Keywords' => 'php'));
  150. foreach ($results as $result) {
  151. echo $result->Title . '<br />';
  152. }
  153. ]]></programlisting>
  154. </example>
  155. <example id="zend.service.amazon.itemsearch.example.responsegroup">
  156. <title>Utilisation de l'option <code>ResponseGroup</code></title>
  157. <para>
  158. L'option <code>ResponseGroup</code> est utilisée pour contrôler les
  159. informations spécifiques qui sont retournées dans la réponse.
  160. </para>
  161. <programlisting language="php"><![CDATA[
  162. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY');
  163. $results = $amazon->itemSearch(array(
  164. 'SearchIndex' => 'Books',
  165. 'Keywords' => 'php',
  166. 'ResponseGroup' => 'Small,ItemAttributes,Images,'
  167. . 'SalesRank,Reviews,EditorialReview,'
  168. . 'Similarities,ListmaniaLists'
  169. ));
  170. foreach ($results as $result) {
  171. echo $result->Title . '<br />';
  172. }
  173. ]]></programlisting>
  174. </example>
  175. <para>
  176. La méthode <code>itemSearch()</code> accepte un seul tableau en paramètre pour
  177. gérer les options de recherche. Pour plus de détails et une liste des options
  178. disponibles, visitez <ulink
  179. url="http://www.amazon.com/gp/aws/sdk/main.html/103-9285448-4703844?s=AWSEcommerceService&amp;v=2005-10-05&amp;p=ApiReference/ItemSearchOperation">
  180. la documentation Amazon correspondante </ulink>
  181. </para>
  182. <tip>
  183. <para>
  184. La classe <link
  185. linkend="zend.service.amazon.query"><classname>Zend_Service_Amazon_Query</classname></link>
  186. est une enveloppe simple d'utilisation de cette méthode.
  187. </para>
  188. </tip>
  189. </sect2>
  190. <sect2 id="zend.service.amazon.query">
  191. <title>Utiliser l'API alternative de requêtes</title>
  192. <sect3 id="zend.service.amazon.query.introduction">
  193. <title>Introduction</title>
  194. <para>
  195. <classname>Zend_Service_Amazon_Query</classname> fournit une API alternative
  196. pour utiliser le service Web Amazon. L'API alternative utilise le modèle de
  197. conception 'Interface Fluide'. C'est à dire que les appels peuvent-être fait en
  198. utilisant une chaîne d'appels de méthodes (ie
  199. <code>$obj-&gt;method()-&gt;method2($arg)</code>)
  200. </para>
  201. <para>
  202. L'API <classname>Zend_Service_Amazon_Query</classname> utilise la surcharge
  203. pour mettre en place facilement une recherche d'article, et ainsi vous permettre de
  204. chercher en se basant sur les critères spécifiés. Chacune de ces options est fournie
  205. en tant qu'appel de méthode, et chaque paramètre de méthode correspond à la valeur
  206. des options nommées.
  207. </para>
  208. <example id="zend.service.amazon.query.introduction.example.basic">
  209. <title>Rechercher sur Amazon en utilisant l'API alternative de requêtes</title>
  210. <para>
  211. Dans cet exemple, l'API de requêtes alternative est utilisée comme une
  212. interface fluide pour spécifier les options et leurs valeurs respectives
  213. :
  214. </para>
  215. <programlisting language="php"><![CDATA[
  216. $query = new Zend_Service_Amazon_Query('MY_API_KEY');
  217. $query->Category('Books')->Keywords('PHP');
  218. $results = $query->search();
  219. foreach ($results as $result) {
  220. echo $result->Title . '<br />';
  221. }
  222. ]]></programlisting>
  223. <para>
  224. Cela définit l'option <code>Category</code> à "Livres" et
  225. <code>Keywords</code> à "PHP".
  226. </para>
  227. <para>
  228. Pour plus d'information sur les options disponibles, vous pouvez vous
  229. référer à la <ulink
  230. url="http://www.amazon.com/gp/aws/sdk/main.html/102-9041115-9057709?s=AWSEcommerceService&amp;v=2005-10-05&amp;p=ApiReference/ItemSearchOperation">documentation
  231. spécifique</ulink>.
  232. </para>
  233. </example>
  234. </sect3>
  235. </sect2>
  236. <sect2 id="zend.service.amazon.classes">
  237. <title>Classes Zend_Service_Amazon</title>
  238. <para>
  239. Les classes suivantes sont toutes retournées par <link
  240. linkend="zend.service.amazon.itemlookup"><classname>Zend_Service_Amazon::itemLookup()</classname></link>
  241. et <link
  242. linkend="zend.service.amazon.itemsearch"><classname>Zend_Service_Amazon::itemSearch()</classname></link>:
  243. <itemizedlist>
  244. <listitem>
  245. <para>
  246. <link
  247. linkend="zend.service.amazon.classes.item"><classname>Zend_Service_Amazon_Item</classname></link>
  248. </para>
  249. </listitem>
  250. <listitem>
  251. <para>
  252. <link
  253. linkend="zend.service.amazon.classes.image"><classname>Zend_Service_Amazon_Image</classname></link>
  254. </para>
  255. </listitem>
  256. <listitem>
  257. <para>
  258. <link
  259. linkend="zend.service.amazon.classes.resultset"><classname>Zend_Service_Amazon_ResultSet</classname></link>
  260. </para>
  261. </listitem>
  262. <listitem>
  263. <para>
  264. <link
  265. linkend="zend.service.amazon.classes.offerset"><classname>Zend_Service_Amazon_OfferSet</classname></link>
  266. </para>
  267. </listitem>
  268. <listitem>
  269. <para>
  270. <link
  271. linkend="zend.service.amazon.classes.offer"><classname>Zend_Service_Amazon_Offer</classname></link>
  272. </para>
  273. </listitem>
  274. <listitem>
  275. <para>
  276. <link
  277. linkend="zend.service.amazon.classes.similarproduct"><classname>Zend_Service_Amazon_SimilarProduct</classname></link>
  278. </para>
  279. </listitem>
  280. <listitem>
  281. <para>
  282. <link
  283. linkend="zend.service.amazon.classes.accessories"><classname>Zend_Service_Amazon_Accessories</classname></link>
  284. </para>
  285. </listitem>
  286. <listitem>
  287. <para>
  288. <link
  289. linkend="zend.service.amazon.classes.customerreview"><classname>Zend_Service_Amazon_CustomerReview</classname></link>
  290. </para>
  291. </listitem>
  292. <listitem>
  293. <para>
  294. <link
  295. linkend="zend.service.amazon.classes.editorialreview"><classname>Zend_Service_Amazon_EditorialReview</classname></link>
  296. </para>
  297. </listitem>
  298. <listitem>
  299. <para>
  300. <link
  301. linkend="zend.service.amazon.classes.listmania"><classname>Zend_Service_Amazon_ListMania</classname></link>
  302. </para>
  303. </listitem>
  304. </itemizedlist>
  305. </para>
  306. <sect3 id="zend.service.amazon.classes.item">
  307. <title>Zend_Service_Amazon_Item</title>
  308. <para>
  309. <classname>Zend_Service_Amazon_Item</classname> est le type de classe utilisé
  310. pour représenter un produit Amazon retourné par le service Web. Elle récupère tous
  311. les attributs des articles, incluant le titre, la description, les revues,
  312. etc.
  313. </para>
  314. <sect4 id="zend.service.amazon.classes.item.asxml">
  315. <title>Zend_Service_Amazon_Item::asXML()</title>
  316. <para>
  317. <methodsynopsis>
  318. <type>string</type>
  319. <methodname>asXML</methodname>
  320. <void />
  321. </methodsynopsis>
  322. </para>
  323. <para>Retourne le XML original de l'article</para>
  324. </sect4>
  325. <sect4 id="zend.service.amazon.classes.item.properties">
  326. <title>Propriétés</title>
  327. <para>
  328. <classname>Zend_Service_Amazon_Item</classname> a un nombre de propriétés
  329. directement relié à leur contre-parties de l'API standard Amazon.
  330. </para>
  331. <table id="zend.service.amazon.classes.item.properties.table-1">
  332. <title>Propriétés de Zend_Service_Amazon_Item</title>
  333. <tgroup cols="3">
  334. <thead>
  335. <row>
  336. <entry>Nom</entry>
  337. <entry>Type</entry>
  338. <entry>Description</entry>
  339. </row>
  340. </thead>
  341. <tbody>
  342. <row>
  343. <entry>ASIN</entry>
  344. <entry>string</entry>
  345. <entry>Amazon Item ID</entry>
  346. </row>
  347. <row>
  348. <entry>DetailPageURL</entry>
  349. <entry>string</entry>
  350. <entry>URL pour la page de détail des articles</entry>
  351. </row>
  352. <row>
  353. <entry>SalesRank</entry>
  354. <entry>int</entry>
  355. <entry>Niveau de vente pour cet article</entry>
  356. </row>
  357. <row>
  358. <entry>SmallImage</entry>
  359. <entry>Zend_Service_Amazon_Image</entry>
  360. <entry>Petite image de l'article</entry>
  361. </row>
  362. <row>
  363. <entry>MediumImage</entry>
  364. <entry>Zend_Service_Amazon_Image</entry>
  365. <entry>Image moyenne de l'article</entry>
  366. </row>
  367. <row>
  368. <entry>LargeImage</entry>
  369. <entry>Zend_Service_Amazon_Image</entry>
  370. <entry>Grande image de l'article</entry>
  371. </row>
  372. <row>
  373. <entry>Subjects</entry>
  374. <entry>array</entry>
  375. <entry>Sujets de l'article</entry>
  376. </row>
  377. <row>
  378. <entry>Les offres</entry>
  379. <entry><code> <link
  380. linkend="zend.service.amazon.classes.offerset">Zend_Service_Amazon_OfferSet</link>
  381. </code></entry>
  382. <entry>Sommaire des offres, et offres pour l'article</entry>
  383. </row>
  384. <row>
  385. <entry>CustomerReviews</entry>
  386. <entry>array</entry>
  387. <entry>Les revues clients sont représentées comme un tableau
  388. d'objets <code> <link
  389. linkend="zend.service.amazon.classes.customerreview">Zend_Service_Amazon_CustomerReview</link>
  390. </code></entry>
  391. </row>
  392. <row>
  393. <entry>EditorialReviews</entry>
  394. <entry>array</entry>
  395. <entry>Les revues éditoriales sont représentées comme un tableau
  396. d'objets <code> <link
  397. linkend="zend.service.amazon.classes.editorialreview">Zend_Service_Amazon_EditorialReview</link>
  398. </code></entry>
  399. </row>
  400. <row>
  401. <entry>SimilarProducts</entry>
  402. <entry>array</entry>
  403. <entry>Les produits similaires sont représentés comme un tableau
  404. d'objets <code> <link
  405. linkend="zend.service.amazon.classes.similarproduct">Zend_Service_Amazon_SimilarProduct</link>
  406. </code></entry>
  407. </row>
  408. <row>
  409. <entry>Accessories</entry>
  410. <entry>array</entry>
  411. <entry>Les accessoires pour l'article sont représentés comme un
  412. tableau d'objets <code> <link
  413. linkend="zend.service.amazon.classes.accessories">Zend_Service_Amazon_Accessories</link>
  414. </code></entry>
  415. </row>
  416. <row>
  417. <entry>Tracks</entry>
  418. <entry>array</entry>
  419. <entry>Un tableau contenant le nombre de pistes ainsi que les
  420. noms pour les CDs ou DVDs musicaux</entry>
  421. </row>
  422. <row>
  423. <entry>ListmaniaLists</entry>
  424. <entry>array</entry>
  425. <entry>Les listes Listmania reliées à un article, comme un
  426. tableau d'objets <code> <link
  427. linkend="zend.service.amazon.classes.listmania">Zend_Service_Amazon_ListmaniaList</link>
  428. </code></entry>
  429. </row>
  430. <row>
  431. <entry>PromotionalTag</entry>
  432. <entry>string</entry>
  433. <entry>Balise promotionnelle de l'article</entry>
  434. </row>
  435. </tbody>
  436. </tgroup>
  437. </table>
  438. <para>
  439. <link linkend="zend.service.amazon.classes">Retour à la liste des
  440. classes</link>
  441. </para>
  442. </sect4>
  443. </sect3>
  444. <sect3 id="zend.service.amazon.classes.image">
  445. <title>Zend_Service_Amazon_Image</title>
  446. <para>
  447. <classname>Zend_Service_Amazon_Image</classname> représente une image distante
  448. pour un produit.
  449. </para>
  450. <sect4 id="zend.service.amazon.classes.image.properties">
  451. <title>Propriétés</title>
  452. <table id="zend.service.amazon.classes.image.properties.table-1">
  453. <title>Propriétés de Zend_Service_Amazon_Image</title>
  454. <tgroup cols="3">
  455. <thead>
  456. <row>
  457. <entry>Name</entry>
  458. <entry>Type</entry>
  459. <entry>Description</entry>
  460. </row>
  461. </thead>
  462. <tbody>
  463. <row>
  464. <entry>Url</entry>
  465. <entry>Zend_Uri</entry>
  466. <entry>Url distante de l'image</entry>
  467. </row>
  468. <row>
  469. <entry>Height</entry>
  470. <entry>int</entry>
  471. <entry>La hauteur (en pixels) de l'image</entry>
  472. </row>
  473. <row>
  474. <entry>Width</entry>
  475. <entry>int</entry>
  476. <entry>La largeur (en pixels) de l'image</entry>
  477. </row>
  478. </tbody>
  479. </tgroup>
  480. </table>
  481. <para>
  482. <link linkend="zend.service.amazon.classes">Retour à la liste des
  483. classes</link>
  484. </para>
  485. </sect4>
  486. </sect3>
  487. <sect3 id="zend.service.amazon.classes.resultset">
  488. <title>Zend_Service_Amazon_ResultSet</title>
  489. <para>
  490. Des objets <classname>Zend_Service_Amazon_ResultSet</classname> sont retournés
  491. par <link
  492. linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link> et
  493. vous permettent de gérer facilement les différents résultats retournés.
  494. </para>
  495. <note>
  496. <title>SeekableIterator</title>
  497. <para>
  498. Implémente l'itérateur <code>SeekableIterator</code> pour une itération
  499. simple (en utilisant <code>foreach</code>), aussi bien que l'accès direct à une
  500. URL spécifique en utilisant <code>seek()</code>.
  501. </para>
  502. </note>
  503. <sect4 id="zend.service.amazon.classes.resultset.totalresults">
  504. <title>Zend_Service_Amazon_ResultSet::totalResults()</title>
  505. <methodsynopsis>
  506. <type>int</type>
  507. <methodname>totalResults</methodname>
  508. <void />
  509. </methodsynopsis>
  510. <para>Retourne le nombre total de résultats de la recherche</para>
  511. <para>
  512. <link linkend="zend.service.amazon.classes">Retour à la liste des
  513. classes</link>
  514. </para>
  515. </sect4>
  516. </sect3>
  517. <sect3 id="zend.service.amazon.classes.offerset">
  518. <title>Zend_Service_Amazon_OfferSet</title>
  519. <para>
  520. Chaque résultat retourné par <link
  521. linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link> et
  522. <link
  523. linkend="zend.service.amazon.itemlookup">Zend_Service_Amazon::itemLookup()</link>
  524. contient un objet <classname>Zend_Service_Amazon_OfferSet</classname> au travers
  525. duquel il est possible de récupérer les informations de prix de l'article.
  526. </para>
  527. <sect4 id="zend.service.amazon.classes.offerset.parameters">
  528. <title>Propriétés</title>
  529. <table id="zend.service.amazon.classes.offerset.parameters.table-1">
  530. <title>Propriétés de Zend_Service_Amazon_OfferSet</title>
  531. <tgroup cols="3">
  532. <thead>
  533. <row>
  534. <entry>Name</entry>
  535. <entry>Type</entry>
  536. <entry>Description</entry>
  537. </row>
  538. </thead>
  539. <tbody>
  540. <row>
  541. <entry>LowestNewPrice</entry>
  542. <entry>int</entry>
  543. <entry>Le plus bas prix pour l'article en condition "New" (ie
  544. les articles neufs)</entry>
  545. </row>
  546. <row>
  547. <entry>LowestNewPriceCurrency</entry>
  548. <entry>string</entry>
  549. <entry>La devise pour le <code>LowestNewPrice</code></entry>
  550. </row>
  551. <row>
  552. <entry>LowestOldPrice</entry>
  553. <entry>int</entry>
  554. <entry>Le plus bas prix pour l'article en condition "Used" (ie
  555. les articles d'occasion)</entry>
  556. </row>
  557. <row>
  558. <entry>LowestOldPriceCurrency</entry>
  559. <entry>string</entry>
  560. <entry>La devise pour le <code>LowestOldPrice</code></entry>
  561. </row>
  562. <row>
  563. <entry>TotalNew</entry>
  564. <entry>int</entry>
  565. <entry>Le nombre total des conditions "new" disponibles pour cet
  566. article (ie le nombre de modèles neufs en stock)</entry>
  567. </row>
  568. <row>
  569. <entry>TotalUsed</entry>
  570. <entry>int</entry>
  571. <entry>Le nombre total des conditions "used" disponible pour cet
  572. article (ie le nombre de modèles d'occasion en stock)</entry>
  573. </row>
  574. <row>
  575. <entry>TotalCollectible</entry>
  576. <entry>int</entry>
  577. <entry>Le nombre total des conditions "collectible" disponible
  578. pour cet article (ie le nombre de pièces de collection en
  579. stock)</entry>
  580. </row>
  581. <row>
  582. <entry>TotalRefurbished</entry>
  583. <entry>int</entry>
  584. <entry>Le nombre total des conditions "refurbished" disponible
  585. pour cet article (ie le nombre de pièces remise à neuf en
  586. stock)</entry>
  587. </row>
  588. <row>
  589. <entry>Offers</entry>
  590. <entry>array</entry>
  591. <entry>Un tableau d'objets
  592. <classname>Zend_Service_Amazon_Offer</classname></entry>
  593. </row>
  594. </tbody>
  595. </tgroup>
  596. </table>
  597. <para>
  598. <link linkend="zend.service.amazon.classes">Retour à la liste des
  599. classes</link>
  600. </para>
  601. </sect4>
  602. </sect3>
  603. <sect3 id="zend.service.amazon.classes.offer">
  604. <title>Zend_Service_Amazon_Offer</title>
  605. <para>
  606. Chaque offre pour un article est retourné sous la forme d'un objet
  607. <classname>Zend_Service_Amazon_Offer</classname>.
  608. </para>
  609. <sect4 id="zend.service.amazon.classes.offer.properties">
  610. <title>Zend_Service_Amazon_Offer Properties</title>
  611. <table>
  612. <title>Propriétés de Zend_Service_Amazon_Offer</title>
  613. <tgroup cols="3">
  614. <thead>
  615. <row>
  616. <entry>Name</entry>
  617. <entry>Type</entry>
  618. <entry>Description</entry>
  619. </row>
  620. </thead>
  621. <tbody>
  622. <row>
  623. <entry>MerchantId</entry>
  624. <entry>string</entry>
  625. <entry>ID Amazon du fournisseur</entry>
  626. </row>
  627. <row>
  628. <entry>GlancePage</entry>
  629. <entry>string</entry>
  630. <entry>URL de la page avec un résumé du fournisseur</entry>
  631. </row>
  632. <row>
  633. <entry>Condition</entry>
  634. <entry>string</entry>
  635. <entry>Condition de cet article</entry>
  636. </row>
  637. <row>
  638. <entry>OfferListingId</entry>
  639. <entry>string</entry>
  640. <entry>ID de la liste d'offre</entry>
  641. </row>
  642. <row>
  643. <entry>Price</entry>
  644. <entry>int</entry>
  645. <entry>Prix de l'article</entry>
  646. </row>
  647. <row>
  648. <entry>CurrencyCode</entry>
  649. <entry>string</entry>
  650. <entry>Code de la devise pour le prix de l'article</entry>
  651. </row>
  652. <row>
  653. <entry>Availability</entry>
  654. <entry>string</entry>
  655. <entry>Disponibilité de l'article</entry>
  656. </row>
  657. <row>
  658. <entry>IsEligibleForSuperSaverShipping</entry>
  659. <entry>boolean</entry>
  660. <entry>Est-ce que l'article est éligible ou pas pour un "Super
  661. Saver Shipping"</entry>
  662. </row>
  663. </tbody>
  664. </tgroup>
  665. </table>
  666. <para>
  667. <link linkend="zend.service.amazon.classes">Retour à la liste des
  668. classes</link>
  669. </para>
  670. </sect4>
  671. </sect3>
  672. <sect3 id="zend.service.amazon.classes.similarproduct">
  673. <title>Zend_Service_Amazon_SimilarProduct</title>
  674. <para>
  675. Lors de la recherche d'articles, Amazon retourne aussi une liste de produits
  676. similaires qui pourraient intéresser le visiteur. Chacun d'entre eux est retourné
  677. dans un objet <classname>Zend_Service_Amazon_SimilarProduct</classname>.
  678. </para>
  679. <para>
  680. Chaque objet contient l'information qui vous permet de faire les requêtes
  681. suivantes pour obtenir les informations complètes sur un article.
  682. </para>
  683. <sect4 id="zend.service.amazon.classes.similarproduct.properties">
  684. <title>Propriétés</title>
  685. <table id="zend.service.amazon.classes.similarproduct.properties.table-1">
  686. <title>Propriétés de Zend_Service_Amazon_SimilarProduct</title>
  687. <tgroup cols="3">
  688. <thead>
  689. <row>
  690. <entry>Name</entry>
  691. <entry>Type</entry>
  692. <entry>Description</entry>
  693. </row>
  694. </thead>
  695. <tbody>
  696. <row>
  697. <entry>ASIN</entry>
  698. <entry>string</entry>
  699. <entry>Identifiant unique d'un produit Amazon (ASIN)</entry>
  700. </row>
  701. <row>
  702. <entry>Title</entry>
  703. <entry>string</entry>
  704. <entry>Intitulé du produit</entry>
  705. </row>
  706. </tbody>
  707. </tgroup>
  708. </table>
  709. <para>
  710. <link linkend="zend.service.amazon.classes">Retour à la liste des
  711. classes</link>
  712. </para>
  713. </sect4>
  714. </sect3>
  715. <sect3 id="zend.service.amazon.classes.accessories">
  716. <title>Zend_Service_Amazon_Accessories</title>
  717. <para>
  718. Les accessoires pour un article retourné sont représentés comme un objet
  719. <classname>Zend_Service_Amazon_Accessories</classname>.
  720. </para>
  721. <sect4 id="zend.service.amazon.classes.accessories.properties">
  722. <title>Propriétés</title>
  723. <table id="zend.service.amazon.classes.accessories.properties.table-1">
  724. <title>Propriétés de Zend_Service_Amazon_Accessories</title>
  725. <tgroup cols="3">
  726. <thead>
  727. <row>
  728. <entry>Name</entry>
  729. <entry>Type</entry>
  730. <entry>Description</entry>
  731. </row>
  732. </thead>
  733. <tbody>
  734. <row>
  735. <entry>ASIN</entry>
  736. <entry>string</entry>
  737. <entry>Identifiant unique d'un produit Amazon (ASIN)</entry>
  738. </row>
  739. <row>
  740. <entry>Title</entry>
  741. <entry>string</entry>
  742. <entry>Intitulé du produit</entry>
  743. </row>
  744. </tbody>
  745. </tgroup>
  746. </table>
  747. <para>
  748. <link linkend="zend.service.amazon.classes">Retour à la liste des
  749. classes</link>
  750. </para>
  751. </sect4>
  752. </sect3>
  753. <sect3 id="zend.service.amazon.classes.customerreview">
  754. <title>Zend_Service_Amazon_CustomerReview</title>
  755. <para>
  756. Chaque revue de client est retournée sous la forme d'un objet
  757. <classname>Zend_Service_Amazon_CustomerReview</classname>.
  758. </para>
  759. <sect4 id="zend.service.amazon.classes.customerreview.properties">
  760. <title>Propriétés</title>
  761. <table id="zend.service.amazon.classes.customerreview.properties.table-1">
  762. <title>Propriétés de Zend_Service_Amazon_CustomerReview</title>
  763. <tgroup cols="3">
  764. <thead>
  765. <row>
  766. <entry>Name</entry>
  767. <entry>Type</entry>
  768. <entry>Description</entry>
  769. </row>
  770. </thead>
  771. <tbody>
  772. <row>
  773. <entry>Rating</entry>
  774. <entry>string</entry>
  775. <entry>Evaluation de l'article</entry>
  776. </row>
  777. <row>
  778. <entry>HelpfulVotes</entry>
  779. <entry>string</entry>
  780. <entry>Votes pour "Ce commentaire vous a-t'il été utile
  781. ?"</entry>
  782. </row>
  783. <row>
  784. <entry>CustomerId</entry>
  785. <entry>string</entry>
  786. <entry>Identifiant du client</entry>
  787. </row>
  788. <row>
  789. <entry>TotalVotes</entry>
  790. <entry>string</entry>
  791. <entry>Total des votes</entry>
  792. </row>
  793. <row>
  794. <entry>Date</entry>
  795. <entry>string</entry>
  796. <entry>Date de la revue</entry>
  797. </row>
  798. <row>
  799. <entry>Summary</entry>
  800. <entry>string</entry>
  801. <entry>Sommaire de la revue</entry>
  802. </row>
  803. <row>
  804. <entry>Content</entry>
  805. <entry>string</entry>
  806. <entry>Contenu de la revue</entry>
  807. </row>
  808. </tbody>
  809. </tgroup>
  810. </table>
  811. <para>
  812. <link linkend="zend.service.amazon.classes">Retour à la liste des
  813. classes</link>
  814. </para>
  815. </sect4>
  816. </sect3>
  817. <sect3 id="zend.service.amazon.classes.editorialreview">
  818. <title>Zend_Service_Amazon_EditorialReview</title>
  819. <para>
  820. Chaque revue éditoriale d'un article est retournée dans un objet
  821. <classname>Zend_Service_Amazon_EditorialReview</classname>.
  822. </para>
  823. <sect4 id="zend.service.amazon.classes.editorialreview.properties">
  824. <title>Propriétés</title>
  825. <table id="zend.service.amazon.classes.editorialreview.properties.table-1">
  826. <title>Propriétés de Zend_Service_Amazon_EditorialReview</title>
  827. <tgroup cols="3">
  828. <thead>
  829. <row>
  830. <entry>Name</entry>
  831. <entry>Type</entry>
  832. <entry>Description</entry>
  833. </row>
  834. </thead>
  835. <tbody>
  836. <row>
  837. <entry>Source</entry>
  838. <entry>string</entry>
  839. <entry>Source de la revue éditoriale</entry>
  840. </row>
  841. <row>
  842. <entry>Content</entry>
  843. <entry>string</entry>
  844. <entry>Contenu de la revue</entry>
  845. </row>
  846. </tbody>
  847. </tgroup>
  848. </table>
  849. <para>
  850. <link linkend="zend.service.amazon.classes">Retour à la liste des
  851. classes</link>
  852. </para>
  853. </sect4>
  854. </sect3>
  855. <sect3 id="zend.service.amazon.classes.listmania">
  856. <title>Zend_Service_Amazon_Listmania</title>
  857. <para>
  858. Chaque résultat de liste ListMania est retourné dans un objet
  859. <classname>Zend_Service_Amazon_Listmania</classname>.
  860. </para>
  861. <sect4 id="zend.service.amazon.classes.listmania.properties">
  862. <title>Propriétés</title>
  863. <table id="zend.service.amazon.classes.listmania.properties.table-1">
  864. <title>Propriétés de Zend_Service_Amazon_Listmania</title>
  865. <tgroup cols="3">
  866. <thead>
  867. <row>
  868. <entry>Name</entry>
  869. <entry>Type</entry>
  870. <entry>Description</entry>
  871. </row>
  872. </thead>
  873. <tbody>
  874. <row>
  875. <entry>ListId</entry>
  876. <entry>string</entry>
  877. <entry>Identifiant de la liste</entry>
  878. </row>
  879. <row>
  880. <entry>ListName</entry>
  881. <entry>string</entry>
  882. <entry>Nom de la liste</entry>
  883. </row>
  884. </tbody>
  885. </tgroup>
  886. </table>
  887. <para>
  888. <link linkend="zend.service.amazon.classes">Retour à la liste des
  889. classes</link>
  890. </para>
  891. </sect4>
  892. </sect3>
  893. </sect2>
  894. </sect1>