COMMERCE_SERP con site google_shopping para recibir los productos que muestra una búsqueda, en el orden de la tienda, o COMMERCE_PRODUCT con la url de un producto para leer ese producto. Cada búsqueda o página de producto completada cuesta 2 créditos.
Búsqueda
GET /v1/async/task/{id} o recibe su webhook. Consulta Tareas asíncronas.
Parámetros
site: Obligatorio.google_shopping.query: Obligatorio. Consulta de búsqueda, de 1 a 500 caracteres.limit: Entero opcional de 1 a 40, con 20 por defecto.country: Opcional. Por defecto,US, el país de la tienda. Cualquier otro país se rechaza con422 REGION_UNSUPPORTED.
include: incluso include: {} devuelve 422 VALIDATION_ERROR en payload.include antes de reservar créditos.
Ejemplo de respuesta
Campos del resultado
site,queryycountryrepiten la solicitud.returnedCountes el número de elementos deproducts.- Cada producto incluye
rank,productId,titleyurl.productIdes el ID de producto de Google, o el ID de la oferta para un anuncio que Google no ha agrupado en un producto.ranksigue el orden predeterminado de la tienda, y se omiten los anuncios que la tienda marca como patrocinados. price,rating,reviewCount,imageUrlyselleraparecen cuando la página de resultados los muestra.pricees un número en lacurrencydel producto (ISO 4217); cuando los tamaños tienen precios distintos, es el más bajo.ratingusa una escala de cinco puntos. Los números de reseñas abreviados, como 999+, se omiten.reviewCountsolo aparece cuando Google muestra el número exacto (menos de 1.000).- Cada búsqueda devuelve productos de la primera página de resultados de la tienda.
- La página de Google no enlaza ninguna página de producto ni de comerciante, así que
urles la página de resultados de Google Shopping donde se clasificó el producto, con#product={productId}&title={title}al final. Pasa esaurlaCOMMERCE_PRODUCTpara leer las tiendas, las especificaciones y la descripción del producto.selleres la tienda que Google muestra primero.
Página de producto
Parámetros
url: Obligatorio. Laurlde un producto que devolvió una búsqueda de Google Shopping, de hasta 2.048 caracteres:google.com/search?q={query}&udm=28&gl={market}#product={productId}&title={title}. ElproductDetailUrlde un producto de los resultados de Google Search, Google AI Overviews y Google AI Mode también sirve tal cual.country: Opcional. Por defecto, elglde laurl, uno deUS,GB,AU,CA,KR,JP,TW,HK,DE,FR,ES,IT,PL,PT,BR,IN,ID,THyVN. Cualquier otro país se rechaza con422 REGION_UNSUPPORTED.
include: incluso include: {} devuelve 422 VALIDATION_ERROR en payload.include antes de reservar créditos.
Ejemplo de respuesta
Campos del resultado
site,country,urlyproductIdidentifican la página.urles la página que se leyó, yproductIdcoincide con el que devuelve una búsqueda.titlesiempre está presente.brand,price,listPrice,currency,inStock,seller,rating,reviewCount,images,description,specsyoffersaparecen cuando la página los muestra.pricees lo que paga un comprador tal como la página lo muestra al abrirse, antes de cupones y envío, encurrency(ISO 4217).listPricees el precio habitual que la página tacha, presente cuando es mayor queprice.inStockes la disponibilidad del producto.selleres el comerciante que lo vende.ratingusa una escala de cinco puntos con dos decimales.reviewCountes el número de reseñas.reviewCountsolo aparece cuando Google muestra el número exacto (menos de 1.000).imageslista hasta 30 fotos de la galería del producto, en el orden de la página.descriptiones texto plano con una línea por párrafo, de hasta 10.000 caracteres; el texto que solo aparece dentro de imágenes no se incluye.specslista hasta 100 pares{ name, value }de los detalles del producto.- La lectura vuelve a ejecutar la consulta de la
urlen Google Shopping de su mercado, o el título del producto si Google ya no lo muestra para esa consulta, y abre el panel del producto, así que tarda más que la página de una tienda. Si Google no muestra el producto en ninguna de las dos, la tarea termina conPAGE_UNAVAILABLE. offerslista las tiendas que Google muestra para el producto, empezando por la que Google marca como el mejor precio, cada una conseller,title(el nombre del producto en la tienda),url(la página del producto en la tienda, cuando Google la enlaza),price,listPrice,currencyeinStock.price,listPrice,sellereinStockdel producto son los de la primera tienda. Los precios llevan la moneda de la pestaña Shopping del mercado (ISO 4217), sea cual sea el idioma de las etiquetas.- Un
productDetailUrlde un producto de Google AI Overviews o AI Mode busca el título del producto, y el resultado devuelve elproductDocidde ese producto.
Errores y facturación
- Una búsqueda que no devuelve productos termina como tarea fallida.
- Solo se cobran las tareas completadas: 2 créditos por búsqueda o página de producto.