- Risorsa: località
- Rappresentazione JSON
- PhoneNumbers
- Categorie
- Categoria
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- Data
- ServiceAreaBusiness
- BusinessType
- Luoghi
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- Metadati
- Profilo
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- Etichetta
- Valore monetario
- Metodi
Risorsa: località
Una posizione. Consulta l'articolo del Centro assistenza per una descrizione dettagliata di questi campi o l'endpoint della categoria per un elenco delle categorie di attività valide.
Rappresentazione JSON |
---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
Campi | |
---|---|
name |
Identificatore di Google per questa località nel formato: |
languageCode |
Immutabile. La lingua della località. Impostata durante la creazione e non aggiornabile. |
storeCode |
Campo facoltativo. Identificatore esterno per questa sede, che deve essere univoco all'interno di un determinato account. Si tratta di un metodo per associare la posizione ai tuoi registri. |
title |
Obbligatorio. Il nome della sede deve rispecchiare il nome reale della tua attività, usato in modo coerente nel tuo negozio fisico, nel tuo sito web e nella tua cancelleria e come noto ai clienti. Eventuali informazioni aggiuntive, se pertinenti, possono essere incluse in altri campi della risorsa (ad esempio, |
phoneNumbers |
Campo facoltativo. I diversi numeri di telefono che i clienti possono utilizzare per contattare l'attività. |
categories |
Campo facoltativo. Le diverse categorie che descrivono l'attività. |
storefrontAddress |
Campo facoltativo. Un indirizzo preciso e accurato per descrivere la sede della tua attività commerciale. Le caselle postali o le caselle di posta situate in località remote non sono ammesse. Al momento puoi specificare un massimo di cinque valori |
websiteUri |
Campo facoltativo. Un URL per questa attività. Se possibile, utilizza un URL che rappresenti la singola sede dell'attività anziché un sito web/URL generico che rappresenta tutte le sedi o il brand. |
regularHours |
Campo facoltativo. Orario di apertura dell'attività. |
specialHours |
Campo facoltativo. Orari speciali dell'attività. In genere questo include l'orario festivo e altri orari al di fuori del regolare orario di apertura. che hanno la precedenza sul normale orario di apertura. Questo campo non può essere impostato senza gli orari normali. |
serviceArea |
Campo facoltativo. Le attività al domicilio del cliente forniscono i propri servizi presso la sede del cliente. Se questa è un'attività al domicilio del cliente, questo campo descrive le aree servite dall'attività. |
labels[] |
Campo facoltativo. Una raccolta di stringhe in formato libero che ti consente di taggare la tua attività. Queste etichette NON sono visibili agli utenti; solo tu puoi vederle. Deve avere una lunghezza compresa tra 1 e 255 caratteri per etichetta. |
adWordsLocationExtensions |
Campo facoltativo. Informazioni aggiuntive visualizzate in AdWords. |
latlng |
Campo facoltativo. Latitudine e longitudine fornite dall'utente. Durante la creazione di una località, questo campo viene ignorato se l'indirizzo fornito viene codificato correttamente. Questo campo viene restituito nelle richieste get solo se il valore |
openInfo |
Campo facoltativo. Una bandiera che indica se la sede è attualmente aperta. |
metadata |
Solo output. Informazioni aggiuntive non modificabili dall'utente. |
profile |
Campo facoltativo. Descrive la tua attività con la tua voce e condivide con gli utenti la storia unica della tua attività e dei prodotti o servizi che offri. Questo campo è obbligatorio per tutte le categorie, ad eccezione delle categorie di alloggio (ad es. hotel, motel, locande). |
relationshipData |
Campo facoltativo. Tutte le sedi e le catene correlate a questo. |
moreHours[] |
Campo facoltativo. Più orari per i diversi reparti o per clienti specifici di un'attività. |
serviceItems[] |
Campo facoltativo. Elenco dei servizi supportati dai commercianti. Un servizio può essere un taglio di capelli, installare uno scaldabagno e così via. Gli elementi di servizio duplicati verranno rimossi automaticamente. |
PhoneNumbers
Una raccolta di numeri di telefono dell'attività. Durante gli aggiornamenti è necessario impostare entrambi i campi. I clienti non possono aggiornare solo il numero di telefono principale o aggiuntivo utilizzando la maschera di aggiornamento. È preferibile il formato telefonico internazionale, ad esempio "+1 415 555 0132". Per saperne di più, consulta la pagina https://developers.google.com/style/phone-numbers#international-phone-numbers).
Rappresentazione JSON |
---|
{ "primaryPhone": string, "additionalPhones": [ string ] } |
Campi | |
---|---|
primaryPhone |
Obbligatorio. Un numero di telefono che consenta di contattare nel modo più diretto possibile la sede dell'attività commerciale. Se possibile, utilizza un numero di telefono locale, anziché quello di un call center di assistenza centrale. |
additionalPhones[] |
Campo facoltativo. Fino a due numeri di telefono (cellulare o fisso, nessun fax) ai quali è possibile chiamare l'attività, oltre al numero di telefono principale. |
Categorie
Una raccolta di categorie che descrivono l'attività. Durante gli aggiornamenti è necessario impostare entrambi i campi. Ai clienti non è consentito aggiornare singolarmente la categoria principale o aggiuntiva utilizzando la maschera di aggiornamento.
Rappresentazione JSON |
---|
{ "primaryCategory": { object ( |
Campi | |
---|---|
primaryCategory |
Obbligatorio. Categoria che descrive meglio l'attività principale di questa sede. |
additionalCategories[] |
Campo facoltativo. Categorie aggiuntive per descrivere la tua attività. Le categorie aiutano i clienti a trovare risultati precisi e specifici per i servizi di loro interesse. Per fare in modo che le informazioni sulla tua attività siano sempre precise e aggiornate, assicurati di utilizzare il minor numero possibile di categorie per descrivere la tua attività principale nel complesso. Scegli le categorie più specifiche possibili, ma rappresentative dell'attività principale. |
Categoria
Una categoria che descrive l'attività (non la sua funzione). Per un elenco degli ID categoria validi e le mappature ai relativi nomi leggibili, consulta categories.list
.
Rappresentazione JSON |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
Campi | |
---|---|
name |
Obbligatorio. Un ID stabile (fornito da Google) per questa categoria. Il valore deve essere specificato quando si modifica la categoria (durante la creazione o l'aggiornamento di una località). |
displayName |
Solo output. Il nome leggibile della categoria. Questa impostazione viene impostata durante la lettura della posizione. Quando modifichi la località, è necessario impostare |
serviceTypes[] |
Solo output. Un elenco di tutti i tipi di servizi disponibili per questa categoria di attività. |
moreHoursTypes[] |
Solo output. Altri tipi di orari disponibili per questa categoria di attività. |
ServiceType
Messaggio che descrive un tipo di servizio offerto dall'attività.
Rappresentazione JSON |
---|
{ "serviceTypeId": string, "displayName": string } |
Campi | |
---|---|
serviceTypeId |
Solo output. Un ID stabile (fornito da Google) per questo tipo di servizio. |
displayName |
Solo output. Il nome leggibile visualizzato per il tipo di servizio. |
MoreHoursType
Altri tipi di orari offerti da un'attività, oltre ai normali orari.
Rappresentazione JSON |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
Campi | |
---|---|
hoursTypeId |
Solo output. Un ID stabile fornito da Google per questo tipo di orario. |
displayName |
Solo output. Il nome visualizzato in inglese leggibile per il tipo di orario. |
localizedDisplayName |
Solo output. Il nome visualizzato localizzato leggibile per il tipo di orario. |
PostalAddress
Rappresenta un indirizzo postale, ad esempio per la consegna o gli indirizzi per i pagamenti. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a una sede, a una casella postale o simili. Non è stato progettato per modellare le località geografiche (strade, città, montagne).
Nell'uso tipico, un indirizzo viene creato tramite l'input utente o dall'importazione di dati esistenti, a seconda del tipo di processo.
Consigli per l'inserimento / la modifica dell'indirizzo: - Usa un widget degli indirizzi pronto per l'internazionalizzazione, come https://github.com/google/libaddressinput). - Agli utenti non devono essere presentati elementi UI per l'inserimento o la modifica di campi al di fuori dei paesi in cui viene utilizzato tale campo.
Per ulteriori indicazioni su come utilizzare questo schema, consulta la pagina: https://support.google.com/business/answer/6397478
Rappresentazione JSON |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
Campi | |
---|---|
revision |
La revisione dello schema di Tutte le nuove revisioni devono essere compatibili con le versioni precedenti. |
regionCode |
Obbligatorio. Codice regione CLDR del paese o della regione dell'indirizzo. Questo non viene mai dedotto e spetta all'utente verificare che il valore sia corretto. Per informazioni dettagliate, visita le pagine https://cldr.unicode.org/ e https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera. |
languageCode |
Campo facoltativo. Codice lingua BCP-47 dei contenuti di questo indirizzo (se noto). Spesso si tratta della lingua dell'interfaccia utente del modulo di input o dovrebbe corrispondere a una delle lingue utilizzate nel paese/nella regione dell'indirizzo o ai relativi equivalenti trascritti. Ciò può influire sulla formattazione in alcuni paesi, ma non è fondamentale per la correttezza dei dati e non influirà mai sulla convalida o su altre operazioni correlate a non formattazione. Se questo valore non è noto, deve essere omesso (anziché specificare un valore predefinito potenzialmente errato). Esempi: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
Campo facoltativo. Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali. Tuttavia, se vengono utilizzati, possono attivare un'ulteriore convalida con altre parti dell'indirizzo (ad es. la convalida del codice postale negli Stati Uniti). |
sortingCode |
Campo facoltativo. Codice di ordinamento aggiuntivo specifico per il paese. Questa opzione non è utilizzata nella maggior parte delle regioni. Se viene utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguito da un numero (ad es. "CEDEX 7") o solo un numero che rappresenta il "codice del settore" (Giamaica), "indicatore dell'area di consegna" (Malawi) o "indicatore dell'ufficio postale" (ad es. Costa d'Avorio). |
administrativeArea |
Campo facoltativo. Suddivisione amministrativa di livello più alto utilizzata per gli indirizzi postali di un paese o di una regione. Ad esempio, uno stato, una provincia, un oblast o una prefettura. Nello specifico, per la Spagna si tratta della provincia e non della comunità autonoma (ad es. "Barcellona" e non "Catalogna"). Molti paesi non utilizzano un'area amministrativa negli indirizzi postali. Ad esempio, in Svizzera questo campo deve essere lasciato vuoto. |
locality |
Campo facoltativo. Si riferisce generalmente alla parte relativa alla città dell'indirizzo. Esempi: città degli Stati Uniti, comune italiano, città del Regno Unito. Nelle regioni del mondo in cui le località non sono ben definite o non si adattano bene a questa struttura, lascia il campo della località vuoto e utilizza AddressLines. |
sublocality |
Campo facoltativo. Circoscrizione dell'indirizzo. ad esempio quartieri, distretti o distretti. |
addressLines[] |
Righe indirizzo non strutturate che descrivono i livelli inferiori di un indirizzo. Poiché i valori in addressLines non contengono informazioni sul tipo e a volte possono contenere più valori in un singolo campo (ad es. "Austin, TX"), è importante che l'ordine delle righe sia chiaro. L'ordine delle righe indirizzo deve essere "ordine busta" per il paese/la regione dell'indirizzo. Nei luoghi in cui può variare (ad esempio in Giappone), viene utilizzato address_language per renderlo esplicito (ad es. "ja" per ordinamento da grande a piccolo e "ja-Latn" o "en" per ordine piccolo-grande). In questo modo è possibile selezionare la riga più specifica di un indirizzo in base alla lingua. La rappresentazione strutturale minima consentita di un indirizzo è composta da un elemento regioneCode con tutte le informazioni rimanenti inserite nelle righe dell'indirizzo. Sarebbe possibile formattare un indirizzo di questo tipo in modo molto approssimativo senza geocodifica, ma non è stato possibile fare un ragionamento semantico su nessuno dei componenti dell'indirizzo fino a quando non fosse stato risolto almeno parzialmente. La creazione di un indirizzo contenente solo regioneCode e indirizzoLines, quindi la geocodifica è il metodo consigliato per gestire indirizzi completamente non strutturati (invece di indovinare quali parti dell'indirizzo dovrebbero essere località o aree amministrative). |
recipients[] |
Campo facoltativo. Il destinatario all'indirizzo. In determinate circostanze, questo campo può contenere informazioni su più righe. Ad esempio, potrebbe contenere informazioni di tipo "cura di". |
organization |
Campo facoltativo. Il nome dell'organizzazione all'indirizzo. |
BusinessHours
Rappresenta i periodi di tempo in cui questa sede è aperta al pubblico. Contiene una raccolta di istanze [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].
Rappresentazione JSON |
---|
{
"periods": [
{
object ( |
Campi | |
---|---|
periods[] |
Obbligatorio. Una raccolta degli orari in cui questa sede è aperta al pubblico. Ogni periodo rappresenta un intervallo di ore in cui la sede è aperta durante la settimana. |
TimePeriod
Rappresenta un intervallo di tempo in cui l'attività è aperta, a partire dal giorno/ora di apertura specificati e fino alla chiusura nel giorno/ora di chiusura specificati. L'orario di chiusura deve essere successivo all'orario di apertura, ad esempio più tardi dello stesso giorno o in un giorno successivo.
Rappresentazione JSON |
---|
{ "openDay": enum ( |
Campi | |
---|---|
openDay |
Obbligatorio. Indica il |
openTime |
Obbligatorio. I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato. |
closeDay |
Obbligatorio. Indica il |
closeTime |
Obbligatorio. I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato. |
DayOfWeek
Rappresenta un giorno della settimana.
Enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Il giorno della settimana non è specificato. |
MONDAY |
Lunedì |
TUESDAY |
Martedì |
WEDNESDAY |
mercoledì |
THURSDAY |
giovedì |
FRIDAY |
venerdì |
SATURDAY |
Sabato |
SUNDAY |
domenica |
TimeOfDay
Rappresenta un'ora del giorno. La data e il fuso orario non sono significativi o sono specificati altrove. Un'API può scegliere di consentire i secondi intercalari. I tipi correlati sono google.type.Date
e google.protobuf.Timestamp
.
Rappresentazione JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Campi | |
---|---|
hours |
Le ore del giorno nel formato 24 ore. Il valore deve essere compreso tra 0 e 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura di un'attività. |
minutes |
Minuti di ora del giorno. Il valore deve essere compreso tra 0 e 59. |
seconds |
Secondi di minuti del tempo. Normalmente deve essere compreso tra 0 e 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari. |
nanos |
Frazioni di secondi in nanosecondi. Il valore deve essere compreso tra 0 e 999.999.999. |
SpecialHours
Rappresenta una serie di periodi di tempo in cui gli orari di apertura di una sede sono diversi dal normale orario di apertura.
Rappresentazione JSON |
---|
{
"specialHourPeriods": [
{
object ( |
Campi | |
---|---|
specialHourPeriods[] |
Obbligatorio. Un elenco di eccezioni all'orario normale dell'attività. |
SpecialHourPeriod
Rappresenta un singolo periodo di tempo in cui gli orari di apertura di una sede differiscono dal normale orario di apertura. Un periodo di ore speciale deve rappresentare un intervallo inferiore a 24 ore. openTime
e startDate
devono essere precedenti a closeTime
e endDate
. closeTime
e endDate
possono essere estesi fino alle 11:59 del giorno successivo a startDate
specificato. Ad esempio, i seguenti input sono validi:
startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59
I seguenti input non sono validi:
startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
Rappresentazione JSON |
---|
{ "startDate": { object ( |
Campi | |
---|---|
startDate |
Obbligatorio. La data di calendario in cui inizia questo periodo di ora speciale. |
openTime |
Campo facoltativo. I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato. Deve essere specificato se |
endDate |
Campo facoltativo. La data di calendario in cui termina questo periodo di ora speciale. Se il campo |
closeTime |
Campo facoltativo. I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato. Deve essere specificato se |
closed |
Campo facoltativo. Se il valore è true, |
Data
Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti valori:
- Una data completa, con valori di anno, mese e giorno diversi da zero.
- Un mese e un giorno, con un anno zero (ad esempio, un anniversario).
- Un anno per sé, con un mese e un giorno zero.
- Un anno e un mese, con un giorno zero (ad esempio, la data di scadenza di una carta di credito).
Tipi correlati:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Rappresentazione JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campi | |
---|---|
year |
Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno. |
month |
Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese. |
day |
Giorno del mese. Deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo. |
ServiceAreaBusiness
Le attività al domicilio del cliente forniscono i propri servizi presso la sede del cliente (ad es. un fabbro o un idraulico).
Rappresentazione JSON |
---|
{ "businessType": enum ( |
Campi | |
---|---|
businessType |
Obbligatorio. Indica [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] dell'attività al domicilio del cliente. |
places |
L'area servita da questa attività è definita da un insieme di luoghi. |
regionCode |
Immutabile. Codice regione CLDR del paese o della regione in cui ha sede l'attività al domicilio del cliente. Per informazioni dettagliate, visita i siti http://cldr.unicode.org/ e http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera. Questo campo è obbligatorio per le attività CUSTOMER_LOCATION_only e in caso contrario viene ignorato. La regione specificata qui può essere diversa dalle regioni delle aree servite da questa attività (ad es. le attività al domicilio del cliente che forniscono servizi in regioni diverse da quella in cui hanno sede). Se questa sede richiede la verifica dopo la creazione, l'indirizzo fornito ai fini della verifica deve trovarsi in questa regione e il proprietario dell'attività o il suo rappresentante autorizzato deve essere in grado di ricevere posta all'indirizzo di verifica fornito. |
BusinessType
Indica se questa attività offre servizi solo presso la sede del cliente (ad es. un carro attrezzi) o sia presso un indirizzo che in loco (ad esempio una pizzeria con zona pranzo che effettua consegne anche ai clienti).
Enum | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Solo output. Non specificato. |
CUSTOMER_LOCATION_ONLY |
Offre il servizio solo nell'area circostante (non presso l'indirizzo dell'attività). Se un'attività viene aggiornata da CUSTOMER_AND_BUSINESS_LOCATION a CUSTOMER_LOCATION_ONLY, l'aggiornamento della località deve includere la maschera di campo storefrontAddress e impostare il campo su vuoto. |
CUSTOMER_AND_BUSINESS_LOCATION |
Offre il servizio presso l'indirizzo dell'attività e nell'area circostante. |
Luoghi
Definisce l'unione di aree rappresentate da un insieme di luoghi.
Rappresentazione JSON |
---|
{
"placeInfos": [
{
object ( |
Campi | |
---|---|
placeInfos[] |
Le aree rappresentate dagli ID luogo. L'offerta è limitata a un massimo di 20 posti. |
PlaceInfo
Definisce un'area rappresentata da un ID luogo.
Rappresentazione JSON |
---|
{ "placeName": string, "placeId": string } |
Campi | |
---|---|
placeName |
Obbligatorio. Il nome localizzato del luogo. Ad esempio, |
placeId |
Obbligatorio. L'ID del luogo. Deve corrispondere a una regione. (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
Informazioni aggiuntive visualizzate in AdWords.
Rappresentazione JSON |
---|
{ "adPhone": string } |
Campi | |
---|---|
adPhone |
Obbligatorio. Un numero di telefono alternativo da mostrare nelle estensioni di località di AdWords al posto del numero di telefono principale della località. |
LatLng
Un oggetto che rappresenta una coppia di latitudine/longitudine. Questo valore viene espresso come una coppia di doppi per rappresentare i gradi di latitudine e i gradi di longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono essere compresi in intervalli normalizzati.
Rappresentazione JSON |
---|
{ "latitude": number, "longitude": number } |
Campi | |
---|---|
latitude |
Latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0]. |
longitude |
Longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0]. |
OpenInfo
Informazioni relative allo stato di apertura dell'attività.
Rappresentazione JSON |
---|
{ "status": enum ( |
Campi | |
---|---|
status |
Obbligatorio. Indica se la sede è attualmente aperta o meno. Tutte le sedi sono aperte per impostazione predefinita, a meno che non vengano aggiornate in modo da essere chiuse. |
canReopen |
Solo output. Indica se questa attività è idonea per la riapertura. |
openingDate |
Campo facoltativo. La data di apertura della sede. Se non si conosce il giorno esatto, è possibile indicare solo il mese e l'anno. La data deve essere nel passato o non essere più di un anno nel futuro. |
OpenForBusiness
Indica lo stato di una posizione.
Enum | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED |
Non specificato. |
OPEN |
Indica che la sede è aperta. |
CLOSED_PERMANENTLY |
Indica che la sede è stata chiusa definitivamente. |
CLOSED_TEMPORARILY |
Indica che la sede è stata chiusa temporaneamente. |
Metadati
Ulteriori informazioni sulla sede non modificabili dall'utente.
Rappresentazione JSON |
---|
{ "hasGoogleUpdated": boolean, "hasPendingEdits": boolean, "canDelete": boolean, "canOperateLocalPost": boolean, "canModifyServiceList": boolean, "canHaveFoodMenus": boolean, "canOperateHealthData": boolean, "canOperateLodgingData": boolean, "placeId": string, "duplicateLocation": string, "mapsUri": string, "newReviewUri": string, "canHaveBusinessCalls": boolean, "hasVoiceOfMerchant": boolean } |
Campi | |
---|---|
hasGoogleUpdated |
Solo output. Indica se l'ID luogo associato a questa sede contiene aggiornamenti che devono essere aggiornati o rifiutati dal cliente. Se questo valore booleano è impostato, devi chiamare il metodo |
hasPendingEdits |
Solo output. Indica se le proprietà di questa località sono in stato di modifica in attesa. |
canDelete |
Solo output. Indica se la località può essere eliminata utilizzando l'API. |
canOperateLocalPost |
Solo output. Indica se la scheda può gestire post locali. |
canModifyServiceList |
Solo output. Indica se la scheda può modificare l'elenco dei servizi. |
canHaveFoodMenus |
Solo output. Indica se la scheda è idonea per il menu del cibo. |
canOperateHealthData |
Solo output. Indica se la posizione può operare sui dati sanitari. |
canOperateLodgingData |
Solo output. Indica se la posizione può operare sui dati dell'alloggio. |
placeId |
Solo output. Se la località viene visualizzata su Google Maps, il campo viene compilato con l'ID del luogo. Questo ID può essere utilizzato in varie API Places. Questo campo può essere impostato durante le chiamate Create, ma non per Update. |
duplicateLocation |
Solo output. La risorsa della località duplicata da questa località. |
mapsUri |
Solo output. Un link alla località su Maps. |
newReviewUri |
Solo output. Un link alla pagina nella Ricerca Google in cui un cliente può lasciare una recensione per la sede. |
canHaveBusinessCalls |
Solo output. Indica se la scheda è idonea per le chiamate di attività commerciali. |
hasVoiceOfMerchant |
Solo output. Indica se la scheda ha Voice of Merchant. Se questo valore booleano è false, devi chiamare l'API locations.getVoiceOfMerchantState per ottenere dettagli sul motivo per cui non ha Voice of Merchant. |
Profilo
Tutte le informazioni relative al profilo della sede.
Rappresentazione JSON |
---|
{ "description": string } |
Campi | |
---|---|
description |
Obbligatorio. Descrizione del luogo a tua voce, non modificabile da nessun altro. |
RelationshipData
Informazioni di tutte le posizioni principali e secondarie correlate a questo.
Rappresentazione JSON |
---|
{ "parentLocation": { object ( |
Campi | |
---|---|
parentLocation |
La sede principale con cui è correlata questa sede. |
childrenLocations[] |
L'elenco dei luoghi dei bambini con cui questa località è correlata. |
parentChain |
Il nome della risorsa della catena di cui fa parte la sede. [Come trovare l'ID catena] [Locations.SearchChains] |
RelevantLocation
Informazioni su un'altra posizione correlata a quella attuale. La relazione può essere una qualsiasi tra DEPARTMENT_OF o INDEPENDENT_ESTABLISHMENT_OF e la località specificata qui può essere su entrambi i lati (principale/secondario) della località.
Rappresentazione JSON |
---|
{
"placeId": string,
"relationType": enum ( |
Campi | |
---|---|
placeId |
Obbligatorio. Specifica la località che si trova dall'altro lato della relazione tramite il relativo PlaceID. |
relationType |
Obbligatorio. Il tipo di relazione. |
RelationType
Le relazioni di tipo da specificare.
Enum | |
---|---|
RELATION_TYPE_UNSPECIFIED |
Tipo non specificato. |
DEPARTMENT_OF |
Questo rappresenta una relazione tra due sedi che condividono un'unica area fisica, lo stesso brand/alta dirigenza/organizzazione, ma con attributi chiave diversi come orari di apertura o numeri di telefono. Ad esempio, Costco Pharmacy è un dipartimento della catena Costco Wholesale. |
INDEPENDENT_ESTABLISHMENT_IN |
Questo è il caso in cui due sedi sono con sede nella stessa posizione fisica, ma di aziende diverse (ad es. Starbucks al supermercato Carrefour, negozi in un centro commerciale). |
MoreHours
I periodi di tempo durante i quali una sede è aperta per determinati tipi di attività.
Rappresentazione JSON |
---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
Campi | |
---|---|
hoursTypeId |
Obbligatorio. Tipo di orari. I clienti devono chiamare {#link businessCategories:BatchGet} per conoscere i tipi di orari supportati per le categorie delle loro sedi. |
periods[] |
Obbligatorio. Una raccolta degli orari di apertura di questa sede. Ogni periodo rappresenta un intervallo di ore in cui la sede è aperta durante la settimana. |
ServiceItem
Un messaggio che descrive un singolo elemento del servizio. È utilizzato per descrivere il tipo di servizio fornito dal commerciante. Ad esempio, taglio di capelli può essere un servizio.
Rappresentazione JSON |
---|
{ "price": { object ( |
Campi | |
---|---|
price |
Campo facoltativo. Rappresenta il prezzo monetario dell'articolo di servizio. Ti consigliamo di impostare currencyCode e unità quando includi un prezzo. Verrà considerato un prezzo fisso per l'articolo del servizio. |
Campo di unione service_item_info . Uno dei seguenti campi deve essere sempre impostato. service_item_info può essere solo uno dei seguenti: |
|
structuredServiceItem |
Campo facoltativo. Questo campo imposterà il caso dei dati dei servizi strutturati. |
freeFormServiceItem |
Campo facoltativo. Questo campo imposterà la distinzione tra maiuscole e minuscole per i dati dei servizi in formato libero. |
StructuredServiceItem
Rappresenta un servizio strutturato offerto dal commerciante. Ad esempio: toilet_installation.
Rappresentazione JSON |
---|
{ "serviceTypeId": string, "description": string } |
Campi | |
---|---|
serviceTypeId |
Obbligatorio. Il campo |
description |
Campo facoltativo. Descrizione dell'elemento di servizio strutturato. Il limite di caratteri è 300. |
FreeFormServiceItem
Rappresenta un servizio in formato libero offerto dal commerciante. Questi sono servizi che non sono esposti nei dati dei nostri servizi strutturati. Il commerciante inserisce manualmente i nomi di questi servizi tramite una piattaforma geomerchant.
Rappresentazione JSON |
---|
{
"category": string,
"label": {
object ( |
Campi | |
---|---|
category |
Obbligatorio. Questo campo rappresenta il nome della categoria (ovvero l'ID stabile della categoria). |
label |
Obbligatorio. Etichette dell'elemento con tag della lingua. È consigliabile che i nomi degli elementi non superino i 140 caratteri e le descrizioni non superino i 250 caratteri. Questo campo deve essere impostato solo se l'input è un elemento di servizio personalizzato. I tipi di servizi standardizzati devono essere aggiornati tramite serviceTypeId. |
Etichetta
Etichetta da utilizzare quando visualizzi il listino prezzi, la sezione o l'articolo.
Rappresentazione JSON |
---|
{ "displayName": string, "description": string, "languageCode": string } |
Campi | |
---|---|
displayName |
Obbligatorio. Nome visualizzato del listino prezzi, della sezione o dell'elemento. |
description |
Campo facoltativo. Descrizione del listino prezzi, della sezione o dell'elemento. |
languageCode |
Campo facoltativo. Il codice lingua BCP-47 a cui si applicano queste stringhe. È possibile impostare un solo insieme di etichette per lingua. |
Valuta
Rappresenta un importo di denaro con il relativo tipo di valuta.
Rappresentazione JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Campi | |
---|---|
currencyCode |
Il codice valuta di tre lettere definito nello standard ISO 4217. |
units |
L'intera unità dell'importo. Ad esempio, se |
nanos |
Numero di nano (10^-9) unità della quantità. Il valore deve essere compreso tra -999.999.999 e +999.999.999 inclusi. Se |
Metodi |
|
---|---|
|
Crea una nuova posizione che sarà di proprietà dell'utente che ha eseguito l'accesso. |
|
Elenca le sedi dell'account specificato. |