Log delle modifiche

v4.9

Nuove funzionalità

2026-04-20

Review Media Items: ReviewMediaItems ora può essere recuperato nell'ambito delle recensioni. ReviewMediaItems può essere recuperato utilizzando accounts.locations.reviews.get, accounts.locations.reviews.list, e accounts.locations.batchGetReviews.

07/04/2026

Recurrence Info: ora puoi pianificare i post ricorrenti impostando RecurrenceInfo quando crei un LocalPost

Food Menus: ora puoi gestire fino a 200 foto di piatti nei tuoi menu di cibo utilizzando accounts.locations.updateFoodMenus

2026-04-01

Review Reply State: ReviewReplyState ora può essere recuperato nell'ambito delle recensioni. ReviewReplyState può essere recuperato utilizzando accounts.locations.reviews.get, accounts.locations.reviews.list, e accounts.locations.batchGetReviews. Offre maggiore visibilità sullo stato di moderazione delle risposte alle recensioni inviate.

2021-02-24

MoreHours : MoreHours può ora essere impostato come parte della scheda dell'attività. : MoreHourTypes può essere recuperato per ogni categoria utilizzando categories.batchGet.

Modifiche al comportamento

Deprecazione degli account v4.x
accounts, accounts.admins, accounts.invitations e accounts.locations.admins sono ora ritirati nell'API Google My Business. Per saperne di più, consulta il log delle modifiche relative al ritiro.
Post con inviti all'azione

Nel secondo trimestre del 2021, i post di CallToAction con

GET_OFFER ActionType non sarà più valido.

v4.8

Nuove funzionalità

Servizi della struttura : Recupero e aggiornamento dei servizi della struttura. Ulteriori informazioni : Aggiunta dell'endpoint GetGoogleUpdated per le strutture ricettive. : Aggiunta del valore booleano canOperateLodgingData in LocationState

Attributi del fornitore di servizi sanitari : Recupero e aggiornamento di HealthProviderAttributes. Altre informazioni : aggiunta del valore booleano canOperateHealthData in LocationState

Reti assicurative : Elenco delle reti assicurative accettate dalle sedi. Maggiori informazioni

Modifiche al comportamento

ID recensioni
Gli ID recensione sono stati migrati a un nuovo formato. Questo nuovo ID verrà ora restituito in tutte le risposte API applicabili. Per un breve periodo di tempo, i vecchi ID recensione verranno comunque risolti quando vengono utilizzati per chiamare l'API, ma è fondamentale aggiornare tutti gli ID recensione memorizzati nel sistema entro 30 giorni, come richiesto dalle nostre norme, chiamando l'endpoint listReviews.
Attività al domicilio del cliente

Nel primo trimestre del 2021, Address non verrà più restituito nel

Oggetto Location per le attività CUSTOMER_LOCATION_ONLY.

v4.7

Nuove funzionalità

Menu : Recupero e aggiornamento dei menu. Scopri di più

v4.6

Nuove funzionalità

Elenchi di servizi

Ora puoi

Recuperare e aggiornare i servizi offerti da un'attività. Maggiori informazioni

Aggiunta del valore booleano canModifyServiceList in LocationState

Indica se una sede è idonea a modificare gli elenchi di servizi Maggiori informazioni

ServiceTypes predefinito per le categorie

I tipi di servizio predefiniti ora sono inclusi nell'oggetto categorie. Maggiori informazioni

CategoryView

Possibilità di specificare una visualizzazione BASIC o FULL per le categorie. La visualizzazione FULL restituirà ulteriori dettagli, come i tipi di servizio. Maggiori informazioni

Categories.BatchGet Method

Questo nuovo metodo ti consente di inserire un elenco di categorie e restituisce informazioni solo su queste categorie. Maggiori informazioni

v4.5 Aggiornamento COVID-19 2

Nuove funzionalità

Tipo di post Allerta COVID-19

Ora puoi creare un post COVID_19 utilizzando l'API.

Ulteriori informazioni.

v4.5 Aggiornamento 1 per il COVID-19

Nuove funzionalità

Chiuso temporaneamente
Ora puoi impostare un'attività su CLOSED_TEMPORARILY utilizzando l'API. Maggiori informazioni.

v4.5

Nuove funzionalità

Pub/Sub per Q&A
Ora puoi ricevere notifiche Google Cloud Pub/Sub per domande e risposte nuove o aggiornate relative a una località. Maggiori informazioni.
Pub/Sub per lo stato della scheda
Ora puoi ricevere notifiche Google Cloud Pub/Sub per una modifica dello stato della scheda. Maggiori informazioni.

