COMMERCE_SERP mit site google_shopping, um die Produkte einer Suche in der Reihenfolge des Shops zu erhalten, oder COMMERCE_PRODUCT mit der url eines Produkts, um dieses Produkt zu lesen. Eine abgeschlossene Suche oder Produktseite kostet 2 Credits.
Suche
GET /v1/async/task/{id} ab oder empfangen Sie den Webhook. Siehe Asynchrone Tasks.
Parameter
site: Erforderlich.google_shopping.query: Erforderlich. Suchbegriff mit 1 bis 500 Zeichen.limit: Optionale Ganzzahl von 1 bis 40, Standard 20.country: Optional. Standard istUS, das Land des Shops. Jedes andere Land wird mit422 REGION_UNSUPPORTEDabgelehnt.
include weg: Auch include: {} führt vor der Credit-Reservierung zu 422 VALIDATION_ERROR für payload.include.
Antwortbeispiel
Ergebnisfelder
site,queryundcountrygeben die Anfrage wieder.returnedCountist die Anzahl der Einträge inproducts.- Jedes Produkt enthält
rank,productId,titleundurl.productIdist die Produkt-ID von Google oder die Angebots-ID für einen Eintrag, den Google keinem Produkt zugeordnet hat.rankfolgt der Standardreihenfolge des Shops, und Einträge, die der Shop als gesponsert kennzeichnet, werden ausgelassen. price,rating,reviewCount,imageUrlundsellererscheinen, wenn die Ergebnisseite sie zeigt.priceist eine Zahl in dercurrencydes Produkts (ISO 4217); haben Größen eigene Preise, ist es der niedrigste.ratingnutzt eine Fünf-Punkte-Skala. Abgekürzte Bewertungszahlen wie 999+ werden ausgelassen.reviewCounterscheint nur, wenn Google die genaue Anzahl zeigt (unter 1.000).- Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops.
- Die Google-Seite verlinkt keine Produkt- oder Händlerseite, daher ist
urldie Google-Shopping-Ergebnisseite, auf der das Produkt gerankt wurde, mit#product={productId}&title={title}am Ende. Übergeben Sie dieseurlanCOMMERCE_PRODUCT, um die Shops, technischen Daten und die Beschreibung des Produkts zu lesen.sellerist der Shop, den Google zuerst zeigt.
Produktseite
Parameter
url: Erforderlich. Dieurleines Produkts aus einer Google-Shopping-Suche, höchstens 2.048 Zeichen:google.com/search?q={query}&udm=28&gl={market}#product={productId}&title={title}. DieproductDetailUrleines Produkts aus Ergebnissen von Google Search, Google AI Overviews und Google AI Mode funktioniert ebenfalls unverändert.country: Optional. Standard ist dasglderurl, eines vonUS,GB,AU,CA,KR,JP,TW,HK,DE,FR,ES,IT,PL,PT,BR,IN,ID,THundVN. Jedes andere Land wird mit422 REGION_UNSUPPORTEDabgelehnt.
include weg: Auch include: {} führt vor der Credit-Reservierung zu 422 VALIDATION_ERROR für payload.include.
Antwortbeispiel
Ergebnisfelder
site,country,urlundproductIdkennzeichnen die Seite.urlist die gelesene Seite, undproductIdentspricht der ID aus einer Suche.titleist immer vorhanden.brand,price,listPrice,currency,inStock,seller,rating,reviewCount,images,description,specsundofferserscheinen, wenn die Seite sie zeigt.priceist, was ein Käufer laut der Seite beim Öffnen zahlt, vor Gutscheinen und Versand, incurrency(ISO 4217).listPriceist der reguläre Preis, den die Seite durchstreicht, vorhanden, wenn er überpriceliegt.inStockist die Verfügbarkeit des Produkts.sellerist der Händler, der es verkauft.ratingnutzt eine Fünf-Punkte-Skala mit zwei Nachkommastellen.reviewCountist die Anzahl der Bewertungen.reviewCounterscheint nur, wenn Google die genaue Anzahl zeigt (unter 1.000).imageslistet bis zu 30 Fotos aus der Produktgalerie in Seitenreihenfolge.descriptionist reiner Text mit einer Zeile pro Absatz, bis zu 10.000 Zeichen; Text, der nur in Bildern steht, ist nicht enthalten.specslistet bis zu 100 Paare{ name, value }aus den Produktdetails.- Der Lesevorgang führt die Suchanfrage der
urlerneut in Google Shopping in ihrem Markt aus, oder den Produkttitel, wenn Google das Produkt für die Anfrage nicht mehr zeigt, und öffnet das Produktfenster; er dauert daher länger als eine Shopseite. Zeigt Google das Produkt bei keiner der beiden Suchen, endet der Task mitPAGE_UNAVAILABLE. offerslistet die Shops, die Google für das Produkt zeigt, beginnend mit dem, den Google als besten Preis markiert, jeweils mitseller,title(dem Produktnamen des Shops),url(der Produktseite des Shops, wenn Google sie verlinkt),price,listPrice,currencyundinStock.price,listPrice,sellerundinStockdes Produkts sind die des ersten Shops. Die Preise tragen die Währung des Shopping-Tabs des Markts (ISO 4217), unabhängig von der Sprache der Beschriftungen.- Eine
productDetailUrleines Produkts aus Google AI Overviews oder AI Mode sucht nach dem Produkttitel, und das Ergebnis liefert dieproductDociddieses Produkts.
Fehler und Abrechnung
- Eine Suche ohne Produkte endet als fehlgeschlagener Task.
- Abgerechnet werden nur abgeschlossene Tasks: 2 Credits pro Suche oder Produktseite.