Zend_Service_Amazon.xml 30 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <sect1 id="zend.service.amazon">
  3. <title>Zend_Service_Amazon</title>
  4. <sect2 id="zend.service.amazon.introduction">
  5. <title>Introdução</title>
  6. <para><code>Zend_Service_Amazon</code> é uma simples API para utilização
  7. dos web services do Amazon. <code>Zend_Service_Amazon</code> possui duas
  8. APIs: uma mais tradicional que segue o padrão da própria Amazon API, e uma
  9. simples API de consultas para facilitar a construção de pesquisas mais
  10. complexas.</para>
  11. <para><code>Zend_Service_Amazon</code> dá aos desenvolvedores a capacidade
  12. de recuperar informações como se estivessem accessando os sites Amazon.com
  13. diretamente através da Amazon Web Services API. Exemplos incluídos:
  14. <itemizedlist>
  15. <listitem>
  16. <para>
  17. Armazenar informações de ítens, como imagens, descrições, preços, entre outros.
  18. </para>
  19. </listitem>
  20. <listitem>
  21. <para>
  22. Revisões editoriais e por parte do cliente.
  23. </para>
  24. </listitem>
  25. <listitem>
  26. <para>
  27. Produtos similares e acessórios.
  28. </para>
  29. </listitem>
  30. <listitem>
  31. <para>
  32. Ofertas do Amazon.com.
  33. </para>
  34. </listitem>
  35. <listitem>
  36. <para>
  37. Listas do tipo ListMania.
  38. </para>
  39. </listitem>
  40. </itemizedlist></para>
  41. <para>Para usar o <code>Zend_Service_Amazon</code>, você deve possuir uma
  42. chave de desenvolvedor para acessar a Amazon API. Para obter uma chave e
  43. outras informações, por favor visite o web site <ulink
  44. url="http://www.amazon.com/gp/aws/landing.html">Amazon Web
  45. Services</ulink>.</para>
  46. <note>
  47. <title>Attention</title>
  48. <para>
  49. Sua chave de desenvolvedor Amazon API está ligada à sua identificação Amazon, então, tome medidas de segurança apropriadas para garantir a privacidade de sua chave.
  50. </para>
  51. </note>
  52. <example>
  53. <title>Busca no Amazon usando a API tradicional</title>
  54. <para>Neste exemplo, pesquisamos por livros de PHP no Amazon, executando
  55. um laço para imprimir os resultados.</para>
  56. <programlisting>&lt;?php
  57. require_once 'Zend/Service/Amazon.php';
  58. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY&amp;');
  59. $response = $amazon-&gt;itemSearch(array('SearchIndex' =&gt; 'Books', 'Keywords' =&gt; 'php'));
  60. foreach ($response as $r) {
  61. echo $r-&gt;Title .'&lt;br /&gt;';
  62. }
  63. ?&gt; </programlisting>
  64. </example>
  65. <example>
  66. <title>Busca no Amazon usando a Query API</title>
  67. <para>Aqui, nós pesquisamos por livros de PHP no Amazon, mas usando a
  68. API de consulta, que implementa o padrão de projeto "Fluent
  69. Interface".</para>
  70. <programlisting>&lt;?php
  71. require_once 'Zend/Service/Amazon/Query.php';
  72. $query = new Zend_Service_Amazon_Query('AMAZON_API_KEY');
  73. $query-&gt;category('Books')-&gt;Keywords('PHP');
  74. $results = $query-&gt;search();
  75. foreach ($results as $result) {
  76. echo $result-&gt;Title .'&lt;br /&gt;';
  77. }
  78. ?&gt; </programlisting>
  79. </example>
  80. </sect2>
  81. <sect2 id="zend.service.amazon.countrycodes">
  82. <title>Códigos de Países</title>
  83. <para>Por padrão, <code>Zend_Service_Amazon</code> conecta ao web service
  84. do Amazon localizado nos Estado Unidos ("<code>US</code>"). Para
  85. conectar-se a um país diferente, simplesmente especifique a respectiva
  86. string de código de país como segundo parâmetro para o construtor:</para>
  87. <example>
  88. <title>Selecionando o Amazon Web Service de um país</title>
  89. <programlisting>&lt;?php
  90. // Connect to Amazon in Japan
  91. require_once 'Zend/Service/Amazon.php';
  92. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'JP');
  93. ?&gt; </programlisting>
  94. </example>
  95. <note>
  96. <title>Country codes</title>
  97. <para>
  98. Códigos válidos podem ser: <code>CA</code>, <code>DE</code>,
  99. <code>FR</code>, <code>JP</code>, <code>UK</code>, e
  100. <code>US</code>.
  101. </para>
  102. </note>
  103. </sect2>
  104. <sect2 id="zend.service.amazon.itemlookup">
  105. <title>Procurando por um ítem específico do Amazon com o código
  106. ASIN</title>
  107. <para>O método <code>itemLookup()</code> oferece a capacidade de procurar
  108. por um ítem em particular quando o código ASIN é conhecido.</para>
  109. <example>
  110. <title>Procurando por um ítem específico no Amazon usando ASIN</title>
  111. <programlisting>&lt;?php
  112. require_once 'Zend/Service/Amazon.php';
  113. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY');
  114. $item = $amazon-&gt;itemLookup('B0000A432X');
  115. ?&gt; </programlisting>
  116. </example>
  117. <para>O método <code>itemLookup()</code> também aceita um segundo parâmetro opcional para lidar com as opções de busca. Para maiores detalhes, incluíndo uma lista de opções disponíveis, por favor consulte a <ulink
  118. url="http://www.amazon.com/gp/aws/sdk/main.html/103-9285448-4703844?s=AWSEcommerceService&amp;v=2005-10-05&amp;p=ApiReference/ItemLookupOperation"> respectiva documentação do Amazon
  119. </ulink>.</para>
  120. </sect2>
  121. <sect2 id="zend.service.amazon.itemsearch">
  122. <title>Executando pesquisas de ítens no Amazon</title>
  123. <para>Efetuar buscas de ítens, baseando-se em um dos vários critérios de busca disponíveis, são tarefas simples se empregado o método <code>itemSearch()</code>, como mostrado no exemplo seguinte:</para>
  124. <example>
  125. <title>Efetuando buscas de ítens no Amazon</title>
  126. <programlisting>&lt;?php
  127. require_once 'Zend/Service/Amazon.php';
  128. $amazon = new Zend_Service_Amazon('AMAZON_API_KEY');
  129. $response = $amazon-&gt;itemSearch(array('SearchIndex' =&gt; 'Books', 'Keywords' =&gt; 'php'));
  130. foreach($response as $r) {
  131. echo $r-&gt;Title .'&lt;br /&gt;';
  132. }
  133. ?&gt; </programlisting>
  134. </example>
  135. <para>O método <code>itemSearch()</code> aceita um simples array de parâmetros para lidar com as opções de busca. Para mais detalhes, incluíndo uma lista de opções disponíveis, consulte a <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/ItemSearchOperation"> respectiva
  137. documentação do Amazon</ulink></para>
  138. <tip>
  139. <para>A classe
  140. <link linkend="zend.service.amazon.query">
  141. <code>Zend_Service_Amazon_Query</code>
  142. </link>
  143. é um meio fácil de usar um encapsulamento deste método. </para>
  144. </tip>
  145. </sect2>
  146. <sect2 id="zend.service.amazon.query">
  147. <title>Usando a Query API Alternativa</title>
  148. <sect3 id="zend.service.amazon.query.introduction">
  149. <title>Introdução</title>
  150. <para><code>Zend_Service_Amazon_Query</code> oferece uma API alternativa
  151. para utilizar o Amazon Web Service. A API alternetiva utiliza o padrão de
  152. projeto "Fluent Interface". Ou seja, todas as chamadas são feitas usando
  153. métodos encadeados (ex:
  154. <code>$obj-&gt;method()-&gt;method2($arg)</code>)</para>
  155. <para>A API <code>Zend_Service_Amazon_Query</code> usa sobrecarga para
  156. facilitar a definição dos ítens de busca, permitindo buscas baseadas nos
  157. critérios especificados. Cada uma das opções é implementada como uma
  158. chamada a método, e cada argumento respectivo, corresponde ao nome da
  159. opção:</para>
  160. <example>
  161. <title>Pesquisando o Amazon usando a Query API Alternativa</title>
  162. <para>Neste exemplo, a Query API alternativa é usada como uma interface
  163. "fluente" para especificar opções e seus respectivos valores:</para>
  164. <programlisting>&lt;?php
  165. require_once 'Zend/Service/Amazon/Query.php';
  166. $query = new Zend_Service_Amazon_Query('MY_API_KEY');
  167. $query-&gt;Category('Books')-&gt;Keywords('PHP');
  168. $results = $query-&gt;search();
  169. foreach ($results as $result) {
  170. echo $result-&gt;Title .'&lt;br /&gt;';
  171. }
  172. ?&gt; </programlisting>
  173. <para>Isto atribui à opção <code>Category</code> o valor "Books" e à
  174. opção <code>Keywords</code> o valor "PHP".</para>
  175. <para>Para mais informações e opções disponíveis, consulte a <ulink
  176. url="http://www.amazon.com/gp/aws/sdk/main.html/102-9041115-9057709?s=AWSEcommerceService&amp;v=2005-10-05&amp;p=ApiReference/ItemSearchOperation">documentação
  177. do Amazon </ulink> específica ao assunto.</para>
  178. </example>
  179. </sect3>
  180. </sect2>
  181. <sect2 id="zend.service.amazon.classes">
  182. <title>Classes Zend_Service_Amazon</title>
  183. <para>As classes abaixo listadas são retornadas pelos métodos <link
  184. linkend="zend.service.amazon.itemlookup"><code>Zend_Service_Amazon::itemLookup()</code></link>
  185. e <link
  186. linkend="zend.service.amazon.itemsearch"><code>Zend_Service_Amazon::itemSearch()</code></link>:
  187. <itemizedlist>
  188. <listitem>
  189. <para><link
  190. linkend="zend.service.amazon.classes.item"><code>Zend_Service_Amazon_Item</code></link></para>
  191. </listitem>
  192. <listitem>
  193. <para><link
  194. linkend="zend.service.amazon.classes.image"><code>Zend_Service_Amazon_Image</code></link></para>
  195. </listitem>
  196. <listitem>
  197. <para><link
  198. linkend="zend.service.amazon.classes.resultset"><code>Zend_Service_Amazon_ResultSet</code></link></para>
  199. </listitem>
  200. <listitem>
  201. <para><link
  202. linkend="zend.service.amazon.classes.offerset"><code>Zend_Service_Amazon_OfferSet</code></link></para>
  203. </listitem>
  204. <listitem>
  205. <para><link
  206. linkend="zend.service.amazon.classes.offer"><code>Zend_Service_Amazon_Offer</code></link></para>
  207. </listitem>
  208. <listitem>
  209. <para><link
  210. linkend="zend.service.amazon.classes.similarproduct"><code>Zend_Service_Amazon_SimilarProduct</code></link></para>
  211. </listitem>
  212. <listitem>
  213. <para><link
  214. linkend="zend.service.amazon.classes.accessories"><code>Zend_Service_Amazon_Accessories</code></link></para>
  215. </listitem>
  216. <listitem>
  217. <para><link
  218. linkend="zend.service.amazon.classes.customerreview"><code>Zend_Service_Amazon_CustomerReview</code></link></para>
  219. </listitem>
  220. <listitem>
  221. <para><link
  222. linkend="zend.service.amazon.classes.editorialreview"><code>Zend_Service_Amazon_EditorialReview</code></link></para>
  223. </listitem>
  224. <listitem>
  225. <para><link
  226. linkend="zend.service.amazon.classes.listmania"><code>Zend_Service_Amazon_ListMania</code></link></para>
  227. </listitem>
  228. </itemizedlist></para>
  229. <sect3 id="zend.service.amazon.classes.item">
  230. <title>Zend_Service_Amazon_Item</title>
  231. <para><code>Zend_Service_Amazon_Item</code> é uma classe usada para
  232. representar um ítem do Amazon retornado pelo web service. Ele abrange
  233. todos os atributos dos ítens, incluíndo título, descrição, críticas,
  234. etc.</para>
  235. <sect4 id="zend.service.amazon.classes.item.asxml">
  236. <title>Zend_Service_Amazon_Item::asXML()</title>
  237. <para>
  238. <methodsynopsis>
  239. <type>string</type>
  240. <methodname>asXML</methodname>
  241. <void />
  242. </methodsynopsis>
  243. </para>
  244. <para>Retorna o XML original para o ítem pesquisado.</para>
  245. </sect4>
  246. <sect4 id="zend.service.amazon.classes.item.properties">
  247. <title>Propriedades</title>
  248. <para><code>Zend_Service_Amazon_Item</code> possui algumas propriedades
  249. que estão diretamente relacionadas com suas similares na API padrão do
  250. Amazon API.</para>
  251. <table>
  252. <title>Propriedade de Zend_Service_Amazon_Item</title>
  253. <tgroup cols="3">
  254. <thead>
  255. <row>
  256. <entry>Nome</entry>
  257. <entry>Tipo</entry>
  258. <entry>Descrição</entry>
  259. </row>
  260. </thead>
  261. <tbody>
  262. <row>
  263. <entry>ASIN</entry>
  264. <entry>string</entry>
  265. <entry>ID do ítem</entry>
  266. </row>
  267. <row>
  268. <entry>DetailPageURL</entry>
  269. <entry>string</entry>
  270. <entry>URL para a página de detalhes do ítem</entry>
  271. </row>
  272. <row>
  273. <entry>SalesRank</entry>
  274. <entry>string</entry>
  275. <entry>Pontuação de vendas para o ítem</entry>
  276. </row>
  277. <row>
  278. <entry>SmallImage</entry>
  279. <entry>Zend_Service_Amazon_Image</entry>
  280. <entry>Imagem reduzida para o ítem</entry>
  281. </row>
  282. <row>
  283. <entry>MediumImage</entry>
  284. <entry>Zend_Service_Amazon_Image</entry>
  285. <entry>Imagem de tamanho médio para o ítem</entry>
  286. </row>
  287. <row>
  288. <entry>LargeImage</entry>
  289. <entry>Zend_Service_Amazon_Image</entry>
  290. <entry>Imagem grande para o ítem</entry>
  291. </row>
  292. <row>
  293. <entry>Subjects</entry>
  294. <entry>array</entry>
  295. <entry>Assunto do ítem</entry>
  296. </row>
  297. <row>
  298. <entry>Offers</entry>
  299. <entry>
  300. <code>
  301. <link
  302. linkend="zend.service.amazon.classes.offerset">Zend_Service_Amazon_OfferSet</link>
  303. </code>
  304. </entry>
  305. <entry>Resumo de ofertas e Ofertas para o ítem</entry>
  306. </row>
  307. <row>
  308. <entry>CustomerReviews</entry>
  309. <entry>array</entry>
  310. <entry>Criticas dos clientes representadas como um array de
  311. objetos <code>
  312. <link
  313. linkend="zend.service.amazon.classes.customerreview">Zend_Service_Amazon_CustomerReview</link>
  314. </code></entry>
  315. </row>
  316. <row>
  317. <entry>EditorialReviews</entry>
  318. <entry>array</entry>
  319. <entry>Críticas editoriais representadas como um array de
  320. objetos <code>
  321. <link
  322. linkend="zend.service.amazon.classes.editorialreview">Zend_Service_Amazon_EditorialReview</link>
  323. </code></entry>
  324. </row>
  325. <row>
  326. <entry>SimilarProducts</entry>
  327. <entry>array</entry>
  328. <entry>Produtos similares representados como um array de objetos
  329. <code>
  330. <link
  331. linkend="zend.service.amazon.classes.similarproduct">Zend_Service_Amazon_SimilarProduct</link>
  332. </code></entry>
  333. </row>
  334. <row>
  335. <entry>Accessories</entry>
  336. <entry>array</entry>
  337. <entry>Acessórios para o ítem representadas como um array de
  338. objetos <code>
  339. <link
  340. linkend="zend.service.amazon.classes.accessories">Zend_Service_Amazon_Accessories</link>
  341. </code></entry>
  342. </row>
  343. <row>
  344. <entry>Tracks</entry>
  345. <entry>array</entry>
  346. <entry>Um array de números de trilhas e nomes para DVDs e CDs de
  347. música</entry>
  348. </row>
  349. <row>
  350. <entry>ListmaniaLists</entry>
  351. <entry>array</entry>
  352. <entry>Ítem relacionada à lista Listmania como um array de
  353. objetos <code>
  354. <link
  355. linkend="zend.service.amazon.classes.listmania">Zend_Service_Amazon_ListmainList</link>
  356. </code></entry>
  357. </row>
  358. <row>
  359. <entry>PromotionalTag</entry>
  360. <entry>string</entry>
  361. <entry>Tag de ítem promocional</entry>
  362. </row>
  363. </tbody>
  364. </tgroup>
  365. </table>
  366. <para>
  367. <link linkend="zend.service.amazon.classes">Retornar para a Lista de
  368. Classes</link>
  369. </para>
  370. </sect4>
  371. </sect3>
  372. <sect3 id="zend.service.amazon.classes.image">
  373. <title>Zend_Service_Amazon_Image</title>
  374. <para><code>Zend_Service_Amazon_Image</code> representa uma imagem remota
  375. de um produto.</para>
  376. <sect4 id="zend.service.amazon.classes.image.properties">
  377. <title>Propriedades</title>
  378. <table>
  379. <title>Propriedades de Zend_Service_Amazon_Image</title>
  380. <tgroup cols="3">
  381. <thead>
  382. <row>
  383. <entry>Nome</entry>
  384. <entry>Tipo</entry>
  385. <entry>Descrição</entry>
  386. </row>
  387. </thead>
  388. <tbody>
  389. <row>
  390. <entry>Url</entry>
  391. <entry>string</entry>
  392. <entry>URL remota para a imagem</entry>
  393. </row>
  394. <row>
  395. <entry>Height</entry>
  396. <entry>int</entry>
  397. <entry>Altura da imagem em pixels</entry>
  398. </row>
  399. <row>
  400. <entry>Width</entry>
  401. <entry>int</entry>
  402. <entry>Largura da imagem em pixels</entry>
  403. </row>
  404. </tbody>
  405. </tgroup>
  406. </table>
  407. <para>
  408. <link linkend="zend.service.amazon.classes">Retornar para a Lista de
  409. Classes</link>
  410. </para>
  411. </sect4>
  412. </sect3>
  413. <sect3 id="zend.service.amazon.classes.resultset">
  414. <title>Zend_Service_Amazon_ResultSet</title>
  415. <para>Objetos <code>Zend_Service_Amazon_ResultSet</code> saõ retornados
  416. por <link
  417. linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link>
  418. e permitem a você manusear facilmente os múltiplos resultados
  419. retornados.</para>
  420. <note>
  421. <title>Image information</title>
  422. <para>
  423. Implemente o <code>SeekableIterator</code> para fácil iteração
  424. (ex: usando <code>foreach</code>), bem como, acesso direto a uma string
  425. específica de resultados usando <code>seek()</code>.
  426. </para>
  427. </note>
  428. <sect4 id="zend.service.amazon.classes.resultset.totalresults">
  429. <title>Zend_Service_Amazon_ResultSet::totalResults()</title>
  430. <methodsynopsis>
  431. <type>int</type>
  432. <methodname>totalResults</methodname>
  433. <void />
  434. </methodsynopsis>
  435. <para>Número total de resultados retornados pela pesquisa</para>
  436. <para>
  437. <link linkend="zend.service.amazon.classes">Retornar para a Lista de
  438. Classes</link>
  439. </para>
  440. </sect4>
  441. </sect3>
  442. <sect3 id="zend.service.amazon.classes.offerset">
  443. <title>Zend_Service_Amazon_OfferSet</title>
  444. <para>Cada resultado retornado por <link
  445. linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link>
  446. e <link
  447. linkend="zend.service.amazon.itemlookup">Zend_Service_Amazon::itemLookup()</link>
  448. contém um objeto <code>Zend_Service_Amazon_OfferSet</code> através do qual
  449. o preço do ítem pode ser recuperado.</para>
  450. <sect4 id="zend.service.amazon.classes.offerset.parameters">
  451. <title>Propriedades</title>
  452. <table>
  453. <title>Propriedades de Zend_Service_Amazon_OfferSet</title>
  454. <tgroup cols="3">
  455. <thead>
  456. <row>
  457. <entry>Nome</entry>
  458. <entry>Tipo</entry>
  459. <entry>Descrição</entry>
  460. </row>
  461. </thead>
  462. <tbody>
  463. <row>
  464. <entry>LowestNewPrice</entry>
  465. <entry>int</entry>
  466. <entry>Menor preço para o ítem na condição de NOVO</entry>
  467. </row>
  468. <row>
  469. <entry>LowestNewPriceCurrency</entry>
  470. <entry>string</entry>
  471. <entry>A moeda em que está expresso o
  472. <code>LowestNewPrice</code></entry>
  473. </row>
  474. <row>
  475. <entry>LowestOldPrice</entry>
  476. <entry>int</entry>
  477. <entry>Menor preço para o ítem na condição de USADO</entry>
  478. </row>
  479. <row>
  480. <entry>LowestOldPriceCurrency</entry>
  481. <entry>string</entry>
  482. <entry>A moeda em que está expresso o
  483. <code>LowestOldPrice</code></entry>
  484. </row>
  485. <row>
  486. <entry>TotalNew</entry>
  487. <entry>int</entry>
  488. <entry>Total de ítens "Novos" disponíveis </entry>
  489. </row>
  490. <row>
  491. <entry>TotalUsed</entry>
  492. <entry>int</entry>
  493. <entry>Total de ítens "Usados" disponíveis</entry>
  494. </row>
  495. <row>
  496. <entry>TotalCollectible</entry>
  497. <entry>int</entry>
  498. <entry>Total de ítens "colecionáveis" disponíveis</entry>
  499. </row>
  500. <row>
  501. <entry>TotalRefurbished</entry>
  502. <entry>int</entry>
  503. <entry>Total de ítens "refurbished" disponíveis</entry>
  504. </row>
  505. <row>
  506. <entry>Offers</entry>
  507. <entry>array</entry>
  508. <entry>Um array de objetos
  509. <code>Zend_Service_Amazon_Offer</code>.</entry>
  510. </row>
  511. </tbody>
  512. </tgroup>
  513. </table>
  514. <para>
  515. <link linkend="zend.service.amazon.classes">Retornar para a Lista de
  516. Classes</link>
  517. </para>
  518. </sect4>
  519. </sect3>
  520. <sect3 id="zend.service.amazon.classes.offer">
  521. <title>Zend_Service_Amazon_Offer</title>
  522. <para>As ofertas para um dado ítem, são retornadas como objetos
  523. <code>Zend_Service_Amazon_Offer</code>.</para>
  524. <sect4 id="zend.service.amazon.classes.offer.properties">
  525. <title>Propriedades de Zend_Service_Amazon_Offer</title>
  526. <table>
  527. <title>Propriedades</title>
  528. <tgroup cols="3">
  529. <thead>
  530. <row>
  531. <entry>Name</entry>
  532. <entry>Type</entry>
  533. <entry>Description</entry>
  534. </row>
  535. </thead>
  536. <tbody>
  537. <row>
  538. <entry>MerchantId</entry>
  539. <entry>string</entry>
  540. <entry>ID Amazon para fornecedores</entry>
  541. </row>
  542. <row>
  543. <entry>GlancePage</entry>
  544. <entry>string</entry>
  545. <entry>URL para uma página contendo um resumo do
  546. fornecedor.</entry>
  547. </row>
  548. <row>
  549. <entry>Condition</entry>
  550. <entry>string</entry>
  551. <entry>Condição do ítem</entry>
  552. </row>
  553. <row>
  554. <entry>OfferListingId</entry>
  555. <entry>string</entry>
  556. <entry>ID da listagem de Ofertas </entry>
  557. </row>
  558. <row>
  559. <entry>Price</entry>
  560. <entry>int</entry>
  561. <entry>Preço do ítem</entry>
  562. </row>
  563. <row>
  564. <entry>CurrencyCode</entry>
  565. <entry>string</entry>
  566. <entry>Código de moeda para o preço do ítem</entry>
  567. </row>
  568. <row>
  569. <entry>Availability</entry>
  570. <entry>string</entry>
  571. <entry>Disponibilidade do ítem</entry>
  572. </row>
  573. <row>
  574. <entry>IsEligibleForSuperSaverShipping</entry>
  575. <entry>boolean</entry>
  576. <entry>Informa se o ítem é elegível para remessa super econômica
  577. ou não</entry>
  578. </row>
  579. </tbody>
  580. </tgroup>
  581. </table>
  582. <para>
  583. <link linkend="zend.service.amazon.classes">Retornar para a Lista de
  584. Classes</link>
  585. </para>
  586. </sect4>
  587. </sect3>
  588. <sect3 id="zend.service.amazon.classes.similarproduct">
  589. <title>Zend_Service_Amazon_SimilarProduct</title>
  590. <para>Ao executar uma busca por ítens, O Amazon também retorna uma lista
  591. de produtos similares que podem ser localizados ao seu gosto. Cada um
  592. deles é retornado como um objeto
  593. <code>Zend_Service_Amazon_SimilarProduct</code>.</para>
  594. <para>Cada objeto contém a informação necessária para que as requisições
  595. subsequentes recuperem informações detalhadas sobre o ítem.</para>
  596. <sect4 id="zend.service.amazon.classes.similarproduct.properties">
  597. <title>Propriedades</title>
  598. <table>
  599. <title>Propriedades de Zend_Service_Amazon_SimilarProduct</title>
  600. <tgroup cols="3">
  601. <thead>
  602. <row>
  603. <entry>Name</entry>
  604. <entry>Type</entry>
  605. <entry>Description</entry>
  606. </row>
  607. </thead>
  608. <tbody>
  609. <row>
  610. <entry>ASIN</entry>
  611. <entry>string</entry>
  612. <entry>Identificador único do produto no Amazon (ASIN)</entry>
  613. </row>
  614. <row>
  615. <entry>Title</entry>
  616. <entry>string</entry>
  617. <entry>Título do Produto</entry>
  618. </row>
  619. </tbody>
  620. </tgroup>
  621. </table>
  622. <para>
  623. <link linkend="zend.service.amazon.classes">Retornar para a Lista de
  624. Classes</link>
  625. </para>
  626. </sect4>
  627. </sect3>
  628. <sect3 id="zend.service.amazon.classes.accessories">
  629. <title>Zend_Service_Amazon_Accessories</title>
  630. <para>Acessórios para o ítem retornado, são representados como objetos
  631. <code>Zend_Service_Amazon_Accessories</code> </para>
  632. <sect4 id="zend.service.amazon.classes.accessories.properties">
  633. <title>Propriedades</title>
  634. <table>
  635. <title>Zend_Service_Amazon_Accessories Properties</title>
  636. <tgroup cols="3">
  637. <thead>
  638. <row>
  639. <entry>Name</entry>
  640. <entry>Type</entry>
  641. <entry>Description</entry>
  642. </row>
  643. </thead>
  644. <tbody>
  645. <row>
  646. <entry>ASIN</entry>
  647. <entry>string</entry>
  648. <entry>Identificador único do produto no Amazon (ASIN)</entry>
  649. </row>
  650. <row>
  651. <entry>Title</entry>
  652. <entry>string</entry>
  653. <entry>Título do Produto</entry>
  654. </row>
  655. </tbody>
  656. </tgroup>
  657. </table>
  658. <para>
  659. <link linkend="zend.service.amazon.classes">Retornar para a Lista de
  660. Classes</link>
  661. </para>
  662. </sect4>
  663. </sect3>
  664. <sect3 id="zend.service.amazon.classes.customerreview">
  665. <title>Zend_Service_Amazon_CustomerReview</title>
  666. <para>Cada crítica feita pelo cliente é retornada como um objeto
  667. <code>Zend_Service_Amazon_CustomerReview</code>.</para>
  668. <sect4 id="zend.service.amazon.classes.customerreview.properties">
  669. <title>Propriedades</title>
  670. <table>
  671. <title>Propriedades de Zend_Service_Amazon_CustomerReview </title>
  672. <tgroup cols="3">
  673. <thead>
  674. <row>
  675. <entry>Name</entry>
  676. <entry>Type</entry>
  677. <entry>Description</entry>
  678. </row>
  679. </thead>
  680. <tbody>
  681. <row>
  682. <entry>Rating</entry>
  683. <entry>string</entry>
  684. <entry>Cotação do ítem</entry>
  685. </row>
  686. <row>
  687. <entry>HelpfulVotes</entry>
  688. <entry>string</entry>
  689. <entry>Votos na "utilidade" da crítica emitida</entry>
  690. </row>
  691. <row>
  692. <entry>CustomerId</entry>
  693. <entry>string</entry>
  694. <entry>ID do Cliente</entry>
  695. </row>
  696. <row>
  697. <entry>TotalVotes</entry>
  698. <entry>string</entry>
  699. <entry>Total de votos </entry>
  700. </row>
  701. <row>
  702. <entry>Date</entry>
  703. <entry>string</entry>
  704. <entry>Data</entry>
  705. </row>
  706. <row>
  707. <entry>Summary</entry>
  708. <entry>string</entry>
  709. <entry>Resumo</entry>
  710. </row>
  711. <row>
  712. <entry>Content</entry>
  713. <entry>string</entry>
  714. <entry>Conteúdo</entry>
  715. </row>
  716. </tbody>
  717. </tgroup>
  718. </table>
  719. <para>
  720. <link linkend="zend.service.amazon.classes">Retornar para a Lista de
  721. Classes</link>
  722. </para>
  723. </sect4>
  724. </sect3>
  725. <sect3 id="zend.service.amazon.classes.editorialreview">
  726. <title>Zend_Service_Amazon_EditorialReview</title>
  727. <para>As críticas editoriais são retornadoas como objetos
  728. <code>Zend_Service_Amazon_EditorialReview</code></para>
  729. <sect4 id="zend.service.amazon.classes.editorialreview.properties">
  730. <title>Propriedades</title>
  731. <table>
  732. <title>Propriedades de Zend_Service_Amazon_EditorialReview</title>
  733. <tgroup cols="3">
  734. <thead>
  735. <row>
  736. <entry>Name</entry>
  737. <entry>Type</entry>
  738. <entry>Description</entry>
  739. </row>
  740. </thead>
  741. <tbody>
  742. <row>
  743. <entry>Source</entry>
  744. <entry>string</entry>
  745. <entry>Fonte da crítica editorial</entry>
  746. </row>
  747. <row>
  748. <entry>Content</entry>
  749. <entry>string</entry>
  750. <entry>Conteúdo</entry>
  751. </row>
  752. </tbody>
  753. </tgroup>
  754. </table>
  755. <para>
  756. <link linkend="zend.service.amazon.classes">Retornar para a Lista de
  757. Classes</link>
  758. </para>
  759. </sect4>
  760. </sect3>
  761. <sect3 id="zend.service.amazon.classes.listmania">
  762. <title>Zend_Service_Amazon_Listmania</title>
  763. <para>Os ítens da lista List Mania são retornados como objetos
  764. <code>Zend_Service_Amazon_Listmania</code>.</para>
  765. <sect4 id="zend.service.amazon.classes.listmania.properties">
  766. <title>Propriedades</title>
  767. <table>
  768. <title>Propriedades de Zend_Service_Amazon_Listmania</title>
  769. <tgroup cols="3">
  770. <thead>
  771. <row>
  772. <entry>Name</entry>
  773. <entry>Type</entry>
  774. <entry>Description</entry>
  775. </row>
  776. </thead>
  777. <tbody>
  778. <row>
  779. <entry>ListId</entry>
  780. <entry>string</entry>
  781. <entry>List ID</entry>
  782. </row>
  783. <row>
  784. <entry>ListName</entry>
  785. <entry>string</entry>
  786. <entry>List Name</entry>
  787. </row>
  788. </tbody>
  789. </tgroup>
  790. </table>
  791. <para>
  792. <link linkend="zend.service.amazon.classes">Retornar para a Lista de
  793. Classes</link>
  794. </para>
  795. </sect4>
  796. </sect3>
  797. </sect2>
  798. </sect1>
  799. <!--
  800. vim:se ts=4 sw=4 et:
  801. -->