REST Resource: accounts.locations

Risorsa: Location

Una località. Consulta l'articolo del Centro assistenza per una descrizione dettagliata di questi campi o l'endpoint della categoria per un elenco delle categorie dell'attività valide.

Rappresentazione JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
Campi
name

string

Identificatore. Identificatore Google per questa località nel formato: locations/{locationId}.
languageCode

string

Immutabile. La lingua della località. Impostato durante la creazione e non aggiornabile.
storeCode

string

Facoltativo. Identificatore esterno per questa località, che deve essere univoco all'interno di un determinato account. In questo modo, puoi associare la località ai tuoi record.
title

string

Obbligatorio. Il nome della sede deve rispecchiare il nome reale della tua attività, come utilizzato in modo coerente su vetrina, sito web e carta intestata e così come noto ai clienti. Eventuali informazioni aggiuntive, se pertinenti, possono essere incluse in altri campi della risorsa (ad esempio Address, Categories). Non aggiungere informazioni non necessarie al nome (ad esempio, preferisci "Google" a "Google Inc. - Sede centrale di Mountain View"). Non includere slogan di marketing, codici negozio, caratteri speciali, orari o stato di apertura/chiusura, numeri di telefono, URL del sito web, informazioni sul prodotto, posizione/indirizzo o indicazioni stradali o informazioni di contenimento (ad es. "Bancomat Chase in Duane Reade").
phoneNumbers

object (PhoneNumbers)

Facoltativo. I diversi numeri di telefono che i clienti possono utilizzare per contattare l'attività.
categories

object (Categories)

Facoltativo. Le diverse categorie che descrivono l'attività.
storefrontAddress

object (PostalAddress)

Facoltativo. Un indirizzo preciso e accurato per descrivere la sede della tua attività. Le caselle o cassette postali situate in località remote non sono ammesse. Al momento, puoi specificare un massimo di cinque valori addressLines nell'indirizzo. Questo campo deve essere impostato solo per le attività che hanno un negozio fisico. Questo campo non deve essere impostato per le località di tipo CUSTOMER_LOCATION_ONLY, ma se viene impostato, qualsiasi valore fornito verrà ignorato.
websiteUri

string

Facoltativo. Un URL per questa attività. Se possibile, utilizza un URL che rappresenti questa singola sede dell'attività anziché un sito web/URL generico che rappresenti tutte le sedi o il brand.
regularHours

object (BusinessHours)

Facoltativo. Orario di apertura dell'attività.
specialHours

object (SpecialHours)

Facoltativo. Orari speciali dell'attività. In genere, sono inclusi gli orari di apertura durante le festività e altri orari al di fuori del normale orario di apertura. Questi orari sostituiscono l'orario di apertura normale. Questo campo non può essere impostato senza l'orario standard.
serviceArea

object (ServiceAreaBusiness)

Facoltativo. Le attività al domicilio del cliente forniscono il loro servizio presso la sede del cliente. Se si tratta di un'attività al domicilio del cliente, questo campo descrive le aree servite dall'attività.
labels[]

string

Facoltativo. Una raccolta di stringhe in formato libero che ti consentono di taggare la tua attività. Queste etichette NON sono visibili agli utenti, ma solo a te. Deve contenere da 1 a 255 caratteri per etichetta.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Facoltativo. Informazioni aggiuntive visualizzate in AdWords.
latlng

object (LatLng)

Facoltativo. Latitudine e longitudine fornite dall'utente. Quando crei una località, questo campo viene ignorato se l'indirizzo fornito viene geocodificato correttamente. Questo campo viene restituito solo per le richieste GET se il valore latlng fornito dall'utente è stato accettato durante la creazione o se il valore latlng è stato aggiornato tramite il sito web di Profilo dell'attività su Google. Questo campo può essere aggiornato solo dai clienti approvati.
openInfo

object (OpenInfo)

Facoltativo. Un flag che indica se la sede è attualmente aperta.
metadata

object (Metadata)

Solo output. Informazioni aggiuntive non modificabili dall'utente.
profile

object (Profile)

Facoltativo. Descrive la tua attività con parole tue e condivide con gli utenti la storia unica della tua attività e delle tue offerte.

Questo campo è obbligatorio per tutte le categorie, ad eccezione di quelle relative agli alloggi (ad es. hotel, motel, locande).
relationshipData