v4.4

Nuove funzionalità

Verifiche delle attività di Servizi locali
Le attività di servizi locali ora possono essere verificate dall'API. Maggiori informazioni.
Numero di follower

Ora puoi recuperare i metadati relativi ai follower.

Scopri di più.

Gruppi di utenti e gruppi di sedi

Ora è possibile creare gruppi di utenti e gruppi di località tramite l'API. Maggiori informazioni

Aggiunta del campo hasPendingEdits in LocationState

Indica se le proprietà di una località sono in stato di modifica in attesa. Maggiori informazioni

Modifiche al comportamento

Data di apertura
Ora puoi impostare una data di apertura futura per una scheda.

PointRadius : PointRadius è ora di sola lettura. Le modifiche o la creazione di attività di servizi locali richiedono l'utilizzo di Places.

Versione 4.3

Nuove funzionalità

API Domande e risposte
Recupera domande, pubblica risposte e fornisci domande frequenti sulle sedi della tua attività. Maggiori informazioni.
Lettura collettiva delle recensioni

Recupera le recensioni per più sedi in una singola chiamata.

Ulteriori informazioni.

Recommended GoogleLocations

Visualizza le sedi non rivendicate che Google ritiene potrebbero essere di tua proprietà. Ulteriori informazioni.

Segnalare problemi relativi a GoogleLocation

Segnala problemi relativi ai risultati di RecommendedGoogleLocations o GoogleLocations. Ulteriori informazioni.

Enumerazione del servizio per le sezioni PriceList

Identifica una sezione PriceList come contenente articoli ALIMENTARI o SERVIZI forniti. Ulteriori informazioni.

Descrizione dei contenuti multimediali

Fornisci una didascalia quando carichi nuovi contenuti multimediali.

Ulteriori informazioni.

CHAINS_QUERIES Approfondimenti

Recupera il numero di volte in cui una località è stata mostrata come risultato di una ricerca della catena a cui appartiene. Ulteriori informazioni.

Modifiche al comportamento

Notifiche per gli account dell'organizzazione e i gruppi di località
Gli account configurati per le notifiche Pub/Sub ora riceveranno queste notifiche anche per le schede contenute in un account organizzazione o nei gruppi di località di cui sono amministratori.
ListLocations per l'account dell'organizzazione e i gruppi di località
accounts.locations.list chiamato con un account di gruppo di utenti o organizzazione ora mostra tutte le sedi accessibili da quell'account.

Versione 4.2

Nuove funzionalità

API di verifica
Elenca e attiva i metodi di verifica disponibili per le sedi non verificate. Maggiori informazioni.
API GoogleLocations
Cerca le sedi esistenti su Google da rivendicare oppure recupera un link per richiedere l'accesso alle sedi rivendicate. Maggiori informazioni.
Filtri di località espansi
Opzioni aggiuntive per limitare i risultati restituiti da una chiamata Locations.List. Maggiori informazioni.
Abbonamento alla catena
Indica l'appartenenza di una sede a una catena (ad es. Walmart, Target e così via). Scopri di più.
Informazioni sull'organizzazione
Le informazioni per gli account organizzativi verranno ora visualizzate come parte degli oggetti Account. Maggiori informazioni.
Foto del profilo dell'autore della recensione
Gli URL
per le foto del profilo dei recensori sono ora inclusi nell'oggetto recensione. Maggiori informazioni.

v4.1

Nuove funzionalità

Media forniti dal cliente
Ora puoi recuperare e visualizzare approfondimenti per le foto e i video generati dagli utenti per le località di tua proprietà e che gestisci. Maggiori informazioni.
API di gestione amministrativa
Ora puoi elencare, accettare e rifiutare gli inviti relativi all'account e alla località per il tuo account. Maggiori informazioni.
Profile (Descrizione fornita dal commerciante)
Descrivi la tua attività con parole tue e condividi con gli utenti la storia e le offerte uniche della tua attività. Scopri di più.
openingDate Campo

Fornisci la data di apertura della tua sede.

Scopri di più.

Post sui tipi di offerta

Un nuovo tipo di post su Google che aiuta gli utenti a trovare le offerte disponibili nelle tue sedi. Ulteriori informazioni.

v4

Nuove funzionalità

