Google My Business API

L'API di Google My Business fornisce un'interfaccia per la gestione delle informazioni sulle sedi dell'attività commerciale su Google.

Servizio: mybusiness.googleapis.com

Per chiamare questo servizio, ti consigliamo di utilizzare le librerie client fornite da Google. Se la tua applicazione deve utilizzare le tue librerie per chiamare questo servizio, usa le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile dalle macchine per la descrizione e l'utilizzo delle API REST. Viene utilizzato per creare librerie client, plug-in IDE e altri strumenti che interagiscono con le API di Google. Un servizio può fornire più documenti di rilevamento. Questo servizio fornisce i seguenti documenti di rilevamento:

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio può avere più endpoint di servizio. Questo servizio ha il seguente endpoint di servizio e tutti gli URI di seguito sono relativi a questo endpoint di servizio:

  • https://mybusiness.googleapis.com

Risorsa REST: v4.accounts

Metodi
create
(deprecated)
POST /v4/accounts
Crea un account con il nome e il tipo specificati sotto l'elemento principale specificato.
deleteNotifications
(deprecated)
DELETE /v4/{name=accounts/*/notifications}
Cancella le impostazioni di notifica Pub/Sub per l'account.
generateAccountNumber
(deprecated)
POST /v4/{name=accounts/*}:generateAccountNumber
Genera un numero di account per questo account.
get
(deprecated)
GET /v4/{name=accounts/*}
Consente di ottenere l'account specificato.
getNotifications
(deprecated)
GET /v4/{name=accounts/*/notifications}
Restituisce le impostazioni di notifica Pub/Sub per l'account.
list
(deprecated)
GET /v4/accounts
Elenca tutti gli account dell'utente autenticato.
listRecommendGoogleLocations GET /v4/{name=accounts/*}:recommendGoogleLocations
Elenca tutti i GoogleLocation che sono stati consigliati per l'account Profilo dell'attività specificato.
update
(deprecated)
PUT /v4/{name=accounts/*}
Consente di aggiornare l'account aziendale specificato.
updateNotifications
(deprecated)
PUT /v4/{name=accounts/*/notifications}

Configura le impostazioni di notifica Pub/Sub per l'account che indicano a Profilo dell'attività su quale argomento inviare notifiche Pub/Sub:

  • Nuove recensioni per le sedi gestite dall'account.

Risorsa REST: v4.accounts.admins

