v4.9
Nuove funzionalità
MoreHours
Ora - MoreHours può essere impostato all'interno della scheda dell'attività.
MoreHourTypes
può essere recuperato per ogni categoria utilizzando categories.batchGet.
Modifiche comportamentali
- Ritiro degli account v4.x
- accounts, accounts.admins, accounts.invitations e accounts.locations.admins sono stati ritirati nell'API Google My Business. Per ulteriori informazioni, consulta il log delle modifiche relative al ritiro.
- Post con invito all'azione
- Nel secondo trimestre del 2021,
CallToAction
i post con GET_OFFERActionType
non saranno più validi.
v4.8
Nuove funzionalità
- Comfort della struttura
- Recupero e aggiornamento dei comfort dell'alloggio. Ulteriori informazioni
- Aggiunta dell'endpoint GetGoogleUpdated per le strutture ricettive.
- Aggiunta del valore booleano
canOperateLodgingData
in LocationState - Attributi dei fornitori di servizi sanitari
- Recupero e aggiornamento di HealthProviderAttributes. Ulteriori informazioni
- Aggiunta del valore booleano
canOperateHealthData
in LocationState - Reti assicurative
- Elenca le reti di strutture convenzionate con l'assicurazione accettate dalle sedi. Scopri di più
Modifiche comportamentali
- ID recensione
- È stata eseguita la migrazione degli ID recensione a un nuovo formato. Questo nuovo ID verrà ora restituito in tutte le risposte dell'API applicabili. Per un breve periodo di tempo, i vecchi ID recensione continueranno a essere 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 nell'oggetto Location per le attivitàCUSTOMER_LOCATION_ONLY
.
v4.7
Nuove funzionalità
- Menu di cibo
- Recupero e aggiornamento di FoodMenus. Scopri di più
v4.6
Nuove funzionalità
- Elenchi di servizi
- Ora puoi recuperare e aggiornare i servizi offerti da un'attività. Scopri di più
- Aggiunta del valore booleano
canModifyServiceList
in LocationState - Indica se una stazione di ricarica è idonea a modificare gli elenchi di serviziScopri di più
ServiceTypes
predefinito per le categorie- I tipi di servizi predefiniti sono ora inclusi come nell'oggetto categories.Scopri di più
- CategoryView
- Possibilità di specificare una visualizzazione
BASIC
oFULL
per le categorie. La visualizzazioneFULL
restituirà ulteriori dettagli, come i tipi di servizi. Scopri di più - Metodo Categories.BatchGet
- Questo nuovo metodo ti consente di inserire un elenco di categorie e restituisce informazioni solo su queste categorie. Scopri di più
Aggiornamento 2 relativo al COVID-19 per la versione 4.5
Nuove funzionalità
- Tipo di post di avviso COVID-19
- Ora puoi creare un post
COVID_19
tramite l'API. Scopri di più.
Aggiornamento 1 relativo al COVID-19 per la versione 4.5
Nuove funzionalità
- Chiuso temporaneamente
- Ora puoi impostare un'attività su
CLOSED_TEMPORARILY
tramite l'API. Scopri di più.
v4.5
Nuove funzionalità
- Pub/Sub per domande e risposte
- Ora puoi ricevere notifiche Google Cloud Pub/Sub per domande e risposte nuove/aggiornate in una località. Scopri di più.
- Pub/Sub per lo stato della scheda
- Ora puoi ricevere notifiche Google Cloud Pub/Sub per una modifica dello stato della scheda. Scopri di più.
v4.4
Nuove funzionalità
- Verifiche delle attività di servizi locali
- Ora le attività di servizi locali possono essere verificate tramite l'API. Scopri di più.
- Numero di follower
- Ora puoi recuperare i metadati sui follower. Scopri di più.
- Gruppi di utenti e gruppi di località
- Ora è possibile creare gruppi di utenti e gruppi di sedi tramite l'API. Scopri di più
- Aggiunta del campo
hasPendingEdits
in LocationState - Indica se le proprietà di una stazione di ricarica sono in stato di modifica in attesa. Scopri di più
Modifiche al comportamento
- Data di apertura
- Ora puoi impostare una data di apertura futura per una scheda.
PointRadius
- PointRadius è ora di sola lettura. Per modificare o creare attività di servizi locali è necessario utilizzare Locali.
Versione 4.3
Nuove funzionalità
- API di domande e risposte
- Raccogliere domande, pubblicare risposte e fornire domande frequenti sulle sedi della tua attività. Scopri di più.
- Leggere più recensioni contemporaneamente
- Recupero delle recensioni per più sedi in una singola chiamata. Scopri di più.
- GoogleLocations consigliati
- Visualizzare le sedi non rivendicate che Google ritiene di tua proprietà. Scopri di più.
- Segnalare problemi relativi a GoogleLocation
- Segnala i problemi relativi ai risultati di
RecommendedGoogleLocations
oGoogleLocations
. Scopri di più. - Enum dei servizi per le sezioni
PriceList
- Identifica una sezione
PriceList
come contenente cibi o servizi forniti. Scopri di più. - Descrizione dei contenuti multimediali
- Fornisci una didascalia quando carichi nuovi contenuti multimediali. Scopri di più.
CHAINS_QUERIES
Approfondimenti- Recupero del numero di volte in cui una sede è stata mostrata in seguito a una ricerca della catena a cui appartiene. Scopri di più.
Modifiche al comportamento
- Notifiche per gli account dell'organizzazione e i gruppi di sedi
- Gli account configurati per le notifiche Pub/Sub ora riceveranno queste notifiche anche per tutte le schede contenute in un account dell'organizzazione o in gruppi di sedi di cui sono amministratori.
ListLocations
per l'account dell'organizzazione e i gruppi di sediaccounts.locations.list
chiamato con un account 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. Scopri di più.
- API GoogleLocations
- Cerca le sedi esistenti su Google da rivendicare o recupera un link per richiedere l'accesso alle sedi rivendicate. Scopri di più.
- Filtri di località espansi
- Opzioni aggiuntive per limitare i risultati restituiti da una chiamata Locations.List. Altre 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 relative agli account dell'organizzazione verranno ora visualizzate all'interno degli oggetti Account. Scopri di più.
- Foto del profilo del recensore
- Gli URL delle foto del profilo dei recensori sono ora inclusi nell'oggetto della recensione. Scopri di più.
v4.1
Nuove funzionalità
- Contenuti multimediali forniti dal cliente
- Ora puoi recuperare e visualizzare gli approfondimenti relativi a foto e video generati dagli utenti per le località di tua proprietà e gestione. Scopri di più.
- API di gestione dell'amministratore
- Ora puoi elencare, accettare e rifiutare inviti relativi all'account e alla posizione per il tuo account. Scopri di più.
Profile
(descrizione fornita dal commerciante)- Descrivi la tua attività con parole tue e condividi con gli utenti la storia unica della tua attività e delle tue offerte. Scopri di più.
- Campo
openingDate
- Fornisci la data di apertura della tua sede. Scopri di più.
- Post sul tipo di offerta
- Un nuovo tipo di post su Google che aiuta gli utenti a trovare le offerte disponibili nelle tue sedi. Scopri di più.
v4
Nuove funzionalità
- post su Google
- Ora puoi creare post su Google direttamente tramite l'API.
- Caricamento foto
- Ora le foto possono essere caricate direttamente tramite 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 useranno questo meccanismo per essere attivate anziché essere inviate a tutti gli utenti.
UPDATED_REVIEW
notifiche- Ora puoi iscriverti per ricevere notifiche in tempo reale sugli aggiornamenti delle 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, che in precedenza erano un campo di oggetti
location
, ora sono una risorsa nella posizione (accounts/account_ID/locations/location_ID/photos
).Il campo indirizzo
Country
ora èregion_code
esub_locality
ora èsublocality
.Campo
Ownership
deprecato in precedenza rimosso.In precedenza, i co-proprietari di account e sedi non erano distinguibili dai proprietari principali tramite l'API (tutti apparivano come
OWNER
). Ora ai proprietari principali verrà assegnato il ruoloOWNER
e agli altri proprietari il ruoloCO_OWNER
.AccountType.BUSINESS
ora si chiamaAccountType.LOCATION_GROUP
.Quando utilizzi una maschera di campo per aggiornare le località, fornisci
update_mask
al posto delfield_mask
esistente.Il messaggio della categoria utilizzato per
primary_category
eadditional_categories
non contiene più la forma leggibile. Gli utenti devono utilizzare il servizio categorie dell'API di Google My Business per ottenere i nomi delle categorie tradotti e leggibili.
v3.3
Nuove funzionalità
- Menu strutturati
Ora puoi aggiungere, aggiornare o eliminare:
Più menu in una determinata località
Includere più sezioni di menu in un menu
Elenca le portate con nome, descrizione, prezzo e foto
v3.2
Nuove funzionalità
- Gli approfondimenti
- Ora puoi recuperare approfondimenti sulla posizione e metriche relative alla guida tramite l'API.
- Notifiche
- Ora puoi iscriverti alle notifiche in tempo reale per i nuovi aggiornamenti di Google.
Modifiche non compatibili con le versioni precedenti
I campi
languageCodes
eplatforms
diUrlAttributeValue
non utilizzati in precedenza sono stati rimossi.SAME
nell'enum Proprietà deprecato ora si applica solo se la località duplicata 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 per ricevere notifiche in tempo reale per le nuove recensioni.
- URL di Maps
- Gli URL di Google Maps sono inclusi nelle risposte relative alla posizione e consentono agli utenti di collegarsi facilmente a Google Maps.
- Stati della posizione
- Stati della sede aggiuntivi che indicano quando la scheda è pubblicata, disattivata o in attesa di verifica.
- Flag di riapertura 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 categoria
- Visualizza un elenco delle categorie supportate per paese e lingua (sostituisce i file CSV).
v3
Nuove funzionalità
- Recensioni
- Ora puoi recuperare e rispondere alle recensioni delle attività tramite l'API.
- Attributi
- Fornisci informazioni aggiuntive sulle località specifiche per categoria.
- Trova località corrispondente
- Trova e associa manualmente le sedi esistenti su Maps alla sede della tua attività.
- Località di trasferimento
- Nuova azione su
Location :transfer
. Consente di trasferire una sede da un account (commerciale 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
eis_duplicate
. - Nuovi stati posizione
- Ora gli stati della posizione includono anche
is_verified
eneeds_reverification
. - Miglioramenti agli URL delle foto
- L'API ora accetta URL di foto senza suffisso del formato immagine.
Modifiche non compatibili con le versioni precedenti
Ora le foto possono essere aggiornate solo per le sedi con una pagina Google+ (in precedenza venivano accettate e eliminate silenziosamente).
I campi
location_name
ecategory_name
ora sono solo di output. Utilizza gli ID categoria solo quando imposti le categorie.Le maschere di campo non devono più includere il prefisso
location.
per i campi inclusi.Le operazioni di creazione/aggiornamento ora considerano la posizione come payload del corpo; gli altri parametri vengono spostati nella stringa di query.
v2
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 aiuta a evitare la creazione di sedi duplicate nel tuo account. I tentativi di creare una stazione di ricarica in cui l'ID richiesta corrisponde a una stazione di ricarica creata in precedenza restituiscono semplicemente la stazione di ricarica esistente ed evitano di creare un duplicato nel tuo account.business_hours
in Posizione è stato rinominato inregular_hours
.