repo_zf1/documentation/manual/fr/module_specs/Zend_Service_Amazon.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24782 -->
<!-- Reviewed: no -->
<sect1 id="zend.service.amazon">
    <title>Zend_Service_Amazon</title>

    <sect2 id="zend.service.amazon.introduction">
        <title>Introduction</title>

        <para>
            <classname>Zend_Service_Amazon</classname> est une <acronym>API</acronym> simple pour utiliser les
            Web services d'Amazon. <classname>Zend_Service_Amazon</classname> a deux <acronym>API</acronym>s : une
            plutôt traditionnelle qui suit la propre <acronym>API</acronym> d'Amazon, et un "Query <acronym>API</acronym>" simplifiée pour
            construire facilement des requêtes de recherche, même compliquées.
        </para>

        <para>
            <classname>Zend_Service_Amazon</classname> permet aux développeurs de récupérer
            des informations disponible sur le site Amazon.com directement à travers l'API Amazon
            Web Services. Les exemples incluent : <itemizedlist>
                    <listitem>
                    <para>
                        Le stockage de données informatives, comme des images, des
                        descriptions, le prix et plus
                    </para>
                </listitem>

                <listitem>
                    <para>Revues éditoriales et commerciales</para>
                </listitem>

                <listitem>
                    <para>Des produits et accessoires similaires</para>
                </listitem>

                <listitem>
                    <para>Les offres Amazon.com</para>
                </listitem>

                <listitem>
                    <para>Les listes ListMania</para>
                </listitem>
                </itemizedlist>
            </para>

        <para>
            Pour pouvoir utiliser <classname>Zend_Service_Amazon</classname>, vous devez avant
            tout avoir une clé "developer <acronym>API</acronym>" Amazon ainsi que votre clé
            secrète. Pour obtenir une telle clé et pour plus d'informations, vous pouvez visitez
            le site Web <ulink url="http://aws.amazon.com/">Amazon Web Services</ulink>.
            A partir du 15 août 2009, vous ne pourrez utiliser l'API Amazon à travers
            <classname>Zend_Service_Amazon</classname>, quand spécifiant la clé secrète.
        </para>

        <note>
            <title>Attention</title>

            <para>
                Votre clé "developer <acronym>API</acronym>" et votre clé secret sont liées à votre
                identité Amazon, donc faites en sorte de les conserver privées.
            </para>
        </note>

        <example id="zend.service.amazon.introduction.example.itemsearch">
            <title>Recherche sur Amazon en utilisant l'API traditionnelle</title>

            <para>
                Dans cet exemple, nous recherchons les livres sur <acronym>PHP</acronym> disponibles chez Amazon
                et boucler sur les résultats pour les afficher.
            </para>

            <programlisting language="php"><![CDATA[
$amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'US', 'AMAZON_SECRET_KEY');
$response = $amazon->itemSearch(array('SearchIndex' => 'Books',
                                      'Keywords' => 'php'));
$results = $amazon->itemSearch(array('SearchIndex' => 'Books',
                                     'Keywords' => 'php'));
foreach ($results as $result) {
    echo $result->Title . '<br />';
}
]]></programlisting>
        </example>

        <example id="zend.service.amazon.introduction.example.query_api">
            <title>Recherche sur Amazon en utilisant l'API de requête</title>

            <para>
                Ici nous cherchons aussi les livres sur <acronym>PHP</acronym> disponibles chez Amazon, mais en
                utilisant l'API de requête, qui ressemble au modèle de conception Interface
                Fluide.
            </para>

            <programlisting language="php"><![CDATA[
$query = new Zend_Service_Amazon_Query('AMAZON_API_KEY',
                                       'US',
                                       'AMAZON_SECRET_KEY');
$query->category('Books')->Keywords('PHP');
$results = $query->search();
foreach ($results as $result) {
    echo $result->Title . '<br />';
}
]]></programlisting>
        </example>
    </sect2>

    <sect2 id="zend.service.amazon.countrycodes">
        <title>Codes de pays</title>

        <para>
            Par défaut, <classname>Zend_Service_Amazon</classname> se connecte au Web service
            Amazon américain ("<code>US</code>"). Pour se connecter depuis un pays différent, il
            vous suffit simplement de définir, comme second paramètre du constructeur, la chaîne de
            caractère correspondant au code du pays :
        </para>

        <example id="zend.service.amazon.countrycodes.example.country_code">
            <title>Choisir un service Web Amazon d'un pays</title>

            <programlisting language="php"><![CDATA[
// Connexion à Amazon France
$amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'FR', 'AMAZON_SECRET_KEY');
]]></programlisting>
        </example>

        <note>
            <title>Codes de pays</title>

            <para>
                Les codes de pays valides sont <code>CA</code>, <code>DE</code>,
                <code>FR</code>, <code>JP</code>, <code>UK</code>, et <code>US</code>.
            </para>
        </note>
    </sect2>

    <sect2 id="zend.service.amazon.itemlookup">
        <title>Rechercher un produit Amazon spécifique avec son ASIN</title>

        <para>
            La méthode <methodname>itemLookup()</methodname> fournit la possibilité de rechercher un
            produit Amazon particulier lorsque son <acronym>ASIN</acronym> est connu.
        </para>

        <example>
            <title>Rechercher une produit Amazon spécifique avec son ASIN</title>

            <programlisting language="php"><![CDATA[
$amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'US', 'AMAZON_SECRET_KEY');
$item = $amazon->itemLookup('B0000A432X');
]]></programlisting>
        </example>

        <para>
            La méthode <methodname>itemLookup()</methodname> accepte aussi un second paramètre optionnel
            pour gérer les options de recherche. Pour les détails complets et une liste des options
            disponibles, visitez <ulink
            url="http://www.amazon.com/gp/aws/sdk/main.html/103-9285448-4703844?s=AWSEcommerceService&amp;v=2011-08-01&amp;p=ApiReference/ItemLookupOperation">
            la documentation Amazon correspondante. </ulink>.
        </para>

        <note>
            <title>Information sur les images</title>

            <para>
                Pour récupérer les informations d'images pour vos résultats de recherche, vous
                devez définir l'option <code>ResponseGroup</code> à <code>Medium</code> ou
                <code>Large</code>.
            </para>
        </note>
    </sect2>

    <sect2 id="zend.service.amazon.itemsearch">
        <title>Lancer des recherches de produits sur Amazon</title>

        <para>
            Rechercher des produits basés sur tous les divers critères disponibles sont rendus
            simples grâce à la méthode <methodname>itemSearch()</methodname>, comme le montre l'exemple suivant
            :
        </para>

        <example id="zend.service.amazon.itemsearch.example.basic">
            <title>Lancer des recherches de produits sur Amazon</title>

            <programlisting language="php"><![CDATA[
$amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'US', 'AMAZON_SECRET_KEY');
$results = $amazon->itemSearch(array('SearchIndex' => 'Books',
                                     'Keywords' => 'php'));
foreach ($results as $result) {
    echo $result->Title . '<br />';
}
]]></programlisting>
        </example>

        <example id="zend.service.amazon.itemsearch.example.responsegroup">
            <title>Utilisation de l'option <code>ResponseGroup</code></title>

            <para>
                L'option <code>ResponseGroup</code> est utilisée pour contrôler les
                informations spécifiques qui sont retournées dans la réponse.
            </para>

            <programlisting language="php"><![CDATA[
$amazon = new Zend_Service_Amazon('AMAZON_API_KEY', 'US', 'AMAZON_SECRET_KEY');
$results = $amazon->itemSearch(array(
    'SearchIndex'   => 'Books',
    'Keywords'      => 'php',
    'ResponseGroup' => 'Small,ItemAttributes,Images,'
                     . 'SalesRank,Reviews,EditorialReview,'
                     . 'Similarities,ListmaniaLists'
    ));
foreach ($results as $result) {
    echo $result->Title . '<br />';
}
]]></programlisting>
        </example>

        <para>
            La méthode <methodname>itemSearch()</methodname> accepte un seul tableau en paramètre pour
            gérer les options de recherche. Pour plus de détails et une liste des options
            disponibles, visitez <ulink
            url="http://www.amazon.com/gp/aws/sdk/main.html/103-9285448-4703844?s=AWSEcommerceService&amp;v=2011-08-01&amp;p=ApiReference/ItemSearchOperation">
            la documentation Amazon correspondante </ulink>
        </para>

        <tip>
            <para>
                La classe <link
                linkend="zend.service.amazon.query"><classname>Zend_Service_Amazon_Query</classname></link>
                est une enveloppe simple d'utilisation de cette méthode.
            </para>
        </tip>
    </sect2>

    <sect2 id="zend.service.amazon.query">
        <title>Utiliser l'API alternative de requêtes</title>

        <sect3 id="zend.service.amazon.query.introduction">
            <title>Introduction</title>

            <para>
                <classname>Zend_Service_Amazon_Query</classname> fournit une <acronym>API</acronym> alternative
                pour utiliser le service Web Amazon. L'API alternative utilise le modèle de
                conception 'Interface Fluide'. C'est à dire que les appels peuvent-être fait en
                utilisant une chaîne d'appels de méthodes (ie
                <code>$obj-&gt;method()-&gt;method2($arg)</code>)
            </para>

            <para>
                L'API <classname>Zend_Service_Amazon_Query</classname> utilise la surcharge
                pour mettre en place facilement une recherche d'article, et ainsi vous permettre de
                chercher en se basant sur les critères spécifiés. Chacune de ces options est fournie
                en tant qu'appel de méthode, et chaque paramètre de méthode correspond à la valeur
                des options nommées.
            </para>

            <example id="zend.service.amazon.query.introduction.example.basic">
                <title>Rechercher sur Amazon en utilisant l'API alternative de requêtes</title>

                <para>
                    Dans cet exemple, l'API de requêtes alternative est utilisée comme une
                    interface fluide pour spécifier les options et leurs valeurs respectives
                    :
                </para>

                <programlisting language="php"><![CDATA[
$query = new Zend_Service_Amazon_Query('MY_API_KEY', 'US', 'AMAZON_SECRET_KEY');
$query->Category('Books')->Keywords('PHP');
$results = $query->search();
foreach ($results as $result) {
    echo $result->Title . '<br />';
}
]]></programlisting>

                <para>
                    Cela définit l'option <code>Category</code> à "Livres" et
                    <code>Keywords</code> à "PHP".
                </para>

                <para>
                    Pour plus d'information sur les options disponibles, vous pouvez vous
                    référer à la <ulink
                    url="http://www.amazon.com/gp/aws/sdk/main.html/102-9041115-9057709?s=AWSEcommerceService&amp;v=2011-08-01&amp;p=ApiReference/ItemSearchOperation">documentation
                    spécifique</ulink>.
                </para>
            </example>
        </sect3>
    </sect2>

    <sect2 id="zend.service.amazon.classes">
        <title>Classes Zend_Service_Amazon</title>

        <para>
            Les classes suivantes sont toutes retournées par <link
            linkend="zend.service.amazon.itemlookup"><methodname>Zend_Service_Amazon::itemLookup()</methodname></link>
            et <link
            linkend="zend.service.amazon.itemsearch"><methodname>Zend_Service_Amazon::itemSearch()</methodname></link>:
            <itemizedlist>
                    <listitem>
                    <para>
                        <link
                        linkend="zend.service.amazon.classes.item"><classname>Zend_Service_Amazon_Item</classname></link>
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <link
                        linkend="zend.service.amazon.classes.image"><classname>Zend_Service_Amazon_Image</classname></link>
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <link
                        linkend="zend.service.amazon.classes.resultset"><classname>Zend_Service_Amazon_ResultSet</classname></link>
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <link
                        linkend="zend.service.amazon.classes.offerset"><classname>Zend_Service_Amazon_OfferSet</classname></link>
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <link
                        linkend="zend.service.amazon.classes.offer"><classname>Zend_Service_Amazon_Offer</classname></link>
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <link
                        linkend="zend.service.amazon.classes.similarproduct"><classname>Zend_Service_Amazon_SimilarProduct</classname></link>
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <link
                        linkend="zend.service.amazon.classes.accessories"><classname>Zend_Service_Amazon_Accessories</classname></link>
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <link
                        linkend="zend.service.amazon.classes.customerreview"><classname>Zend_Service_Amazon_CustomerReview</classname></link>
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <link
                        linkend="zend.service.amazon.classes.editorialreview"><classname>Zend_Service_Amazon_EditorialReview</classname></link>
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <link
                        linkend="zend.service.amazon.classes.listmania"><classname>Zend_Service_Amazon_ListMania</classname></link>
                    </para>
                </listitem>
                </itemizedlist>
            </para>

        <sect3 id="zend.service.amazon.classes.item">
            <title>Zend_Service_Amazon_Item</title>

            <para>
                <classname>Zend_Service_Amazon_Item</classname> est le type de classe utilisé
                pour représenter un produit Amazon retourné par le service Web. Elle récupère tous
                les attributs des articles, incluant le titre, la description, les revues,
                etc.
            </para>

            <sect4 id="zend.service.amazon.classes.item.asxml">
                <title>Zend_Service_Amazon_Item::asXML()</title>

                <para>
                    <methodsynopsis>
                            <type>string</type>

                            <methodname>asXML</methodname>

                            <void />
                        </methodsynopsis>
                    </para>

                <para>Retourne le <acronym>XML</acronym> original de l'article</para>
            </sect4>

            <sect4 id="zend.service.amazon.classes.item.properties">
                <title>Propriétés</title>

                <para>
                    <classname>Zend_Service_Amazon_Item</classname> a un nombre de propriétés
                    directement relié à leur contre-parties de l'API standard Amazon.
                </para>

                <table id="zend.service.amazon.classes.item.properties.table-1">
                    <title>Propriétés de Zend_Service_Amazon_Item</title>

                    <tgroup cols="3">
                        <thead>
                            <row>
                                <entry>Nom</entry>
                                <entry>Type</entry>
                                <entry>Description</entry>
                            </row>
                        </thead>

                        <tbody>
                            <row>
                                <entry><acronym>ASIN</acronym></entry>
                                <entry>string</entry>
                                <entry>Amazon Item ID</entry>
                            </row>

                            <row>
                                <entry>DetailPageURL</entry>
                                <entry>string</entry>
                                <entry>URL pour la page de détail des articles</entry>
                            </row>

                            <row>
                                <entry>SalesRank</entry>
                                <entry>int</entry>
                                <entry>Niveau de vente pour cet article</entry>
                            </row>

                            <row>
                                <entry>SmallImage</entry>
                                <entry>Zend_Service_Amazon_Image</entry>
                                <entry>Petite image de l'article</entry>
                            </row>

                            <row>
                                <entry>MediumImage</entry>
                                <entry>Zend_Service_Amazon_Image</entry>
                                <entry>Image moyenne de l'article</entry>
                            </row>

                            <row>
                                <entry>LargeImage</entry>
                                <entry>Zend_Service_Amazon_Image</entry>
                                <entry>Grande image de l'article</entry>
                            </row>

                            <row>
                                <entry>Subjects</entry>
                                <entry>array</entry>
                                <entry>Sujets de l'article</entry>
                            </row>

                            <row>
                                <entry>Les offres</entry>
                                <entry><code> <link
                                linkend="zend.service.amazon.classes.offerset">Zend_Service_Amazon_OfferSet</link>
                                </code></entry>
                                <entry>Sommaire des offres, et offres pour l'article</entry>
                            </row>

                            <row>
                                <entry>CustomerReviews</entry>
                                <entry>array</entry>
                                <entry>Les revues clients sont représentées comme un tableau
                                d'objets <code> <link
                                linkend="zend.service.amazon.classes.customerreview">Zend_Service_Amazon_CustomerReview</link>
                                </code></entry>
                            </row>

                            <row>
                                <entry>EditorialReviews</entry>
                                <entry>array</entry>
                                <entry>Les revues éditoriales sont représentées comme un tableau
                                d'objets <code> <link
                                linkend="zend.service.amazon.classes.editorialreview">Zend_Service_Amazon_EditorialReview</link>
                                </code></entry>
                            </row>

                            <row>
                                <entry>SimilarProducts</entry>
                                <entry>array</entry>
                                <entry>Les produits similaires sont représentés comme un tableau
                                d'objets <code> <link
                                linkend="zend.service.amazon.classes.similarproduct">Zend_Service_Amazon_SimilarProduct</link>
                                </code></entry>
                            </row>

                            <row>
                                <entry>Accessories</entry>
                                <entry>array</entry>
                                <entry>Les accessoires pour l'article sont représentés comme un
                                tableau d'objets <code> <link
                                linkend="zend.service.amazon.classes.accessories">Zend_Service_Amazon_Accessories</link>
                                </code></entry>
                            </row>

                            <row>
                                <entry>Tracks</entry>
                                <entry>array</entry>
                                <entry>Un tableau contenant le nombre de pistes ainsi que les
                                noms pour les CDs ou <constant>DVDs</constant> musicaux</entry>
                            </row>

                            <row>
                                <entry>ListmaniaLists</entry>
                                <entry>array</entry>
                                <entry>Les listes Listmania reliées à un article, comme un
                                tableau d'objets <code> <link
                                linkend="zend.service.amazon.classes.listmania">Zend_Service_Amazon_ListmaniaList</link>
                                </code></entry>
                            </row>

                            <row>
                                <entry>PromotionalTag</entry>
                                <entry>string</entry>
                                <entry>Balise promotionnelle de l'article</entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>

                <para>
                    <link linkend="zend.service.amazon.classes">Retour à la liste des
                    classes</link>
                </para>
            </sect4>
        </sect3>

        <sect3 id="zend.service.amazon.classes.image">
            <title>Zend_Service_Amazon_Image</title>

            <para>
                <classname>Zend_Service_Amazon_Image</classname> représente une image distante
                pour un produit.
            </para>

            <sect4 id="zend.service.amazon.classes.image.properties">
                <title>Propriétés</title>

                <table id="zend.service.amazon.classes.image.properties.table-1">
                    <title>Propriétés de Zend_Service_Amazon_Image</title>

                    <tgroup cols="3">
                        <thead>
                            <row>
                                <entry>Name</entry>
                                <entry>Type</entry>
                                <entry>Description</entry>
                            </row>
                        </thead>

                        <tbody>
                            <row>
                                <entry>Url</entry>
                                <entry>Zend_Uri</entry>
                                <entry>Url distante de l'image</entry>
                            </row>

                            <row>
                                <entry>Height</entry>
                                <entry>int</entry>
                                <entry>La hauteur (en pixels) de l'image</entry>
                            </row>

                            <row>
                                <entry>Width</entry>
                                <entry>int</entry>
                                <entry>La largeur (en pixels) de l'image</entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>

                <para>
                    <link linkend="zend.service.amazon.classes">Retour à la liste des
                    classes</link>
                </para>
            </sect4>
        </sect3>

        <sect3 id="zend.service.amazon.classes.resultset">
            <title>Zend_Service_Amazon_ResultSet</title>

            <para>
                Des objets <classname>Zend_Service_Amazon_ResultSet</classname> sont retournés
                par <link
                linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link> et
                vous permettent de gérer facilement les différents résultats retournés.
            </para>

            <note>
                <title>SeekableIterator</title>

                <para>
                    Implémente l'itérateur <code>SeekableIterator</code> pour une itération
                    simple (en utilisant <code>foreach</code>), aussi bien que l'accès direct à une
                    <acronym>URL</acronym> spécifique en utilisant <methodname>seek()</methodname>.
                </para>
            </note>

            <sect4 id="zend.service.amazon.classes.resultset.totalresults">
                <title>Zend_Service_Amazon_ResultSet::totalResults()</title>

                <methodsynopsis>
                    <type>int</type>

                    <methodname>totalResults</methodname>

                    <void />
                </methodsynopsis>

                <para>Retourne le nombre total de résultats de la recherche</para>

                <para>
                    <link linkend="zend.service.amazon.classes">Retour à la liste des
                    classes</link>
                </para>
            </sect4>
        </sect3>

        <sect3 id="zend.service.amazon.classes.offerset">
            <title>Zend_Service_Amazon_OfferSet</title>

            <para>
                Chaque résultat retourné par <link
                linkend="zend.service.amazon.itemsearch">Zend_Service_Amazon::itemSearch()</link> et
                <link
                linkend="zend.service.amazon.itemlookup">Zend_Service_Amazon::itemLookup()</link>
                contient un objet <classname>Zend_Service_Amazon_OfferSet</classname> au travers
                duquel il est possible de récupérer les informations de prix de l'article.
            </para>

            <sect4 id="zend.service.amazon.classes.offerset.parameters">
                <title>Propriétés</title>

                <table id="zend.service.amazon.classes.offerset.parameters.table-1">
                    <title>Propriétés de Zend_Service_Amazon_OfferSet</title>

                    <tgroup cols="3">
                        <thead>
                            <row>
                                <entry>Name</entry>
                                <entry>Type</entry>
                                <entry>Description</entry>
                            </row>
                        </thead>

                        <tbody>
                            <row>
                                <entry>LowestNewPrice</entry>
                                <entry>int</entry>
                                <entry>Le plus bas prix pour l'article en condition "New" (ie
                                les articles neufs)</entry>
                            </row>

                            <row>
                                <entry>LowestNewPriceCurrency</entry>
                                <entry>string</entry>
                                <entry>La devise pour le <code>LowestNewPrice</code></entry>
                            </row>

                            <row>
                                <entry>LowestOldPrice</entry>
                                <entry>int</entry>
                                <entry>Le plus bas prix pour l'article en condition "Used" (ie
                                les articles d'occasion)</entry>
                            </row>

                            <row>
                                <entry>LowestOldPriceCurrency</entry>
                                <entry>string</entry>
                                <entry>La devise pour le <code>LowestOldPrice</code></entry>
                            </row>

                            <row>
                                <entry>TotalNew</entry>
                                <entry>int</entry>
                                <entry>Le nombre total des conditions "new" disponibles pour cet
                                article (ie le nombre de modèles neufs en stock)</entry>
                            </row>

                            <row>
                                <entry>TotalUsed</entry>
                                <entry>int</entry>
                                <entry>Le nombre total des conditions "used" disponible pour cet
                                article (ie le nombre de modèles d'occasion en stock)</entry>
                            </row>

                            <row>
                                <entry>TotalCollectible</entry>
                                <entry>int</entry>
                                <entry>Le nombre total des conditions "collectible" disponible
                                pour cet article (ie le nombre de pièces de collection en
                                stock)</entry>
                            </row>

                            <row>
                                <entry>TotalRefurbished</entry>
                                <entry>int</entry>
                                <entry>Le nombre total des conditions "refurbished" disponible
                                pour cet article (ie le nombre de pièces remise à neuf en
                                stock)</entry>
                            </row>

                            <row>
                                <entry>Offers</entry>
                                <entry>array</entry>
                                <entry>Un tableau d'objets
                                <classname>Zend_Service_Amazon_Offer</classname></entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>

                <para>
                    <link linkend="zend.service.amazon.classes">Retour à la liste des
                    classes</link>
                </para>
            </sect4>
        </sect3>

        <sect3 id="zend.service.amazon.classes.offer">
            <title>Zend_Service_Amazon_Offer</title>

            <para>
                Chaque offre pour un article est retourné sous la forme d'un objet
                <classname>Zend_Service_Amazon_Offer</classname>.
            </para>

            <sect4 id="zend.service.amazon.classes.offer.properties">
                <title>Zend_Service_Amazon_Offer Properties</title>

                <table>
                    <title>Propriétés de Zend_Service_Amazon_Offer</title>

                    <tgroup cols="3">
                        <thead>
                            <row>
                                <entry>Name</entry>
                                <entry>Type</entry>
                                <entry>Description</entry>
                            </row>
                        </thead>

                        <tbody>
                            <row>
                                <entry>MerchantId</entry>
                                <entry>string</entry>
                                <entry>ID Amazon du fournisseur</entry>
                            </row>

                             <row>
                                <entry>MerchantName</entry>
                                <entry>string</entry>
                                <entry>
                                    Nom du fournisseur Amazon. Nécessite le réglage de
                                    <code>ResponseGroup</code> à <code>OfferFull</code>
                                    pour la récupération.
                                </entry>
                            </row>

                            <row>
                                <entry>GlancePage</entry>
                                <entry>string</entry>
                                <entry>URL de la page avec un résumé du fournisseur</entry>
                            </row>

                            <row>
                                <entry>Condition</entry>
                                <entry>string</entry>
                                <entry>Condition de cet article</entry>
                            </row>

                            <row>
                                <entry>OfferListingId</entry>
                                <entry>string</entry>
                                <entry>ID de la liste d'offre</entry>
                            </row>

                            <row>
                                <entry>Price</entry>
                                <entry>int</entry>
                                <entry>Prix de l'article</entry>
                            </row>

                            <row>
                                <entry>CurrencyCode</entry>
                                <entry>string</entry>
                                <entry>Code de la devise pour le prix de l'article</entry>
                            </row>

                            <row>
                                <entry>Availability</entry>
                                <entry>string</entry>
                                <entry>Disponibilité de l'article</entry>
                            </row>

                            <row>
                                <entry>IsEligibleForSuperSaverShipping</entry>
                                <entry>boolean</entry>
                                <entry>Est-ce que l'article est éligible ou pas pour un "Super
                                Saver Shipping"</entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>

                <para>
                    <link linkend="zend.service.amazon.classes">Retour à la liste des
                    classes</link>
                </para>
            </sect4>
        </sect3>

        <sect3 id="zend.service.amazon.classes.similarproduct">
            <title>Zend_Service_Amazon_SimilarProduct</title>

            <para>
                Lors de la recherche d'articles, Amazon retourne aussi une liste de produits
                similaires qui pourraient intéresser le visiteur. Chacun d'entre eux est retourné
                dans un objet <classname>Zend_Service_Amazon_SimilarProduct</classname>.
            </para>

            <para>
                Chaque objet contient l'information qui vous permet de faire les requêtes
                suivantes pour obtenir les informations complètes sur un article.
            </para>

            <sect4 id="zend.service.amazon.classes.similarproduct.properties">
                <title>Propriétés</title>

                <table id="zend.service.amazon.classes.similarproduct.properties.table-1">
                    <title>Propriétés de Zend_Service_Amazon_SimilarProduct</title>

                    <tgroup cols="3">
                        <thead>
                            <row>
                                <entry>Name</entry>
                                <entry>Type</entry>
                                <entry>Description</entry>
                            </row>
                        </thead>

                        <tbody>
                            <row>
                                <entry><acronym>ASIN</acronym></entry>
                                <entry>string</entry>
                                <entry>Identifiant unique d'un produit Amazon (ASIN)</entry>
                            </row>

                            <row>
                                <entry>Title</entry>
                                <entry>string</entry>
                                <entry>Intitulé du produit</entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>

                <para>
                    <link linkend="zend.service.amazon.classes">Retour à la liste des
                    classes</link>
                </para>
            </sect4>
        </sect3>

        <sect3 id="zend.service.amazon.classes.accessories">
            <title>Zend_Service_Amazon_Accessories</title>

            <para>
                Les accessoires pour un article retourné sont représentés comme un objet
                <classname>Zend_Service_Amazon_Accessories</classname>.
            </para>

            <sect4 id="zend.service.amazon.classes.accessories.properties">
                <title>Propriétés</title>

                <table id="zend.service.amazon.classes.accessories.properties.table-1">
                    <title>Propriétés de Zend_Service_Amazon_Accessories</title>

                    <tgroup cols="3">
                        <thead>
                            <row>
                                <entry>Name</entry>
                                <entry>Type</entry>
                                <entry>Description</entry>
                            </row>
                        </thead>

                        <tbody>
                            <row>
                                <entry><acronym>ASIN</acronym></entry>
                                <entry>string</entry>
                                <entry>Identifiant unique d'un produit Amazon (ASIN)</entry>
                            </row>

                            <row>
                                <entry>Title</entry>
                                <entry>string</entry>
                                <entry>Intitulé du produit</entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>

                <para>
                    <link linkend="zend.service.amazon.classes">Retour à la liste des
                    classes</link>
                </para>
            </sect4>
        </sect3>

        <sect3 id="zend.service.amazon.classes.customerreview">
            <title>Zend_Service_Amazon_CustomerReview</title>

            <para>
                Chaque revue de client est retournée sous la forme d'un objet
                <classname>Zend_Service_Amazon_CustomerReview</classname>.
            </para>

            <sect4 id="zend.service.amazon.classes.customerreview.properties">
                <title>Propriétés</title>

                <table id="zend.service.amazon.classes.customerreview.properties.table-1">
                    <title>Propriétés de Zend_Service_Amazon_CustomerReview</title>

                    <tgroup cols="3">
                        <thead>
                            <row>
                                <entry>Name</entry>
                                <entry>Type</entry>
                                <entry>Description</entry>
                            </row>
                        </thead>

                        <tbody>
                            <row>
                                <entry>Rating</entry>
                                <entry>string</entry>
                                <entry>Evaluation de l'article</entry>
                            </row>

                            <row>
                                <entry>HelpfulVotes</entry>
                                <entry>string</entry>
                                <entry>Votes pour "Ce commentaire vous a-t'il été utile
                                ?"</entry>
                            </row>

                            <row>
                                <entry>CustomerId</entry>
                                <entry>string</entry>
                                <entry>Identifiant du client</entry>
                            </row>

                            <row>
                                <entry>TotalVotes</entry>
                                <entry>string</entry>
                                <entry>Total des votes</entry>
                            </row>

                            <row>
                                <entry>Date</entry>
                                <entry>string</entry>
                                <entry>Date de la revue</entry>
                            </row>

                            <row>
                                <entry>Summary</entry>
                                <entry>string</entry>
                                <entry>Sommaire de la revue</entry>
                            </row>

                            <row>
                                <entry>Content</entry>
                                <entry>string</entry>
                                <entry>Contenu de la revue</entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>

                <para>
                    <link linkend="zend.service.amazon.classes">Retour à la liste des
                    classes</link>
                </para>
            </sect4>
        </sect3>

        <sect3 id="zend.service.amazon.classes.editorialreview">
            <title>Zend_Service_Amazon_EditorialReview</title>

            <para>
                Chaque revue éditoriale d'un article est retournée dans un objet
                <classname>Zend_Service_Amazon_EditorialReview</classname>.
            </para>

            <sect4 id="zend.service.amazon.classes.editorialreview.properties">
                <title>Propriétés</title>

                <table id="zend.service.amazon.classes.editorialreview.properties.table-1">
                    <title>Propriétés de Zend_Service_Amazon_EditorialReview</title>

                    <tgroup cols="3">
                        <thead>
                            <row>
                                <entry>Name</entry>
                                <entry>Type</entry>
                                <entry>Description</entry>
                            </row>
                        </thead>

                        <tbody>
                            <row>
                                <entry>Source</entry>
                                <entry>string</entry>
                                <entry>Source de la revue éditoriale</entry>
                            </row>

                            <row>
                                <entry>Content</entry>
                                <entry>string</entry>
                                <entry>Contenu de la revue</entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>

                <para>
                    <link linkend="zend.service.amazon.classes">Retour à la liste des
                    classes</link>
                </para>
            </sect4>
        </sect3>

        <sect3 id="zend.service.amazon.classes.listmania">
            <title>Zend_Service_Amazon_Listmania</title>

            <para>
                Chaque résultat de liste ListMania est retourné dans un objet
                <classname>Zend_Service_Amazon_Listmania</classname>.
            </para>

            <sect4 id="zend.service.amazon.classes.listmania.properties">
                <title>Propriétés</title>

                <table id="zend.service.amazon.classes.listmania.properties.table-1">
                    <title>Propriétés de Zend_Service_Amazon_Listmania</title>

                    <tgroup cols="3">
                        <thead>
                            <row>
                                <entry>Name</entry>
                                <entry>Type</entry>
                                <entry>Description</entry>
                            </row>
                        </thead>

                        <tbody>
                            <row>
                                <entry>ListId</entry>
                                <entry>string</entry>
                                <entry>Identifiant de la liste</entry>
                            </row>

                            <row>
                                <entry>ListName</entry>
                                <entry>string</entry>
                                <entry>Nom de la liste</entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>

                <para>
                    <link linkend="zend.service.amazon.classes">Retour à la liste des
                    classes</link>
                </para>
            </sect4>
        </sect3>
    </sect2>
</sect1>