Recentemente ci è stato chiesto di incorporare in maniera automatica su un sito le recensioni scritte su una scheda di Google My Business.

Non esistendo un plugin ufficiale che permettesse l'incorporamento delle recensioni in un sito (è sempre la soluzione preferibile in questi casi), abbiamo sviluppato un nostro algoritmo che utilizza le API di Google Maps per visualizzare le ultime recensioni.

Se anche tu stai cercando un modo per incorporare automaticamente le recensioni di Google My Business sul tuo sito, ti illustriamo i passi che abbiamo seguito (andremo sul tecnico).

Passo 1. Recuperare l'ID

Prima di tutto è necessario recuperare il codice identificativo (ID) della scheda di Google My Business da cui si vuole prendere le recensioni.

Per farlo, abbiamo utilizzato questo strumento: Google Business Review Direct Link Generator.

Nella casella di ricerca, occorre ricercare il nome esatto della scheda di Google My Business, e selezionare la voce corretta dal menu a tendina:

Verranno creati una serie di link, a noi interessa quello più lungo. Quello è il link che punta direttamente alla lista delle recensioni su Google My Business. Per proseguire con il nostro plugin, ci serve recupeare il paramentro "ludocid", come in figura:

Quello è il codice identificativo che ci serve.

Passo 2. Richiamare l'API di Google Maps

Ora che abbiamo l'ID che ci serve, possiamo richiamare l'API di Google Maps, da cui è possibile leggere tutte le informazioni salvate su Google My Business.

L'Endpoint è il seguente:

https://maps.googleapis.com/maps/api/place/details/json?cid=ID&language=LANG&key=API_KEY

Dove al posto di ID occorre inserire l'ID che abbiamo recuperato, al posto di LANG (opzionale) la lingua di output, e al posto di API_KEY la ormai immancabile Api Key di Google Maps (senza la quale ad esempio non è nemmeno possibile mostrare le mappe).

Passo 3. Leggere la risposta

All'Endpoint raggiunto viene restituito un JSON contenente varie informazioni utili, quali:

1. l'indirizzo
2. gli orari di apertura
3. il numero di recensioni
4. il voto medio delle recensioni
5. le ultime 5 recensioni scritte

La struttura JSON di una recensione è questa:

{
    ...
    "reviews" : [
        ...
        {
            "author_name" : "Mario Rossi",
            "author_url" : "https://www.google.com/maps/contrib/XXXXX/reviews",
            "language" : "it",
            "profile_photo_url" : "https://lh3.googleusercontent.com/XXXXX/photo.jpg",
            "rating" : 5,
            "relative_time_description" : "4 mesi fa",
            "text" : "Squadra che si presenta bene fin da subito: ragazzi che hanno capacità ed inventiva. A cui si possono esprimere dubbi e perplessità e con una soluzione sempre a portata di mano.",
            "time" : 1550902838
        },
        ...
    ]
    ...
}

Da ogni recensione è quindi possibile ricavare il nome dell'autore, la foto del profilo (se presente), il voto che ha dato, l'eventuale testo, e la data/ora di scrittura della recensione.

Passo 4. Scrivere HTML e CSS

Il peggio è passato, ora è possibile trasformare il JSON in HTML e renderlo graficamente in maniera del tutto personalizzata con il CSS.

Vuoi incorporare automaticamente le recensioni di Google My Business sul tuo sito, ma non hai capito come fare? Contattaci, ci pensiamo noi.