post su Google
Ora puoi creare post su Google direttamente tramite l'API.
Caricamento foto
Ora è possibile caricare le foto direttamente utilizzando l'API, oltre al caricamento tramite URL esistente.
Filtro/attivazione delle notifiche
Ora puoi filtrare le notifiche inviate agli argomenti pub/sub. Le notifiche future utilizzeranno questo meccanismo per essere attivate anziché essere inviate a tutti gli utenti.
UPDATED_REVIEW notifiche
Ora puoi iscriverti alle notifiche in tempo reale per gli aggiornamenti alle recensioni dei clienti.
Supporto per i gruppi di utenti
L'API Google My Business ora supporta gli account di tipo Gruppo di utenti.

Modifiche non compatibili con le versioni precedenti

  • Le foto, in precedenza un campo degli oggetti location, ora sono una risorsa in location (accounts/<var>account_ID</var>/locations/<var>location_ID</var>/photos).
  • Il campo Indirizzo Country ora è region_code e sub_locality ora è sublocality.
  • Il campo Ownership precedentemente deprecato è stato rimosso.
  • In precedenza, i comproprietari di account e sedi non erano distinguibili dai proprietari principali tramite l'API (tutti venivano visualizzati come OWNER). Ora ai proprietari principali verrà assegnato il ruolo OWNER e agli altri proprietari il ruolo CO_OWNER.
  • AccountType.BUSINESS ora si chiama AccountType.LOCATION_GROUP.
  • Quando utilizzi una maschera del campo per aggiornare le sedi, fornisci update_mask al posto di field_mask esistente.
  • Il messaggio della categoria utilizzato per primary_category e additional_categories non contiene più il formato leggibile. Gli utenti devono utilizzare il servizio categorie dell'API di Google My Business per ottenere nomi di categorie tradotti e leggibili.

v3.3

Nuove funzionalità

Menu strutturati

Ora puoi aggiungere, aggiornare o eliminare:

  • Più menu in una determinata posizione
  • Includere più sezioni del menu in un menu
  • Elenca le voci del menu con nome, descrizione, prezzo e foto

v3.2

Nuove funzionalità

Approfondimenti
Ora puoi recuperare approfondimenti sulla posizione e metriche di guida tramite l'API.
Notifiche
Ora puoi abbonarti alle notifiche in tempo reale per i nuovi aggiornamenti di Google.

Modifiche non compatibili con le versioni precedenti

  • I campi languageCodes e platforms di UrlAttributeValue precedentemente inutilizzati sono stati rimossi.
  • SAME nell'enumerazione Ownership ritirata ora si applica solo se la sede che duplica ha lo stesso proprietario principale. In precedenza, il comportamento si basava su un calcolo della proprietà più complesso.

v3.1

Nuove funzionalità

Notifiche
Ora puoi iscriverti alle notifiche in tempo reale per le nuove recensioni.
URL di Maps
Gli URL di Google Maps sono inclusi nelle risposte relative alla posizione, consentendo agli utenti di creare link a Google Maps.
Location States
Stati delle sedi aggiuntive che indicano quando la scheda è pubblicata, disattivata o in attesa di verifica.
Riapri flag
Il flag
canReopen indica le sedi chiuse definitivamente che possono essere riaperte rispetto a quelle che non possono.
Attributi
Supporto per gli attributi URL ed Enum.
Endpoint della categoria
Ottieni un elenco delle categorie supportate per paese e lingua (sostituisce i file CSV).

v3

Nuove funzionalità

Recensioni
Ora puoi recuperare le recensioni dell'attività e rispondere tramite l'API.
Attributi
Fornisci ulteriori informazioni specifiche per categoria sulle sedi.
Trova località corrispondente
Trova e associa manualmente le posizioni delle mappe esistenti alla sede della tua attività commerciale.
Località di trasferimento
Nuova azione su Location :transfer. Consente di trasferire una posizione da un account (aziendale o personale) a un altro.
Foto preferita
Indica la foto che preferisci mostrare per prima su Google Maps e nella Ricerca.
Nuovi filtri di ricerca
I nuovi filtri di ricerca includono any_google_updates, is_suspended e is_duplicate.
Nuovi stati della posizione
Gli stati di
ora includono anche is_verified e needs_reverification.
Miglioramenti all'URL della foto
L'API ora accetta URL di foto senza un suffisso di formato immagine.

Modifiche non compatibili con le versioni precedenti

  • Ora devi specificare un request_id nelle chiamate CreateLocation. Questo ID deve essere univoco per ogni sede e contribuisce a evitare la creazione di sedi duplicate nel tuo account. I tentativi di creare una sede in cui l'ID richiesta corrisponde a una sede creata in precedenza restituiscono la sede esistente ed evitano di creare un duplicato nel tuo account.
  • business_hours in Posizione è stato rinominato in regular_hours.