object (RelationshipData)

Facoltativo. Tutte le sedi e la catena correlate a questa.
moreHours[]

object (MoreHours)

Facoltativo. Altri orari per i diversi reparti o clienti specifici di un'attività.
serviceItems[]

object (ServiceItem)

Facoltativo. Elenco dei servizi supportati dai commercianti. Un servizio può essere un taglio di capelli, l'installazione di 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, entrambi i campi devono essere impostati. I client non possono aggiornare solo i numeri di telefono principali o aggiuntivi utilizzando la maschera di aggiornamento. È preferibile il formato telefonico internazionale, ad esempio "+1 415 555 0132". Per saperne di più, visita la pagina (https://developers.google.com/style/phone-numbers#international-phone-numbers).

Rappresentazione JSON 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
Campi
primaryPhone

string

Obbligatorio. Un numero di telefono che consenta di contattare la singola sede della tua attività nel modo più diretto possibile. Se possibile, utilizza un numero di telefono locale anziché un numero di assistenza clienti di un call center centrale.
additionalPhones[]

string

Facoltativo. Fino a due numeri di telefono (cellulare o rete fissa, no fax) ai quali la tua attività può essere chiamata, oltre al numero di telefono principale.

Categorie

Una raccolta di categorie che descrivono l'attività. Durante gli aggiornamenti, entrambi i campi devono essere impostati. I client non possono aggiornare singolarmente le categorie principali o aggiuntive utilizzando la maschera di aggiornamento.

Rappresentazione JSON 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Campi
primaryCategory

object (Category)

Obbligatorio. Categoria che descrive meglio l'attività principale svolta in questa sede.
additionalCategories[]

object (Category)

Facoltativo. Categorie aggiuntive per descrivere la tua attività. Le categorie aiutano i clienti a trovare risultati precisi e specifici per i servizi che li interessano. Per garantire l'accuratezza e la pubblicazione delle informazioni sulla tua attività, assicurati di utilizzare il minor numero possibile di categorie per descrivere la tua attività principale. Scegli categorie il più specifiche possibile, ma rappresentative della tua attività principale.

Categoria

Una categoria che descrive l'attività (non ciò che fa). Per un elenco degli ID categoria validi e delle mappature ai relativi nomi leggibili, consulta categories.list.

Rappresentazione JSON 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Campi
name

string

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 sede).
displayName

string

Solo output. Il nome leggibile della categoria. Questo valore viene impostato durante la lettura della località. Quando modifichi la località, devi impostare category_id.
serviceTypes[]

object (ServiceType)

Solo output. Un elenco di tutti i tipi di servizio disponibili per questa categoria dell'attività.
moreHoursTypes[]

object (MoreHoursType)

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

string

Solo output. Un ID stabile (fornito da Google) per questo tipo di servizio.
displayName

string

Solo output. Il nome visualizzato leggibile per il tipo di servizio.

MoreHoursType

Tipi di altri orari che un'attività può offrire, oltre ai suoi orari di apertura standard.

Rappresentazione JSON 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
Campi
hoursTypeId

string

Solo output. Un ID stabile fornito da Google per questo tipo di orario.
displayName

string

Solo output. Il nome visualizzato in inglese leggibile dall'utente per il tipo di orario.
localizedDisplayName

string

Solo output. Il nome visualizzato localizzato leggibile dall'utente per il tipo di orario.

PostalAddress

Rappresenta un indirizzo postale, ad esempio per la consegna postale o gli indirizzi di pagamento. Con un indirizzo postale, un servizio postale può consegnare articoli a un edificio, una casella postale o simili. Un indirizzo postale non è destinato a modellare posizioni geografiche come strade, città o montagne.

In un utilizzo tipico, un indirizzo viene creato tramite l'input dell'utente o l'importazione di dati esistenti, a seconda del tipo di processo.

Consigli per l'inserimento o la modifica dell'indirizzo:

  • Utilizza un widget per gli indirizzi pronto per l'internazionalizzazione, ad esempio 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 il 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

integer

La revisione dello schema di PostalAddress. Questo valore deve essere impostato su 0, ovvero l'ultima revisione.

Tutte le nuove revisioni devono essere compatibili con le versioni precedenti.
regionCode

string