Metodi
create
(deprecated)
POST /v4/{parent=accounts/*}/admins
Invita l'utente specificato a diventare amministratore dell'account specificato.
delete
(deprecated)
DELETE /v4/{name=accounts/*/admins/*}
Rimuove l'amministratore specificato dall'account specificato.
list
(deprecated)
GET /v4/{parent=accounts/*}/admins
Elenca gli amministratori dell'account specificato.
patch
(deprecated)
PATCH /v4/{name=accounts/*/admins/*}
Consente di aggiornare l'amministratore per l'amministratore account specificato.

Risorsa REST: v4.accounts.invitations

Metodi
accept
(deprecated)
POST /v4/{name=accounts/*/invitations/*}:accept
Accetta l'invito specificato.
decline
(deprecated)
POST /v4/{name=accounts/*/invitations/*}:decline
Rifiuta l'invito specificato.
list
(deprecated)
GET /v4/{parent=accounts/*}/invitations
Elenca gli inviti in attesa per l'account specificato.

Risorsa REST: v4.accounts.locations

Metodi
associate POST /v4/{name=accounts/*/locations/*}:associate
Associa una località a un ID luogo.
batchGet POST /v4/{name=accounts/*}/locations:batchGet
Recupera tutte le località specificate nell'account specificato.
batchGetReviews POST /v4/{name=accounts/*}/locations:batchGetReviews
Restituisce l'elenco impaginato delle recensioni per tutte le località specificate.
clearAssociation POST /v4/{name=accounts/*/locations/*}:clearAssociation
Cancella un'associazione tra una località e il relativo ID luogo.
create POST /v4/{parent=accounts/*}/locations
Crea un nuovo location di proprietà dell'account specificato e lo restituisce.
delete DELETE /v4/{name=accounts/*/locations/*}
Elimina una località.
fetchVerificationOptions POST /v4/{name=accounts/*/locations/*}:fetchVerificationOptions
Segnala tutte le opzioni di verifica idonee per una sede in una lingua specifica.
findMatches POST /v4/{name=accounts/*/locations/*}:findMatches
Trova tutte le possibili località che corrispondono alla località specificata.
get GET /v4/{name=accounts/*/locations/*}
Consente di ottenere la località specificata.
getFoodMenus GET /v4/{name=accounts/*/locations/*/foodMenus}
Restituisce i menu degli alimenti di una località specifica.
getGoogleUpdated GET /v4/{name=accounts/*/locations/*}:googleUpdated
Consente di ricevere la versione aggiornata da Google della località specificata.
getHealthProviderAttributes GET /v4/{name=accounts/*/locations/*/healthProviderAttributes}
Restituisce gli attributi del fornitore di servizi sanitari di una località specifica.
getServiceList GET /v4/{name=accounts/*/locations/*/serviceList}
Ottieni l'elenco di servizi specificato di una località.
list GET /v4/{parent=accounts/*}/locations
Elenca le sedi dell'account specificato.
patch PATCH /v4/{name=accounts/*/locations/*}
Consente di aggiornare la località specificata.
reportInsights POST /v4/{name=accounts/*}/locations:reportInsights
Restituisce un report contenente approfondimenti su una o più metriche in base alla località.
transfer
(deprecated)
POST /v4/{name=accounts/*/locations/*}:transfer
Sposta una sede da un account di proprietà dell'utente a un altro account gestito dallo stesso utente.
updateFoodMenus PATCH /v4/{foodMenus.name=accounts/*/locations/*/foodMenus}
Consente di aggiornare i menu degli alimenti di un luogo specifico.
updateHealthProviderAttributes PATCH /v4/{healthProviderAttributes.name=accounts/*/locations/*/healthProviderAttributes}
Consente di aggiornare gli attributi del fornitore di servizi sanitari di una località specifica.
updateServiceList PATCH /v4/{serviceList.name=accounts/*/locations/*/serviceList}
Consente di aggiornare l'elenco di servizi specificato per una località.
verify POST /v4/{name=accounts/*/locations/*}:verify
Avvia la procedura di verifica di una sede.

Risorsa REST: v4.accounts.locations.admins

Metodi
create
(deprecated)
POST /v4/{parent=accounts/*/locations/*}/admins
Invita l'utente specificato a diventare amministratore della località specificata.
delete
(deprecated)
DELETE /v4/{name=accounts/*/locations/*/admins/*}
Rimuove l'amministratore specificato come gestore della sede specificata.
list
(deprecated)
GET /v4/{parent=accounts/*/locations/*}/admins
Elenca tutti gli amministratori per la località specificata.
patch
(deprecated)
PATCH /v4/{name=accounts/*/locations/*/admins/*}
Aggiorna l'amministratore per l'amministratore delle località specificato.

Risorsa REST: v4.accounts.locations.followers

Metodi
getMetadata GET /v4/{name=accounts/*/locations/*/followers/metadata}
Recupera le impostazioni dei follower per una località.

Risorsa REST: v4.accounts.locations.insuranceNetworks

Metodi
list GET /v4/{parent=accounts/*/locations/*}/insuranceNetworks
Restituisce un elenco di tutte le reti di assicurazioni supportate da Google.

Risorsa REST: v4.accounts.locations.localPosts

Metodi
create POST /v4/{parent=accounts/*/locations/*}/localPosts
Crea un nuovo post locale associato alla località specificata e lo restituisce.
delete DELETE /v4/{name=accounts/*/locations/*/localPosts/*}
Elimina un post locale.
get GET /v4/{name=accounts/*/locations/*/localPosts/*}
Consente di ottenere il post locale specificato.
list GET /v4/{parent=accounts/*/locations/*}/localPosts
Restituisce un elenco di post locali associati a una località.
patch PATCH /v4/{name=accounts/*/locations/*/localPosts/*}
Aggiorna il post locale specificato e restituisce il post locale aggiornato.
reportInsights POST /v4/{name=accounts/*/locations/*}/localPosts:reportInsights
Restituisce informazioni per un insieme di post locali associati a una singola scheda.

Risorsa REST: v4.accounts.locations.media

Metodi
create POST /v4/{parent=accounts/*/locations/*}/media
Crea un nuovo elemento multimediale per la posizione.
delete DELETE /v4/{name=accounts/*/locations/*/media/*}
Elimina l'elemento multimediale specificato.
get GET /v4/{name=accounts/*/locations/*/media/*}
Restituisce i metadati per l'elemento multimediale richiesto.
list GET /v4/{parent=accounts/*/locations/*}/media
Restituisce un elenco di elementi multimediali associati a una posizione.
patch PATCH /v4/{name=accounts/*/locations/*/media/*}
Consente di aggiornare i metadati dell'elemento multimediale specificato.
startUpload POST /v4/{parent=accounts/*/locations/*}/media:startUpload
Genera un MediaItemDataRef per il caricamento dell'elemento multimediale.

Risorsa REST: v4.accounts.locations.media.customers

Metodi
get GET /v4/{name=accounts/*/locations/*/media/customers/*}
Restituisce i metadati per l'elemento multimediale del cliente richiesto.
list GET /v4/{parent=accounts/*/locations/*}/media/customers
Restituisce un elenco di elementi multimediali associati a una località che sono stati forniti dai clienti.

Risorsa REST: v4.accounts.locations.questions

Metodi
create POST /v4/{parent=accounts/*/locations/*}/questions
Aggiunge una domanda per la località specificata.
delete DELETE /v4/{name=accounts/*/locations/*/questions/*}
Elimina una domanda specifica scritta dall'utente corrente.
list GET /v4/{parent=accounts/*/locations/*}/questions
Restituisce l'elenco impaginato di domande e alcune delle relative risposte per una posizione specificata.
patch PATCH /v4/{name=accounts/*/locations/*/questions/*}
Aggiorna una domanda specifica scritta dall'utente corrente.

Risorsa REST: v4.accounts.locations.questions.answers

Metodi
delete DELETE /v4/{parent=accounts/*/locations/*/questions/*}/answers:delete
Elimina la risposta scritta dall'utente corrente a una domanda.
list GET /v4/{parent=accounts/*/locations/*/questions/*}/answers
Restituisce l'elenco impaginato delle risposte per una domanda specificata.
upsert POST /v4/{parent=accounts/*/locations/*/questions/*}/answers:upsert
Crea una risposta o aggiorna la risposta esistente scritta dall'utente per la domanda specificata.

Risorsa REST: v4.accounts.locations.reviews

Metodi
deleteReply DELETE /v4/{name=accounts/*/locations/*/reviews/*}/reply
Elimina la risposta alla recensione specificata.
get GET /v4/{name=accounts/*/locations/*/reviews/*}
Restituisce la recensione specificata.
list GET /v4/{parent=accounts/*/locations/*}/reviews
Restituisce l'elenco impaginato delle recensioni della località specificata.
updateReply PUT /v4/{name=accounts/*/locations/*/reviews/*}/reply
Aggiorna la risposta alla recensione specificata.

Risorsa REST: v4.accounts.locations.verifications

Metodi
complete POST /v4/{name=accounts/*/locations/*/verifications/*}:complete
Completa una verifica del tipo PENDING.
list GET /v4/{parent=accounts/*/locations/*}/verifications
Elenca le verifiche di una sede, ordinate in base all'ora di creazione.

Risorsa REST: v4.attributes

Metodi
list GET /v4/attributes
Restituisce l'elenco degli attributi disponibili che sarebbero disponibili per una località con la categoria principale e il paese specificati.

Risorsa REST: v4.categories

Metodi
batchGet GET /v4/categories:batchGet
Restituisce un elenco di categorie di attività per gli ID lingua e GConcept forniti.
list GET /v4/categories
Restituisce un elenco di categorie di attività commerciali.

Risorsa REST: v4.chains

Metodi
get GET /v4/{name=chains/*}
Consente di ottenere la catena specificata.
search GET /v4/chains:search
Cerca la catena in base al suo nome.

Risorsa REST: v4.googleLocations

Metodi
report POST /v4/{name=googleLocations/*}:report
Segnala un GoogleLocation.
search POST /v4/googleLocations:search
Cerca tutte le possibili posizioni che corrispondono alla richiesta specificata.

Servizio: mybusiness.googleapis.com

Per chiamare questo servizio, ti consigliamo di utilizzare le librerie client fornite da Google. Se la tua applicazione deve utilizzare le tue librerie per chiamare questo servizio, usa le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile dalle macchine per la descrizione e l'utilizzo delle API REST. Viene utilizzato per creare librerie client, plug-in IDE e altri strumenti che interagiscono con le API di Google. Un servizio può fornire più documenti di rilevamento. Questo servizio fornisce i seguenti documenti di rilevamento:

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio può avere più endpoint di servizio. Questo servizio ha il seguente endpoint di servizio e tutti gli URI di seguito sono relativi a questo endpoint di servizio:

  • https://mybusiness.googleapis.com

Risorsa REST: v1.media

Metodi
upload POST /v1/media/{resourceName=**}
POST /upload/v1/media/{resourceName=**}
Carica contenuti multimediali.