GEMINI-Ergebnisse enthalten jetzt die Produktkarten und Orte, die Gemini in seiner Antwort zeigt.
Was sich ändert
shoppingCards: die Produktkarten, die Gemini zeigt, mit Titel, Position, Preis, Shop, Bewertung, Rezensionen, Vorschaubild und productLink zur Google-Produktseite.
inlineProducts: die im Antworttext verlinkten Produkte mit Titel, Position und productLink.
map: die Orte, die Gemini bei Ortsfragen empfiehlt, mit Adresse, Koordinaten, Telefonnummer, Website, Google-Maps-Link, Bewertung und Kategorie.
So funktioniert es
Wenn Sie Gemini fragen, was Sie kaufen oder wohin Sie gehen sollen, steht ein großer Teil der Antwort außerhalb des Textes: eine Reihe von Produktkarten mit Preisen oder eine Liste von Orten auf einer Karte. Diese Elemente kommen jetzt als strukturierte Felder neben text, in der Reihenfolge, in der Gemini sie zeigt. position verrät Ihnen also, welches Produkt oder welcher Ort zuerst kommt.
price kommt als {value, currency, raw}, damit Sie Preise zwischen Shops direkt vergleichen. Jeder Ort enthält placeId, eine location mit address, latitude und longitude sowie reviews mit Bewertung, Anzahl der Rezensionen und Anbieter. Die Titel der Karten bleiben auch in text, sodass Zählungen von Erwähnungen auf Basis des Textes dieselben Zahlen liefern.
Einsatzbereiche
Verfolgen Sie, ob Ihr Produkt als Gemini-Produktkarte erscheint, an welcher Position und zu welchem Preis.
Sehen Sie, zu welchen Shops Gemini Käufer in Ihrer Kategorie schickt.
Prüfen Sie, welche Praxen, Restaurants oder Geschäfte Gemini in einem Viertel empfiehlt, samt Bewertungen.
Anfrage senden
Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header Authorization.
Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.
payload.promptstringPflicht
Die Frage, so formuliert, wie ein Nutzer sie in den Chat tippt. Bis zu 100.000 Zeichen.
payload.countrystring
Zweistelliger Ländercode des Markts, aus dem gefragt wird, etwa US, KR oder JP. Standard US.
payload.locationobject
Ein Punkt innerhalb von country, mit latitude (-90 bis 90) und longitude (-180 bis 180) in Dezimalgrad, etwa {"latitude": 37.4979, "longitude": 127.0276}. Die Engine antwortet wie einem Nutzer vor Ort. Für CHATGPT, GEMINI, GOOGLE, AIMODE und GOOGLE_SERP.
payload.include.markdownboolean
Mit true kommt markdown hinzu: die Antwort mit Überschriften, Listen, Tabellen und Links.
Antwort
So sieht eine fertige Aufgabe aus, für die Lesbarkeit gekürzt.
In der Antwort empfohlene Orte: Name, Adresse, Koordinaten, Bewertung, Kategorie und Kartenlink.
response.shoppingCardsarray
Produktkarten zur Antwort: Titel, Preis, Shop, Bewertung und Produktlink.
response.inlineProductsarray
In den Sätzen der Antwort verlinkte Produktnamen, mit position und productLink.
response.locationobject
Der Punkt, für den die Antwort gilt, so wie Sie ihn gesendet haben: latitude und longitude.
Ergebnis abholen
Die Anfrage liefert sofort die Aufgabe mit statusQUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis statusCOMPLETED oder FAILED ist, oder geben Sie webhook.url an, dann kommt die fertige Aufgabe mit denselben task, credits und response auf Ihrem Server an. Ergebnisse bleiben 24 Stunden nach Abschluss abrufbar.
Durchsuchen Sie YouTube, Instagram und Threads und erhalten Sie Videos, Beiträge, Kommentare, Profile und YouTube-Untertitel als JSON mit jedem API-Schlüssel, für 0,5 Credits pro abgeschlossener Anfrage.
Geben Sie Ihrem Agenten Websuche mit einem Aufruf: Jedes Ergebnis kommt mit den Passagen seiner Seite, die die Anfrage beantworten, für 0,5 Credits pro Suche.