Obbligatorio. Codice CLDR del paese/dell'area geografica dell'indirizzo. Questo valore non viene mai dedotto e spetta all'utente assicurarsi che sia corretto. Per maggiori dettagli, 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

string

Facoltativo. Codice lingua BCP-47 dei contenuti dell'indirizzo (se noto). Spesso si tratta della lingua dell'interfaccia utente del modulo di immissione o si prevede che corrisponda a una delle lingue utilizzate nel paese o nella regione dell'indirizzo o ai relativi equivalenti traslitterati. 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 non correlate alla formattazione.

Se questo valore non è noto, deve essere omesso (anziché specificare un valore predefinito potenzialmente errato).

Esempi: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Facoltativo. Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono i codici postali, ma dove vengono utilizzati, possono attivare una convalida aggiuntiva con altre parti dell'indirizzo (ad esempio, la convalida dello stato o del codice postale negli Stati Uniti).
sortingCode

string

Facoltativo. Codice di ordinamento aggiuntivo specifico per paese. Questo campo non viene utilizzato nella maggior parte delle regioni. Se utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguita da un numero (ad esempio "CEDEX 7"), o solo un numero, che rappresenta il "codice di settore" (Giamaica), l'"indicatore dell'area di consegna" (Malawi) o l'"indicatore dell'ufficio postale" (Costa d'Avorio).
administrativeArea

string

