COMMERCE_SERP avec site google_shopping pour recevoir les produits qu’affiche une recherche, dans l’ordre de la boutique, ou COMMERCE_PRODUCT avec l’url d’un produit pour lire ce produit. Une recherche ou une page produit terminée coûte 2 crédits.
Recherche
GET /v1/async/task/{id} ou recevez son webhook. Voir Tâches asynchrones.
Paramètres
site: obligatoire.google_shopping.query: obligatoire. Terme de recherche, de 1 à 500 caractères.limit: entier facultatif de 1 à 40, avec 20 par défaut.country: facultatif. Par défaut,US, le pays de la boutique. Tout autre pays est refusé avec422 REGION_UNSUPPORTED.
include : même include: {} renvoie 422 VALIDATION_ERROR sur payload.include avant toute réservation de crédits.
Exemple de réponse
Champs du résultat
site,queryetcountryreprennent la requête.returnedCountest le nombre d’éléments deproducts.- Chaque produit comporte
rank,productId,titleeturl.productIdest l’identifiant produit de Google, ou l’identifiant de l’offre pour une annonce que Google n’a pas regroupée en produit.ranksuit l’ordre par défaut de la boutique, et les annonces que la boutique marque comme sponsorisées sont exclues. price,rating,reviewCount,imageUrletsellerapparaissent quand la page de résultats les affiche.priceest un nombre dans lacurrencydu produit (ISO 4217) ; quand les formats ont des prix différents, c’est le plus bas.ratingutilise une échelle de cinq points. Les nombres d’avis abrégés, comme 999+, sont omis.reviewCountn’apparaît que lorsque Google affiche le nombre exact (moins de 1 000).- Chaque recherche renvoie les produits de la première page de résultats de la boutique.
- La page de Google ne renvoie vers aucune page produit ni marchand, donc
urlest la page de résultats Google Shopping où le produit a été classé, terminée par#product={productId}&title={title}. Passez cetteurlàCOMMERCE_PRODUCTpour lire les boutiques, les caractéristiques et la description du produit.sellerest la boutique que Google affiche en premier.
Page produit
Paramètres
url: obligatoire. L’urld’un produit renvoyée par une recherche Google Shopping, de 2 048 caractères au plus :google.com/search?q={query}&udm=28&gl={market}#product={productId}&title={title}. LeproductDetailUrld’un produit des résultats Google Search, Google AI Overviews et Google AI Mode fonctionne aussi tel quel.country: facultatif. Par défaut, leglde l’url, parmiUS,GB,AU,CA,KR,JP,TW,HK,DE,FR,ES,IT,PL,PT,BR,IN,ID,THetVN. Tout autre pays est refusé avec422 REGION_UNSUPPORTED.
include : même include: {} renvoie 422 VALIDATION_ERROR sur payload.include avant toute réservation de crédits.
Exemple de réponse
Champs du résultat
site,country,urletproductIdidentifient la page.urlest la page lue, etproductIdcorrespond à celui que renvoie une recherche.titleest toujours présent.brand,price,listPrice,currency,inStock,seller,rating,reviewCount,images,description,specsetoffersapparaissent quand la page les affiche.priceest ce que paie un acheteur tel que la page l’affiche à l’ouverture, avant coupons et livraison, encurrency(ISO 4217).listPriceest le prix habituel que la page barre, présent quand il dépasseprice.inStockindique la disponibilité du produit.sellerest le marchand qui le vend.ratingutilise une échelle de cinq points avec deux décimales.reviewCountest le nombre d’avis.reviewCountn’apparaît que lorsque Google affiche le nombre exact (moins de 1 000).imagesliste jusqu’à 30 photos de la galerie du produit, dans l’ordre de la page.descriptionest du texte brut avec une ligne par paragraphe, jusqu’à 10 000 caractères ; le texte qui n’apparaît que dans des images n’est pas inclus.specsliste jusqu’à 100 paires{ name, value }des caractéristiques du produit.- La lecture relance la requête de l’
urlsur Google Shopping dans son marché, ou le titre du produit quand Google ne l’affiche plus pour cette requête, puis ouvre le panneau du produit ; elle prend donc plus de temps qu’une page de boutique. Si Google n’affiche le produit dans aucun des deux cas, la tâche se termine parPAGE_UNAVAILABLE. offersliste les boutiques que Google affiche pour le produit, en commençant par celle que Google marque comme le meilleur prix, chacune avecseller,title(le nom du produit dans la boutique),url(la page produit de la boutique, quand Google la lie),price,listPrice,currencyetinStock.price,listPrice,selleretinStockdu produit sont ceux de la première boutique. Les prix sont dans la devise de l’onglet Shopping du marché (ISO 4217), quelle que soit la langue des libellés.- Un
productDetailUrld’un produit Google AI Overviews ou AI Mode recherche le titre du produit, et le résultat renvoie leproductDocidde ce produit.
Erreurs et facturation
- Une recherche qui ne renvoie aucun produit se termine par une tâche en échec.
- Seules les tâches terminées sont facturées : 2 crédits par recherche ou page produit.