Les résultats Gemini s’enrichissent des produits et des lieux
Gemini
Les résultats GEMINI incluent désormais les fiches produit et les lieux que Gemini affiche dans sa réponse.
Ce qui change
shoppingCards : les fiches produits affichées par Gemini, avec titre, position, prix, boutique, note, avis, miniature et productLink vers la page produit Google.
inlineProducts : les produits liés dans le texte de la réponse, avec titre, position et productLink.
map : les lieux que recommande Gemini pour les questions de lieux, avec adresse, coordonnées, téléphone, site web, lien Google Maps, note et catégorie.
Fonctionnement
Quand vous demandez à Gemini quoi acheter ou où aller, une grande partie de la réponse se trouve hors du texte : une rangée de fiches produits avec leurs prix, ou une liste de lieux sur une carte. Ces éléments arrivent désormais en champs structurés à côté de text, dans l’ordre où Gemini les affiche : position vous indique quel produit ou quel lieu vient en premier.
price arrive sous la forme {value, currency, raw}, ce qui facilite la comparaison des prix entre boutiques. Chaque lieu comporte placeId, une location avec address, latitude et longitude, et reviews avec la note, le nombre d’avis et leur source. Les titres des fiches restent aussi dans text : les comptages de mentions fondés sur le texte gardent les mêmes chiffres.
Cas d’usage
Suivez si votre produit apparaît dans une fiche produit de Gemini, à quelle position et à quel prix.
Voyez vers quelles boutiques Gemini envoie les acheteurs de votre catégorie.
Vérifiez quelles cliniques, quels restaurants ou quelles boutiques Gemini recommande dans un quartier, avec leurs notes.
Envoyer la requête
Envoyez la requête avec votre clé API dans l’en-tête Authorization.
Le moteur à interroger, par exemple CHATGPT ou GOOGLE.
payload.promptstringObligatoire
La question, rédigée comme un utilisateur la tape dans le chat. Jusqu’à 100 000 caractères.
payload.countrystring
Code pays à deux lettres du marché d’où part la question, par exemple US, KR ou JP. Par défaut US.
payload.locationobject
Un point situé dans country, avec latitude (-90 à 90) et longitude (-180 à 180) en degrés décimaux, par exemple {"latitude": 37.4979, "longitude": 127.0276}. Le moteur répond comme à un utilisateur qui s’y trouve. Pour CHATGPT, GEMINI, GOOGLE, AIMODE et GOOGLE_SERP.
payload.include.markdownboolean
Avec true, la réponse arrive aussi en markdown, avec ses titres, listes, tableaux et liens.
Réponse
Voici une tâche terminée, raccourcie pour la lecture.
Lieux recommandés dans la réponse : nom, adresse, coordonnées, note, catégorie et lien de carte.
response.shoppingCardsarray
Fiches produits affichées avec la réponse : nom, prix, boutique, note et lien.
response.inlineProductsarray
Noms de produits liés dans les phrases de la réponse, avec position et productLink.
response.locationobject
Le point retenu pour la réponse, tel que vous l’avez envoyé : latitude et longitude.
Recevoir le résultat
La requête renvoie aussitôt la tâche avec statusQUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.
Recherchez sur YouTube, Instagram et Threads et recevez vidéos, publications, commentaires, profils et sous-titres YouTube en JSON depuis n’importe quelle clé API, pour 0,5 crédit par requête terminée.
Donnez la recherche web à votre agent en un seul appel : chaque résultat arrive avec les passages de sa page qui répondent à la requête, pour 0,5 crédit la recherche.