Facoltativo. Suddivisione amministrativa di grado più alto usata per l'indirizzo postale di un paese o di un'area geografica. Ad esempio, può essere uno stato, una provincia, un oblast o una prefettura. Per la Spagna, si tratta della provincia e non della comunità autonoma (ad esempio, "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

string

Facoltativo. Solitamente si riferisce alla porzione di città dell'indirizzo. Esempio: "city" per gli Stati Uniti, "comune" in Italia, "post town" nel Regno Unito. Lì dove le località non sono ben definite o non rientrano nella struttura, lascia il campo locality vuoto e usa addressLines.
sublocality

string

Facoltativo. Quartiere dell'indirizzo. Ad esempio, può essere un quartiere, un rione o un distretto.
addressLines[]

string

Righe dell'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 esempio "Austin, TX"), è importante che l'ordine delle righe sia chiaro. L'ordine delle righe dell'indirizzo deve essere l'"ordine della busta" per il paese o la regione dell'indirizzo. Nei luoghi in cui questo può variare (ad esempio, il Giappone), viene utilizzato address_language per renderlo esplicito (ad esempio, "ja" per l'ordinamento dal più grande al più piccolo e "ja-Latn" o "en" per l'ordinamento dal più piccolo al più 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 è costituita da un regionCode con tutte le informazioni rimanenti inserite in addressLines. Senza la geocodifica, sarebbe possibile formattare un indirizzo di questo tipo in modo molto approssimativo, ma non sarebbe possibile fare alcun ragionamento semantico su nessuno dei componenti dell'indirizzo finché non viene risolto almeno parzialmente.

La creazione di un indirizzo contenente solo regionCode e addressLines e la successiva geocodifica è il modo consigliato per gestire indirizzi completamente non strutturati (anziché indovinare quali parti dell'indirizzo devono essere località o aree amministrative).
recipients[]

string

Facoltativo. Il destinatario all'indirizzo. In determinate circostanze, questo campo può contenere informazioni su più righe. Ad esempio, potrebbe contenere informazioni "presso".
organization

string

Facoltativo. Il nome dell'organizzazione all'indirizzo.

BusinessHours

Rappresenta i periodi di tempo in cui questa sede è aperta. Contiene una raccolta di istanze [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

Rappresentazione JSON 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Campi
periods[]

object (TimePeriod)

Obbligatorio. Una raccolta di orari in cui questa sede è aperta. 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 e dall'ora di apertura specificati fino al giorno e all'ora di chiusura specificati. L'orario di chiusura deve essere successivo all'orario di apertura, ad esempio più tardi nello stesso giorno o in un giorno successivo.

Rappresentazione JSON 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Campi
openDay

enum (DayOfWeek)

Obbligatorio. Indica il giorno day of the week in cui inizia questo periodo.
openTime

object (TimeOfDay)

Obbligatorio. I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato. Nota: nella mappatura JSON Proto3, i valori zero predefiniti (00:00) vengono omessi, generando {} per openTime.
closeDay

enum (DayOfWeek)

Obbligatorio. Indica il giorno day of the week in cui termina questo periodo.
closeTime

object (TimeOfDay)

Obbligatorio. I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato. Nota: nella mappatura JSON Proto3, i valori zero predefiniti (00:00) vengono omessi, generando {} per closeTime.

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

integer

Ore di un giorno nel formato 24 ore. Deve essere maggiore o uguale a 0 e in genere deve essere minore o uguale a 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura di un'attività.
minutes

integer

Minuti di un'ora. Deve essere maggiore o uguale a 0 e minore o uguale a 59.
seconds

integer

Secondi di un minuto. Deve essere maggiore o uguale a 0 e in genere deve essere minore o uguale a 59. Un'API può consentire il valore 60 se consente i secondi intercalari.
nanos

integer

Frazioni di secondi, in nanosecondi. Deve essere maggiore o uguale a 0 e minore o uguale a 999.999.999.

SpecialHours

Rappresenta un insieme di periodi di tempo in cui l'orario di apertura di una sede è diverso dal normale orario di apertura.

Rappresentazione JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Campi
specialHourPeriods[]

object (SpecialHourPeriod)

Obbligatorio. Un elenco di eccezioni all'orario di apertura regolare 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 orario 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 alla startDate specificata. 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 (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Campi
startDate

object (Date)

Obbligatorio. La data di calendario in cui inizia questo periodo di orario speciale.
openTime

object (TimeOfDay)

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 è false.
endDate

object (Date)

Facoltativo. La data di calendario in cui termina questo periodo di orario speciale. Se il campo endDate non è impostato, il valore predefinito è la data specificata in startDate. Se impostato, questo campo deve essere uguale o al massimo un giorno successivo a startDate.
closeTime

object (TimeOfDay)

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 è false.
closed

boolean

Facoltativo. Se true, endDate, openTime e closeTime vengono ignorati e la data specificata in startDate viene considerata come il giorno di chiusura della sede.

Data

Rappresenta una data di calendario completa 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 elementi:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • Un mese e un giorno, con un anno zero (ad esempio, un anniversario).
  • Un anno da solo, con un mese pari a zero e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e 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 il loro servizio presso la sede del cliente (ad esempio, un fabbro o un idraulico).

Rappresentazione JSON 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Campi
businessType

enum (BusinessType)

Obbligatorio. Indica il [tipo] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] dell'attività al domicilio del cliente.
places

object (Places)

Facoltativo. L'area servita da questa attività, definita tramite un insieme di luoghi.
regionCode

string

Immutabile. Codice regione CLDR del paese o dell'area geografica in cui ha sede l'attività al domicilio del cliente. Per maggiori dettagli, consulta 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 delle aree coperte da questa attività (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 il suo rappresentante autorizzato deve essere in grado di ricevere posta all'indirizzo di verifica fornito.

BusinessType

Indica se l'attività offre servizi solo in loco presso la sede di un cliente (ad esempio, un carro attrezzi) o sia presso un indirizzo che in loco (ad esempio, una pizzeria con un'area per la consumazione che effettua anche consegne ai clienti).

Enum
BUSINESS_TYPE_UNSPECIFIED Solo output. Non specificato.
CUSTOMER_LOCATION_ONLY Offre servizi 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 sede 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.

Places

Definisce l'unione delle aree rappresentate da un insieme di luoghi.

Rappresentazione JSON 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Campi
placeInfos[]

object (PlaceInfo)

Facoltativo. Le aree rappresentate dagli ID luogo. Limitato a un massimo di 20 luoghi.

PlaceInfo

Definisce un'area rappresentata da un ID luogo.

Rappresentazione JSON 
{
  "placeName": string,
  "placeId": string
}
Campi
placeName

string

Obbligatorio. Il nome localizzato del luogo. Ad esempio, Scottsdale, AZ.
placeId

string

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

string

Obbligatorio. Un numero di telefono alternativo da visualizzare nelle estensioni di località di AdWords al posto del numero di telefono principale della sede.

LatLng

Un oggetto che rappresenta una coppia di latitudine/longitudine. Questo valore è espresso come una coppia di valori double che rappresentano i gradi di latitudine e longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono rientrare negli intervalli normalizzati.

Rappresentazione JSON 
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0].
longitude

number

La 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 (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Campi
status

enum (OpenForBusiness)

Obbligatorio. Indica se la sede è attualmente aperta o meno. Per impostazione predefinita, tutte le sedi sono aperte, a meno che non vengano aggiornate come chiuse.
canReopen

boolean

Solo output. Indica se questa attività è idonea alla riapertura.
openingDate

object (Date)

Facoltativo. La data della prima apertura della sede. Se non si conosce il giorno esatto, è possibile fornire solo il mese e l'anno. La data deve essere nel passato o non più di un anno nel futuro.

OpenForBusiness

Indica lo stato di una sede.

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

Informazioni aggiuntive 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,
  "isParticularlyPersonalPlace": boolean
}
Campi
hasGoogleUpdated

boolean

Solo output. Indica se l'ID luogo associato a questa località presenta aggiornamenti che devono essere aggiornati o rifiutati dal client. Se questo valore booleano è impostato, devi chiamare il metodo getGoogleUpdated per cercare le informazioni da verificare.
hasPendingEdits

boolean

Solo output. Indica se una delle proprietà di questa località è in stato di modifica in attesa.
canDelete

boolean

Solo output. Indica se la località può essere eliminata utilizzando l'API.
canOperateLocalPost
(deprecated)

boolean

Solo output. Deprecato: questo campo non viene più compilato e verrà rimosso in una versione futura.
canModifyServiceList

boolean

Solo output. Indica se la scheda può modificare l'elenco dei servizi.
canHaveFoodMenus

boolean

Solo output. Indica se la scheda è idonea per il menu.
canOperateHealthData

boolean

Solo output. Indica se la località può operare sui dati sulla salute.
canOperateLodgingData

boolean

Solo output. Indica se la località può operare sui dati degli alloggi.
placeId

string

Solo output. Se questa località viene visualizzata su Google Maps, questo campo viene compilato con l'ID luogo della località. Questo ID può essere utilizzato in varie API Places.

Questo campo può essere impostato durante le chiamate Create, ma non per Update.
duplicateLocation

string

Solo output. La risorsa della sede duplicata da questa sede.
mapsUri

string

Solo output. Un link alla posizione su Maps.
newReviewUri

string

Solo output. Un link alla pagina della Ricerca Google in cui un cliente può lasciare una recensione per la sede.
canHaveBusinessCalls

boolean

Solo output. Indica se la scheda è idonea per le chiamate aziendali.
hasVoiceOfMerchant

boolean

Solo output. Indica se la scheda ha la funzionalità Voce del commerciante. Se questo valore booleano è false, devi chiamare l'API locations.getVoiceOfMerchantState per ottenere dettagli sul motivo per cui non dispone di Voice of Merchant.
isParticularlyPersonalPlace

boolean

Solo output. Indica se la posizione è classificata come luogo molto personale. Ciò significa che esistono limitazioni alle funzionalità della Cronologia delle posizioni. Se ritieni che si tratti di un errore, consulta l'articolo del Centro assistenza.

Profilo

Tutte le informazioni relative al profilo della sede.

Rappresentazione JSON 
{
  "description": string
}
Campi
description

string

Obbligatorio. Descrizione della località con la tua voce, non modificabile da nessun altro.

RelationshipData

Informazioni su tutte le sedi principali e secondarie correlate a questa.

Rappresentazione JSON 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Campi
parentLocation

object (RelevantLocation)

Facoltativo. La località principale con cui questa località ha relazioni.
childrenLocations[]

object (RelevantLocation)

Facoltativo. L'elenco delle località secondarie con cui questa località ha relazioni.
parentChain

string

Facoltativo. Il nome della risorsa della catena di cui fa parte questa sede. [How to find Chain ID] [Locations.SearchChains]

RelevantLocation

Informazioni su un'altra località correlata a quella corrente. La relazione può essere DEPARTMENT_OF o INDEPENDENT_ESTABLISHMENT_OF e la sede specificata qui può trovarsi su entrambi i lati (principale/secondaria) della sede.

Rappresentazione JSON 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
Campi
placeId

string

Obbligatorio. Specifica la località che si trova sull'altro lato della relazione in base al relativo ID luogo.
relationType

enum (RelationType)

Obbligatorio. Il tipo di relazione.

RelationType

Le relazioni di tipo da specificare.

Enum
RELATION_TYPE_UNSPECIFIED Tipo non specificato.
DEPARTMENT_OF Rappresenta una relazione tra due sedi che condividono un'area fisica, lo stesso brand/la stessa dirigenza/la stessa organizzazione, ma con attributi chiave diversi, come l'orario di apertura o i numeri di telefono. Ad esempio, Costco Pharmacy è un reparto di Costco Wholesale.
INDEPENDENT_ESTABLISHMENT_IN Questo rappresenta i casi in cui due sedi si trovano nella stessa posizione fisica, ma appartengono ad aziende diverse (ad es. Starbucks in un Safeway, 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 (TimePeriod)
    }
  ]
}
Campi
hoursTypeId

