Próximos cambios en la API de búsqueda para afiliados

api1 La API de eBay es la herramienta más sólida que ofrecemos actualmente a los afiliados. Puedes usar la API para obtener información de todos los anuncios de eBay en tiempo real y de forma flexible, según las necesidades de tu aplicación. La API de búsqueda es la API más utilizada para acceder a los resultados de búsqueda de eBay y tiene una amplia selección de filtros y otros criterios de búsqueda. Esta nueva API incorpora la tecnología de búsqueda más avanzada de eBay y, con respecto a la API anterior, ofrece mayores posibilidades de ampliación y un rendimiento mejorados.

La semana del 23 de mayo realizaremos algunos cambios en las URLs para pulsar incluidas en las llamadas de la API de búsqueda de eBay. Como probablemente sabrás, muchas llamadas de API de eBay devuelven vínculos de ePN con formato en la respuesta si incluyes tu información de seguimiento en la llamada de API.

Esto es un ejemplo de una llamada de la API de búsqueda con seguimiento de afiliado:

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

En la respuesta a esta llamada, actualmente se ven URLs para pulsar que tienen este aspecto:

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

Actualizaremos este vínculo con el identificador de herramienta correcto y una estructura de vínculo de identificador de artículo simplificada (para reemplazar la estructura de vínculo de URL personalizada que existe actualmente). Se añadirán también dos nuevos parámetros: lgeo y vectorid. Estos parámetros son de uso interno y no se deben modificar. Después de realizar estos cambios, el vínculo tendrá este aspecto:

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

Es muy importante que apliques estos cambios a tus aplicaciones. Si proporcionas información de seguimiento y utilizas el identificador de herramienta adecuado, te asegurarás de obtener las URLs de ePN correctas y se rellenará automáticamente el identificador de herramienta correcto en los informes. Para obtener más información sobre cómo especificar tu información de seguimiento de ePN, consulta la documentación de la API de búsqueda.

Dedica también un momento a comunicarnos tu identificador de usuario del Programa para desarrolladores de eBay; para ello, identifícate en el portal de ePN y ve a Cuenta > Información de empresa. Si vinculas tus cuentas en ePN, nos será más fácil ayudarte si surgen problemas con la API y podremos hacerte llegar directamente cualquier actualización de las nuevas capacidades de la API.

¿Todavía utilizas las APIs de compras y de transacciones para las llamadas de búsqueda?

En el blog del Programa para desarrolladores de eBay puedes encontrar más información sobre el uso desaconsejado de las siguientes llamadas de API, que son populares entre los afiliados:

• API de compras: FindItemsAdvanced y FindItems • API de transacciones: GetSearchResults y GetCategoryListings

Estas llamadas de API no estarán disponibles a partir de octubre de 2011 y puede que recibas mensajes de advertencia a principios de junio si todavía las utilizas. Recuerda que tus aplicaciones podrían dejar de funcionar si no corriges las situaciones que están provocando los mensajes de error que devuelve la API.

Aquí tienes información destacada del blog del Programa para desarrolladores. Esperamos que te resulte útil a la hora de planificar la migración de las llamadas de las APIs de compras y de transacciones a la API de búsqueda.

Características disponibles únicamente en la API de búsqueda:

1. Recuperación de histogramas de aspecto y filtros por aspectos y/o dominios

2. Nuevas funciones de búsqueda:

  • Histograma y filtros de estado del artículo
  • Restricción de las búsquedas a un máximo de 3 categorías a la vez
  • Filtros de envío urgente
  • Filtro de solo vendedores excelentes
  • Filtro de solo se aceptan devoluciones

3. API de búsqueda de imágenes(findItemsByImage): ampliación de las capacidades de eBay en Moda para los desarrolladores, en la funcionalidad "Más como este".

4. Posibilidad de elegir entre tres medidas de imagen de la galería (140x140, 96x96 y 80x80) según las necesidades de su aplicación.

5. Futuras mejoras para filtros de URL de imagen, multivariaciones, LocatedIn, etc., que se lanzarán en mayo.

¿Cómo puedo obtener más información sobre la migración a la API de búsqueda?

En las siguientes guías de migración se describen los campos de entrada y salida de GetSearchResults, en la API de compras, y de FindItemsAdvanced, en la API de ventas, para los correspondientes campos de entrada y salida de findItemsAdvanced en la API de búsqueda:

Te invitamos a que te pongas en contacto con el Programa para desarrolladores de eBay si tienes preguntas o quieres más información sobre la API de búsqueda o la migración.

-El equipo de eBay Partner Network