Prochaines modifications de l'API Finding pour les affiliés

L'API eBay est l'outil le plus puissant que nous mettons actuellement à la disposition des éditeurs. Elle permet d'obtenir des informations en temps réel pour toutes les annonces eBay et offre la flexibilité nécessaire pour répondre aux besoins de chaque application. L'API Finding est l'API la plus utilisée pour accéder à des résultats de recherche sur eBay car elle offre de nombreux filtres et d'autres critères de recherche. Elle représente l'évolution la plus récente de la technologie de recherche d'eBay et offre des performances et une évolutivité accrues par rapport aux API de recherche précédentes.

Au cours de la semaine du 23 mai, nous apporterons certaines modifications aux URL fournies dans les appels à l'API eBay Finding. Comme vous le savez sans doute, de nombreux appels aux API eBay renvoient des liens eBay Partner Network au format correct si vous fournissez vos informations de suivi dans l'appel à l'API.

Voici un exemple d'appel à l'API Finding avec suivi de l'affilié :

http://svcs.ebay.com/services/search/FindingService/v1?OPERATION-NAME=findItemsByKeywords&SERVICE-VERSION=1.9.0&SECURITY-APPNAME=Your-App-ID&RESPONSE-DATA-FORMAT=XML&REST-PAYLOAD&affiliate.networkId=9&affiliate.trackingId=1234567890&affiliate.customId=mycustomid&
sortOrder=EndTime&paginationInput.entriesPerPage=2&keywords=elmo

La réponse à cet appel comporte actuellement des URL semblables à celle-ci :

http://rover.ebay.com/rover/1/711-53200-19255-0/1?campid=1234567890&customid=mycustomid&toolid=0&mpre=http%3A%2F%2Fcgi.ebay.com%2F
Sesame-Street-Fisher-Price-2008-Farmer-Country-Elmo-11-%2F190527439548%3Fpt%3DLH_DefaultDomain_0

Nous allons mettre à jour ce lien en y ajoutant le code d'outil approprié et une structure de lien simplifiée pour le numéro de l'objet (pour remplacer la structure de l'URL personnalisée actuellement utilisée). Deux nouveaux paramètres vont également être ajoutés : lgeo et vectorid. Ils sont destinés à un usage interne et ne doivent pas être modifiés. Après ces modifications, le lien se présentera comme suit :

http://rover.ebay.com/rover/1/711-53200-19255-0/1?ff3=2&toolid=10041&campid=1234567890&customid=mycustomid&lgeo=0&vectorid=229466&item
=190527439548

Il est essentiel que vous adoptiez ces modifications dans vos applications. En fournissant vos informations de suivi et en utilisant le bon code d'outil, vous vous assurerez d'obtenir les URL eBay Partner Network correctes et le code d'outil correct sera renseigné automatiquement pour être utilisé dans vos rapports. Pour savoir comment spécifier vos informations de suivi eBay Partner Network, consultez la Documentation de l'API Finding.

Prenez également le temps de nous communiquer votre pseudo du Programme des développeurs eBay en vous connectant au portail eBay Partner Network et en accédant aux sections Compte > Informations sur votre activité. En liant vos comptes au sein d'eBay Partner Network, vous nous permettez de vous offrir un meilleur service en cas de problème lié à l'API et de vous communiquer directement toute mise à jour concernant les API.

Vous utilisez toujours les API Shopping et Trading pour les appels de recherche ?

Le blog du Programme des développeurs eBay contient des informations supplémentaires concernant la disparition progressive des appels aux API suivants souvent utilisés par les affiliés :

• API Shopping : FindItemsAdvanced et FindItems • API Trading : GetSearchResults et GetCategoryListings

Ces appels aux API ne seront plus disponibles après le mois d'octobre 2011. Si vous les utilisez encore, il est possible que vous commenciez à recevoir des messages d'avertissement dès le début du mois de juin. Faute d'un traitement adéquat des messages d'erreur envoyés par l'API, le fonctionnement normal de vos applications risque d'être perturbé.

Voici certains points importants de l'article de blog du Programme des développeurs qui vous aideront peut-être à planifier votre migration des appels aux API Shopping/Trading vers l'API Finding.

Fonctionnalités disponibles uniquement dans l'API Finding :

1. Recherche d'histogrammes d'aspect et filtrage des résultats en fonction des aspects et/ou domaines

2. Prise en charge de nouvelles options de recherche :

  • Histogramme et filtres Etat de l'objet
  • Recherches restreintes pouvant couvrir jusqu'à 3 catégories en même temps
  • Filtres Livraison prioritaire
  • Filtre Vendeurs Top Notés uniquement
  • Filtre Retours acceptés uniquement

3. API de recherche d'images (findItemsByImage) : extension des options eBay dans la catégorie Mode pour les développeurs dans le cadre de la fonctionnalité A voir aussi.

4. Trois tailles de photos de la galerie : 140x140, 96x96, 80x80 à choisir en fonction des besoins de l'application.

5. Améliorations futures des filtres URL de la photo, Versions multiples, LocatedIn, etc. à venir en mai.

Comment en savoir plus sur la migration vers l'API Finding ?

Les guides de migration suivants présentent les champs de valeurs et de résultats pour GetSearchResults dans l'API Trading et FindItemsAdvanced dans l'API Shopping en les mettant en correspondance avec les champs de findItemsAdvanced dans l'API Finding :

N'hésitez pas à contacter le Programme des développeurs eBay pour toute question ou pour en savoir plus sur l'API Finding ou sur la migration.

-L'équipe eBay Partner Network