string

Obbligatorio. Tipo di orario. I client devono chiamare {#link businessCategories:BatchGet} per ottenere i tipi di orari supportati per le categorie delle loro sedi.
periods[]

object (TimePeriod)

Obbligatorio. Una raccolta di orari in cui questa sede è aperta. 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. 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 (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
Campi
price

object (Money)

Facoltativo. Rappresenta il prezzo monetario dell'elemento di servizio. Ti consigliamo di impostare currencyCode e units quando includi un prezzo. Questo verrà considerato come un prezzo fisso per l'elemento di servizio.
Deve essere sempre impostato uno dei seguenti campi. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
structuredServiceItem

object (StructuredServiceItem)

Facoltativo. Questo campo verrà impostato nel caso di dati strutturati dei servizi.
freeFormServiceItem

object (FreeFormServiceItem)

Facoltativo. Questo campo verrà impostato in caso di dati dei servizi in formato libero.
Fine dei campi che si escludono a vicenda.

StructuredServiceItem

Rappresenta un servizio strutturato offerto dal commerciante. Ad esempio: toilet_installation.

Rappresentazione JSON 
{
  "serviceTypeId": string,
  "description": string
}
Campi
serviceTypeId

string

Obbligatorio. Il campo serviceTypeId è un ID univoco fornito da Google che si trova in ServiceType. Queste informazioni sono fornite dal servizio RPC categories.batchGet.
description

string

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 vengono esposti come parte dei nostri dati di servizio della struttura. Il commerciante inserisce manualmente i nomi di questi servizi utilizzando una piattaforma geomerchant.

Rappresentazione JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
Campi
category

string

Obbligatorio. Questo campo rappresenta il nome della categoria (ovvero l'ID stabile della categoria). category e serviceTypeId devono corrispondere alle possibili combinazioni fornite nel messaggio Category.
label

object (Label)

Obbligatorio. Etichette con tag di lingua per l'elemento. Ti consigliamo di utilizzare nomi degli elementi di massimo 140 caratteri e descrizioni di massimo 250 caratteri. Questo campo deve essere impostato solo se l'input è un elemento di servizio personalizzato. I tipi di servizi standardizzati devono essere aggiornati utilizzando serviceTypeId.

Etichetta

Etichetta da utilizzare per la visualizzazione del listino prezzi, della sezione o dell'articolo.

Rappresentazione JSON 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
Campi
displayName

string

Obbligatorio. Nome visualizzato del listino prezzi, della sezione o dell'elemento.
description

string

Facoltativo. Descrizione del listino prezzi, della sezione o dell'articolo.
languageCode

string

Facoltativo. Il codice lingua BCP-47 a cui si applicano queste stringhe. È possibile impostare un solo insieme di etichette per lingua.

Denaro

Rappresenta un importo in denaro con il relativo tipo di valuta.

Rappresentazione JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campi
currencyCode

string

Il codice valuta di tre lettere definito nello standard ISO 4217.
units

string (int64 format)

Le unità intere dell'importo. Ad esempio, se currencyCode è "USD", 1 unità corrisponde a un dollaro statunitense.
nanos

integer

Numero di unità nano (10^-9) dell'importo. Il valore deve essere compreso tra -999.999.999 e +999.999.999 inclusi. Se units è positivo, nanos deve essere positivo o zero. Se units è pari a zero, nanos può essere positivo, pari a zero o negativo. Se units è negativo, nanos deve essere negativo o uguale a zero. Ad esempio, -1,75 $ è rappresentato come units=-1 e nanos=-750.000.000.

Metodi

create

 Crea una nuova sede di proprietà dell'utente che ha eseguito l'accesso.

list

 Elenca le località per l'account specificato.