v4.9
Nuove funzionalità
MoreHours
- Ora è possibile impostare MoreHours come parte della scheda dell'attività.
- Puoi recuperare
MoreHourTypes
per ogni categoria utilizzando categories.batchGet.
Cambiamenti di comportamento
- Ritiro degli account versione 4.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 di invito all'azione
- Nel secondo trimestre del 2021, i post di
CallToAction
con GET_OFFERActionType
non saranno più validi.
v4.8
Nuove funzionalità
- Servizi dell'alloggio
- Recupero e aggiornamento dei servizi dell'alloggio. Ulteriori informazioni
- Aggiunta dell'endpoint GetGoogleUpdated per l'alloggio.
- Aggiunta del valore booleano
canOperateLodgingData
in LocationState - Attributi fornitore di servizi sanitari
- Recupero e aggiornamento di HealthProviderAttributes. Ulteriori informazioni
- Aggiunta del valore booleano
canOperateHealthData
in LocationState - Reti di assicurazioni
- Elenca le reti di assicurazioni accettate dalle località. Ulteriori informazioni
Cambiamenti di comportamento
- ID recensione
- È stata eseguita la migrazione degli ID recensione in un nuovo formato. Questo nuovo ID verrà ora restituito in tutte le risposte dell'API applicabili. Per un breve periodo di tempo, gli ID recensione precedenti verranno comunque risolti se 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à
- Menù di cibo
- Recupero e aggiornamento di FoodMenus. Ulteriori informazioni
v4.6
Nuove funzionalità
- Elenchi dei servizi
- Ora puoi recuperare e aggiornare i servizi offerti da un'attività. Ulteriori informazioni
- Aggiunta del valore booleano
canModifyServiceList
in LocationState - Indica se una sede è idonea per modificare gli elenchi di serviziMaggiori informazioni
ServiceTypes
predefinito per le categorie- I tipi di servizi predefiniti sono ora inclusi come nell'oggetto categorie.Ulteriori informazioni
- CategoryView
- Possibilità di specificare una vista
BASIC
oFULL
per le categorie. La vistaFULL
restituirà ulteriori dettagli, ad esempio i tipi di servizio. Ulteriori informazioni - Metodo categorie.BatchGet
- Questo nuovo metodo ti consente di inserire un elenco di categorie e restituisce informazioni solo su quelle categorie. Ulteriori informazioni
v4.5 Aggiornamento COVID-19 2
Nuove funzionalità
- Tipo di post di avviso COVID-19
- Ora puoi creare un post di
COVID_19
tramite l'API. Scopri di più.
v4.5 Aggiornamento COVID-19 1
Nuove funzionalità
- Chiuso temporaneamente
- Ora puoi impostare un'azienda 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 su una sede. Scopri di più.
- Pub/Sub per lo stato della scheda
- Puoi ora 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
- Le attività di servizi locali ora possono essere verificate tramite l'API. Scopri di più.
- Numero di follower
- Ora puoi recuperare i metadati sui follower. Scopri di più.
- Gruppi utenti e gruppi di località
- Ora è possibile creare gruppi di utenti e gruppi di località tramite l'API. Ulteriori informazioni
- Aggiunta del campo
hasPendingEdits
in LocationState - Indica se le proprietà di una località sono in stato di modifica in sospeso. Ulteriori informazioni
Cambiamenti di comportamento
- Data di apertura
- Ora puoi impostare una data di apertura futura per una scheda.
PointRadius
- PointRadius è ora di sola lettura. Per le modifiche o la creazione di attività di servizi locali sarà necessario utilizzare Luoghi.
v4.3
Nuove funzionalità
- API Domande e risposte
- Recupera domande, pubblica risposte e fornisci domande frequenti sulle sedi della tua attività. Scopri di più.
- Recensioni a lettura collettiva
- Recupera le recensioni di più sedi con un'unica chiamata. Scopri di più.
- Località Google consigliate
- Visualizzare le sedi non rivendicate che Google ritiene essere di tua proprietà. Scopri di più.
- Segnalare problemi relativi alla posizione di Google
- Segnala problemi relativi ai risultati
RecommendedGoogleLocations
oGoogleLocations
. Scopri di più. - Enum del servizio per le sezioni
PriceList
- Identifica una sezione
PriceList
che contiene articoli ALIMENTARI o SERVIZI forniti. Scopri di più. - Descrizione dei contenuti multimediali
- Fornisci didascalie durante il caricamento di nuovi contenuti multimediali. Scopri di più.
CHAINS_QUERIES
approfondimenti- Recupera il numero di volte in cui una località è stata mostrata a seguito di una ricerca della catena a cui appartiene. Scopri di più.
Cambiamenti di comportamento
- Notifiche per account dell'organizzazione e gruppi di località
- Gli account configurati per le notifiche Pub/Sub riceveranno queste notifiche anche per le schede contenute in un account dell'organizzazione o in gruppi di località di cui sono amministratori.
ListLocations
per account dell'organizzazione e gruppi di località- L'utente
accounts.locations.list
chiamato con un account gruppo di utenti o organizzazione ora mostra tutte le sedi a cui può accedere tale account.
v4.2
Nuove funzionalità
- API Verification
- Elenca e attiva i metodi di verifica disponibili per le sedi non verificate. Scopri di più.
- API GoogleLocations
- Cerca sedi esistenti su Google da rivendicare o recupera un link per richiedere l'accesso alle sedi rivendicate. Scopri di più.
- Filtri della località espansi
- Opzioni aggiuntive per limitare i risultati restituiti da una chiamata Locations.List. Scopri di più.
- appartenenza alla catena
- Indica l'appartenenza a una sede come parte di 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 come parte degli oggetti Account. Scopri di più.
- Foto del profilo del recensore
- Gli URL delle foto del profilo dei recensori sono ora inclusi nell'oggetto recensione. Scopri di più.
v4.1
Nuove funzionalità
- Contenuti multimediali forniti dal cliente
- Ora puoi recuperare e visualizzare statistiche per le foto e i video generati dagli utenti per le sedi che possiedi e gestisci. Scopri di più.
- API per la gestione amministrativa
- Ora puoi elencare, accettare e rifiutare gli inviti relativi all'account e alla località per il tuo account. Scopri di più.
Profile
(descrizione fornita dal commerciante)- Descrivi la tua attività con la tua voce e condividi con gli utenti la storia unica della tua attività e delle offerte. Scopri di più.
openingDate
campo- Fornisci la data di apertura della tua sede. Scopri di più.
- Post relativi a tipi 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 che tramite il caricamento dell'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é inviate a tutti gli utenti.
UPDATED_REVIEW
notifiche- Ora puoi iscriverti alle notifiche in tempo reale per ricevere aggiornamenti sulle recensioni dei clienti.
- Supporto per gruppi 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 di oggetti
location
, sono ora una risorsa nella località (accounts/account_ID/locations/location_ID/photos
).Il campo indirizzo
Country
ora èregion_code
esub_locality
ora èsublocality
.È stato rimosso un campo
Ownership
precedentemente obsoleto.In precedenza, i comproprietari degli account e delle sedi non erano distinguibili dai proprietari principali tramite l'API (tutti figuravano come
OWNER
). Ora ai proprietari principali verrà assegnato il ruoloOWNER
, mentre agli altri proprietari verrà assegnato il ruoloCO_OWNER
.AccountType.BUSINESS
ora si chiamaAccountType.LOCATION_GROUP
.Quando utilizzi una maschera per i campi per l'aggiornamento delle località, fornisci
update_mask
al posto difield_mask
esistente.Il messaggio della categoria utilizzato per
primary_category
eadditional_categories
non contiene più il formato leggibile. Gli utenti devono utilizzare il servizio categorie dell'API Google My Business per ottenere nomi di categoria tradotti e leggibili.
v3.3
Nuove funzionalità
- Menu strutturati
Ora puoi aggiungere, aggiornare o eliminare:
Più menu in un determinato luogo
Includere più sezioni del menu all'interno di un menu
Voci di menu con nome, descrizione, prezzo e foto
v3.2
Nuove funzionalità
- Insight
- Ora puoi recuperare le informazioni sulle località e le metriche di 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
precedentemente inutilizzati sono stati rimossi.SAME
nell'enum della proprietà deprecata ora si applica solo se la località in cui i duplicati hanno lo stesso proprietario principale. In precedenza, il comportamento era basato su un calcolo più complesso della proprietà.
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 alla posizione per consentire agli utenti di collegarsi facilmente a Google Maps.
- Stati della località
- Ulteriori stati della posizione che indicano quando la scheda è stata pubblicata, disattivata e 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 farlo. - 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 sull'attività tramite l'API.
- Attributi
- Fornisci ulteriori informazioni sulle sedi specifiche per categoria.
- Trova località corrispondente
- Trova e associa manualmente le sedi esistenti di Maps alla sede della tua attività.
- Trasferisci località
- Nuova azione il giorno
Location :transfer
. Consente di trasferire una sede da un account (aziendale o personale) a un altro. - Foto preferita
- Indica la foto che preferisci che venga visualizzata per prima su Google Maps e nella Ricerca Google.
- Nuovi filtri di ricerca
- I nuovi filtri di ricerca includono
any_google_updates
,is_suspended
eis_duplicate
. - Nuovi stati posizione
- Gli stati delle località ora includono anche
is_verified
eneeds_reverification
. - Miglioramenti degli URL delle foto
- L'API ora accetta gli URL delle foto senza un suffisso per il formato dell'immagine.
Modifiche non compatibili con le versioni precedenti
Ora le foto possono essere aggiornate solo per le sedi con una pagina Google+ (precedentemente accettate e eliminate automaticamente).
I campi
location_name
ecategory_name
sono ora solo di output. Utilizza solo gli ID categoria quando imposti le categorie.Le maschere dei campi non devono più includere il prefisso
location.
per i campi inclusi.Le operazioni di creazione/aggiornamento ora assumono 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 per evitare la creazione di sedi duplicate nel tuo account. I tentativi di creare una località in cui l'ID richiesta corrisponde a una località creata in precedenza restituiscono semplicemente la località esistente ed evitano di creare un duplicato nel tuo account.business_hours
in Località è stato rinominato inregular_hours
.