- 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
- Denaro
- Metodi
Risorsa: località
Una località. Consulta l'articolo del Centro assistenza per una descrizione dettagliata di questi campi oppure l'endpoint di categoria per un elenco di categorie aziendali valide.
Rappresentazione JSON |
---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
Campi | |
---|---|
name |
Identificatore Google per questa sede nel formato: |
languageCode |
Immutabile. La lingua del luogo. Impostato durante la creazione e non aggiornabile. |
storeCode |
(Facoltativo) Identificatore esterno per questa località, che deve essere univoco all'interno di un determinato account. Consente di associare la sede ai tuoi record. |
title |
Obbligatorio. Il nome della sede deve rispecchiare il nome reale della tua attività, utilizzato in modo coerente sul negozio fisico, sul sito web e sulla cancelleria e come noto ai clienti. Eventuali informazioni aggiuntive, se pertinenti, possono essere incluse in altri campi della risorsa (ad esempio |
phoneNumbers |
(Facoltativo) I diversi numeri di telefono che i clienti possono utilizzare per contattare l'attività. |
categories |
(Facoltativo) Le diverse categorie che descrivono l'attività. |
storefrontAddress |
(Facoltativo) Un indirizzo preciso e preciso per descrivere la sede della tua attività. Caselle postali o cassette postali situate in località remote non sono ammesse. Al momento, puoi specificare un massimo di cinque valori |
websiteUri |
(Facoltativo) Un URL per questa attività. Se possibile, utilizza un URL che rappresenti la singola sede dell'attività commerciale anziché un sito web/URL generico che rappresenta tutte le sedi o il brand. |
regularHours |
(Facoltativo) Orario di apertura dell'attività. |
specialHours |
(Facoltativo) Orari speciali per l'attività. Ciò include in genere l'orario festivo e altri orari al di fuori del normale orario di apertura. Queste modifiche sostituiscono il normale orario di apertura. Questo campo non può essere impostato senza gli orari normali. |
serviceArea |
(Facoltativo) Le attività al domicilio del cliente forniscono il proprio servizio presso la sede del cliente. Se questa attività è un'attività al domicilio del cliente, questo campo descrive l'area o le aree servite dall'attività. |
labels[] |
(Facoltativo) Una raccolta di stringhe in formato libero che ti consente di taggare la tua attività. Queste etichette NON sono rivolte agli utenti; solo tu puoi vederle. Deve avere una lunghezza compresa tra 1 e 255 caratteri per etichetta. |
adWordsLocationExtensions |
(Facoltativo) Informazioni aggiuntive visualizzate in AdWords. |
latlng |
(Facoltativo) Latitudine e longitudine fornite dall'utente. Quando crei una località, questo campo viene ignorato se l'indirizzo fornito codifica correttamente la posizione geografica. Questo campo viene restituito nelle richieste get solo se il valore |
openInfo |
(Facoltativo) Un flag che indica se la sede è attualmente aperta. |
metadata |
Solo output. Informazioni aggiuntive non modificabili dall'utente. |
profile |
(Facoltativo) Descrive la tua attività con il tuo stile e condivide con gli utenti la storia unica della tua attività e delle tue offerte. Questo campo è obbligatorio per tutte le categorie tranne che per le categorie di alloggio (ad es. hotel, motel, locande). |
relationshipData |
(Facoltativo) Tutte le sedi e le catene correlate a questa. |
moreHours[] |
(Facoltativo) Altri orari per i diversi reparti o per clienti specifici di un'attività. |
serviceItems[] |
(Facoltativo) Elenco dei servizi supportati dai commercianti. Un servizio può essere un taglio di capelli, l'installazione di scaldabagni e così via. Gli articoli di servizio duplicati verranno rimossi automaticamente. |
PhoneNumbers
Una raccolta di numeri di telefono dell'attività. Durante gli aggiornamenti, devono essere impostati entrambi i campi. I clienti non possono aggiornare solo il numero di telefono principale o aggiuntivi utilizzando la maschera di aggiornamento. È preferibile un 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. |
additionalPhones[] |
(Facoltativo) Fino a due numeri di telefono (di cellulare o fisso, non di fax) ai quali è possibile chiamare la tua attività, oltre al numero di telefono principale. |
Categorie
Insieme di categorie che descrivono l'attività commerciale. Durante gli aggiornamenti, devono essere impostati entrambi i campi. Ai clienti è vietato aggiornare singolarmente le categorie principali o aggiuntive utilizzando la maschera di aggiornamento.
Rappresentazione JSON |
---|
{ "primaryCategory": { object ( |
Campi | |
---|---|
primaryCategory |
Obbligatorio. Categoria che descrive meglio l'attività principale in cui opera questa sede. |
additionalCategories[] |
(Facoltativo) Categorie aggiuntive per descrivere la tua attività. Le categorie consentono ai clienti di trovare risultati accurati e specifici per i servizi di loro interesse. Per fare in modo che le informazioni sulla tua attività siano sempre accurate e pubblicate, assicurati di utilizzare il minor numero possibile di categorie per descrivere la tua attività principale nel suo complesso. Scegli le categorie più specifiche possibile, ma rappresentative della tua attività principale. |
Categoria
Una categoria che descrive l'attività (non quello che fa). Per un elenco di 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 fisso (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. Viene impostato 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 dell'attività. |
moreHoursTypes[] |
Solo output. Altri tipi di orari disponibili per questa categoria dell'attività. |
ServiceType
Un 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 visualizzato leggibile per il tipo di servizio. |
MoreHoursType
Altri tipi di orari che un'attività può offrire, oltre a quello normale.
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 gli indirizzi di consegna postale o di pagamento. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a una sede, una P.O. Box o simile. Non è progettato per creare modelli di località geografiche (strade, città, montagne).
Nell'utilizzo tipico, un indirizzo verrebbe creato tramite l'input dell'utente o importando dati esistenti, a seconda del tipo di processo.
Consigli sull'inserimento / modifica di indirizzi: - Usa un widget degli indirizzi pronto per l'internazionalizzazione, come https://github.com/google/libaddressinput. - Agli utenti non dovrebbero essere mostrati elementi di interfaccia utente per l'inserimento o la modifica di campi al di fuori dei paesi in cui viene utilizzato quel 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. Ciò non viene mai dedotto e spetta all'utente assicurarsi 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 |
(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 nell'indirizzo. paese/regione o i loro equivalenti traslitterati. Questo può influenzare la formattazione in alcuni paesi, ma non è fondamentale per la correttezza dei dati e non influirà mai su convalida o altre operazioni correlate alla formattazione. Se questo valore non è noto, dovrebbe essere omesso (anziché specificare un valore predefinito potenzialmente errato). Esempi: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
(Facoltativo) Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali, ma se vengono utilizzati, possono attivare un'ulteriore convalida con altre parti dell'indirizzo (ad es. convalida stato/codice postale negli Stati Uniti). |
sortingCode |
(Facoltativo) Codice di ordinamento aggiuntivo specifico per il paese. Questa opzione non è utilizzata nella maggior parte delle regioni. Dove viene utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguita da un numero (ad es. "CEDEX 7") o solo un numero, che rappresenta il "codice di settore" (Giamaica), "indicatore zona di consegna" (Malawi) o "indicatore dell'ufficio postale" (ad es. Costa d'Avorio). |
administrativeArea |
(Facoltativo) Suddivisione amministrativa di livello più elevato utilizzata per gli indirizzi postali di un paese o di una regione. Ad esempio, può essere uno stato, una provincia, un oblast o una prefettura. In particolare, 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 es. in Svizzera, deve essere lasciato vuoto. |
locality |
(Facoltativo) In genere si riferisce alla porzione di città dell'indirizzo. Esempi: città USA, comune in Italia, città postale nel 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 |
(Facoltativo) Quartiere dell'indirizzo. Ad esempio, possono essere quartieri, quartieri e distretti. |
addressLines[] |
Righe di indirizzo non strutturate che descrivono i livelli inferiori di un indirizzo. Poiché i valori in addressLines non hanno 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 dell'indirizzo deve essere "ordine busta" per il paese o la regione dell'indirizzo. Nei luoghi dove questo valore può variare (ad es. in Giappone), viene utilizzato address_language per renderlo esplicito (ad es. "ja" per ordinamenti di grandi dimensioni e "ja-Latn" o "en" per valori di piccole dimensioni). 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 regionalCode con tutte le informazioni rimanenti inserite in addressLines. Sarebbe possibile formattare un indirizzo del genere in modo molto approssimativo senza geocodifica, ma non è stato possibile effettuare alcun ragionamento semantico su nessuno dei componenti dell'indirizzo fino a quando non è stato almeno parzialmente risolto. Creare un indirizzo che contenga solo countryCode e addressLines e poi la geocodifica è il metodo consigliato per gestire indirizzi completamente non strutturati (anziché indovinare quali parti dell'indirizzo devono essere località o aree amministrative). |
recipients[] |
(Facoltativo) Il destinatario all'indirizzo. In determinate circostanze, questo campo può contenere informazioni su più righe. Ad esempio, potrebbe contenere "cura di" informazioni. |
organization |
(Facoltativo) Il nome dell'organizzazione all'indirizzo. |
BusinessHours
Rappresenta i periodi di tempo in cui questa sede è aperta alle attività. Contiene una raccolta di istanze [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].
Rappresentazione JSON |
---|
{
"periods": [
{
object ( |
Campi | |
---|---|
periods[] |
Obbligatorio. Una raccolta degli orari di apertura di questa sede. Ogni periodo rappresenta un intervallo di orari in cui la sede è aperta durante la settimana. |
TimePeriod
Rappresenta un periodo di tempo in cui l'attività è aperta, a partire dal giorno/ora di apertura specificati e dalla chiusura nel giorno/ora di chiusura specificati. L'orario di chiusura deve essere successivo all'orario di apertura, ad esempio più tardi nella stessa giornata o in un giorno successivo.
Rappresentazione JSON |
---|
{ "openDay": enum ( |
Campi | |
---|---|
openDay |
Obbligatorio. Indica il valore |
openTime |
Obbligatorio. I valori validi sono: 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo giorno specificato. |
closeDay |
Obbligatorio. Indica il valore |
closeTime |
Obbligatorio. I valori validi sono: 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo 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. 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 dell'attività. |
minutes |
Minuti dell'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. Deve essere compreso tra 0 e 999.999.999. |
SpecialHours
Rappresenta una serie di periodi di tempo in cui l'orario di apertura di una sede è diverso dal normale orario di apertura.
Rappresentazione JSON |
---|
{
"specialHourPeriods": [
{
object ( |
Campi | |
---|---|
specialHourPeriods[] |
Obbligatorio. Un elenco di eccezioni al normale orario di apertura dell'attività. |
SpecialHourPeriod
Rappresenta un singolo periodo di tempo in cui l'orario di apertura di una sede è diverso dal normale orario di apertura. Un periodo di ore speciale deve rappresentare un intervallo inferiore a 24 ore. I valori openTime
e startDate
devono essere precedenti a closeTime
e endDate
. I closeTime
e endDate
possono estendere fino alle 11:59 del giorno successivo al 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 un'ora speciale. |
openTime |
(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 |
(Facoltativo) La data di calendario di questo periodo di un'ora speciale. Se il campo |
closeTime |
(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 |
(Facoltativo) Se true, |
Data
Rappresenta una data di calendario intera o parziale, come un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può trattarsi di uno dei seguenti valori:
- Una data completa, con valori diversi da zero per anno, mese e giorno.
- Un mese e un giorno con zero anni (ad esempio, un anniversario).
- Un anno a sé stante, con uno zero mese e uno zero-day.
- Un anno e un mese, con zero day (ad esempio, la data di scadenza della 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. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno. |
day |
Giorno di un mese. Deve essere compreso tra 1 e 31 e deve essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e mese in cui il giorno non è significativo. |
ServiceAreaBusiness
Le attività al domicilio del cliente forniscono il proprio servizio presso la sede del cliente, ad esempio un fabbro o un idraulico.
Rappresentazione JSON |
---|
{ "businessType": enum ( |
Campi | |
---|---|
businessType |
Obbligatorio. Indica il [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] dell'attività al domicilio del cliente. |
places |
L'area servita da questa attività definita mediante una serie di luoghi. |
regionCode |
Immutabile. Codice regione CLDR del paese/della regione in cui ha sede questa attività al domicilio del cliente. Per informazioni dettagliate, visita le pagine 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 viene ignorato negli altri casi. La regione specificata qui può essere diversa dalle regioni per le aree in cui questa attività opera (ad es. 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 un suo rappresentante autorizzato deve essere in grado di ricevere la posta ordinaria all'indirizzo di verifica fornito. |
BusinessType
Indica se questa attività offre servizi solo in loco presso una 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 anche consegne ai clienti).
Enum | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Solo output. Non specificato. |
CUSTOMER_LOCATION_ONLY |
Offre servizio solo nell'area circostante (non presso l'indirizzo dell'attività commerciale). Se un'attività viene aggiornata da CUSTOMER_AND_BUSINESS_LOCATION a CUSTOMER_LOCATION_ONLY, l'aggiornamento della località deve includere la maschera del campo storefrontAddress e il campo deve essere vuoto. |
CUSTOMER_AND_BUSINESS_LOCATION |
Offre il servizio presso l'indirizzo dell'attività e nella zona circostante. |
Luoghi
Definisce l'unione delle aree rappresentate da un insieme di luoghi.
Rappresentazione JSON |
---|
{
"placeInfos": [
{
object ( |
Campi | |
---|---|
placeInfos[] |
Le aree rappresentate dagli ID luogo. È consentito 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à AdWords anziché il numero di telefono principale della sede. |
LatLng
Un oggetto che rappresenta una coppia latitudine/longitudine. Questo valore è espresso come 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 negli intervalli normalizzati.
Rappresentazione JSON |
---|
{ "latitude": number, "longitude": number } |
Campi | |
---|---|
latitude |
La 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 alla riapertura. |
openingDate |
(Facoltativo) La data in cui la sede è stata aperta per la prima volta. Se non si conosce il giorno esatto, è possibile indicare solo mese e anno. La data deve essere nel passato o non essere successiva a 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 temporaneamente chiusa. |
Metadati
Ulteriori informazioni sulla località 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 sono presenti aggiornamenti che devono essere aggiornati o rifiutati dal cliente per l'ID luogo associato a questa sede. Se questo valore booleano è impostato, devi chiamare il metodo |
hasPendingEdits |
Solo output. Indica se una delle proprietà di questa località è 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 i post locali. |
canModifyServiceList |
Solo output. Indica se la scheda può modificare l'elenco di servizi. |
canHaveFoodMenus |
Solo output. Indica se la scheda è idonea per il menù del cibo. |
canOperateHealthData |
Solo output. Indica se la località può operare su dati sanitari. |
canOperateLodgingData |
Solo output. Indica se la località può utilizzare i dati delle strutture ricettive. |
placeId |
Solo output. Se questa sede viene visualizzata su Google Maps, questo campo viene compilato con l'ID della località. Questo ID può essere utilizzato in varie API Places. Questo campo può essere impostato durante le chiamate Crea, ma non per Update. |
duplicateLocation |
Solo output. La risorsa località duplicata da questa località. |
mapsUri |
Solo output. Un link alla posizione 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 alle attività commerciali. |
hasVoiceOfMerchant |
Solo output. Indica se la scheda include Voice of Merchant. Se questo valore booleano è falso, devi chiamare l'API locations.getVoiceOfMerchantState per ricevere informazioni dettagliate sul motivo per cui non dispone di Voice of Merchant. |
Profilo
Tutte le informazioni relative al profilo della sede.
Rappresentazione JSON |
---|
{ "description": string } |
Campi | |
---|---|
description |
Obbligatorio. Descrizione del luogo con i tuoi comandi vocali e non modificabile da nessun altro. |
RelationshipData
Informazioni di tutte le sedi dei publisher principali e secondari correlate a questa.
Rappresentazione JSON |
---|
{ "parentLocation": { object ( |
Campi | |
---|---|
parentLocation |
La località principale con cui è correlata questa località. |
childrenLocations[] |
L'elenco di località secondarie con cui è correlata questa località. |
parentChain |
Il nome della risorsa della catena di cui fa parte questa località. [Come trovare l'ID catena] [Locations.SearchChains] |
RelevantLocation
Informazioni su un'altra posizione correlata a quella attuale. La relazione può essere uno qualsiasi tra DEPARTMENT_OF o INDEPENDENT_ESTABLISHMENT_OF e la posizione 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 sul lato opposto della relazione con il relativo ID posizione. |
relationType |
Obbligatorio. Il tipo di relazione. |
RelationType
Le relazioni del tipo da specificare.
Enum | |
---|---|
RELATION_TYPE_UNSPECIFIED |
Tipo non specificato. |
DEPARTMENT_OF |
Questo valore rappresenta una relazione tra due sedi che condividono un'area fisica, lo stesso brand/gestione superiore/organizzazione, ma attributi chiave diversi come orari di apertura o numeri di telefono. Ad esempio, Costco Pharmacy è un reparto di Costco Wholesale. |
INDEPENDENT_ESTABLISHMENT_IN |
Si tratta dei casi in cui due sedi si trovano nella stessa sede fisica, ma di società diverse (ad es. Starbucks in un supermercato, 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 ottenere i tipi di orari supportati per le categorie delle loro sedi. |
periods[] |
Obbligatorio. Una raccolta degli orari di apertura di questo luogo. Ogni periodo rappresenta un intervallo di orari in cui la sede è aperta durante la settimana. |
ServiceItem
Un messaggio che descrive un singolo elemento del servizio. Viene utilizzato per descrivere il tipo di servizio fornito dal commerciante. Ad esempio, il taglio di capelli può essere un servizio.
Rappresentazione JSON |
---|
{ "price": { object ( |
Campi | |
---|---|
price |
(Facoltativo) Rappresenta il prezzo monetario dell'articolo del servizio. Quando includi un prezzo, ti consigliamo di impostare l'opzione currencyCode e le unità. Questo verrà considerato un prezzo fisso per l'articolo del servizio. |
Campo unione service_item_info . Uno dei seguenti campi deve essere sempre impostato. service_item_info può essere solo uno dei seguenti: |
|
structuredServiceItem |
(Facoltativo) Questo campo verrà impostato in caso di dati di servizi strutturati. |
freeFormServiceItem |
(Facoltativo) Questo campo viene impostato per i dati di servizi in formato libero. |
StructuredServiceItem
Rappresenta un servizio strutturato offerto dal commerciante. Ad esempio: servizi igienici_installation.
Rappresentazione JSON |
---|
{ "serviceTypeId": string, "description": string } |
Campi | |
---|---|
serviceTypeId |
Obbligatorio. Il campo |
description |
(Facoltativo) Descrizione dell'elemento di servizio strutturato. Il limite di caratteri è 300. |
FreeFormServiceItem
Rappresenta un servizio in formato libero offerto dal commerciante. Si tratta di servizi che non sono esposti nell'ambito dei dati dei nostri servizi della struttura. Il commerciante inserisce manualmente i nomi di questi servizi tramite una piattaforma geocommerciante.
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 con tag lingua per l'articolo. Ti consigliamo di non superare i 140 caratteri per i nomi degli articoli e di 250 caratteri per le descrizioni. 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 durante la visualizzazione del listino prezzi, della sezione o dell'articolo.
Rappresentazione JSON |
---|
{ "displayName": string, "description": string, "languageCode": string } |
Campi | |
---|---|
displayName |
Obbligatorio. Nome visualizzato del listino prezzi, della sezione o dell'articolo. |
description |
(Facoltativo) Descrizione del listino prezzi, della sezione o dell'articolo. |
languageCode |
(Facoltativo) Il codice lingua BCP-47 a cui si applicano queste stringhe. È possibile impostare un solo set di etichette per lingua. |
Denaro
Rappresenta un importo di denaro con il tipo di valuta.
Rappresentazione JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Campi | |
---|---|
currencyCode |
Il codice valuta di tre lettere definito in ISO 4217. |
units |
Le unità intere 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 località che sarà di proprietà dell'utente che ha effettuato l'accesso. |
|
Elenca le località dell'account specificato. |