REST Resource: accounts.locations

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,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
Campi
name

string

Identificatore Google per questa località nel formato: accounts/{accountId}/locations/{locationId}

Nel contesto delle corrispondenze, questo campo non verrà compilato.
languageCode

string

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

string

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.
locationName

string

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, Address, Categories). Non aggiungere informazioni non necessarie al nome, ad esempio preferisci "Google" rispetto a "Google Inc. - Sede aziendale Mountain View". Non includere slogan di marketing, codici negozio, caratteri speciali, orari o stato di chiusura/apertura, numeri di telefono, URL di siti web, informazioni su servizi e prodotti, posizione/indirizzo o indicazioni stradali o informazioni sul contenimento (ad es. "Bancomat Chase a Duane Reade").
primaryPhone

string

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[]

string

Fino a due numeri di telefono (cellulare o fisso, nessun fax) ai quali è possibile chiamare l'attività, oltre al numero di telefono principale.
address

object (PostalAddress)

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 addressLines nell'indirizzo.
primaryCategory

object (Category)

Categoria che descrive meglio l'attività principale di questa sede.
additionalCategories[]

object (Category)

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.
websiteUrl

string

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

object (BusinessHours)

Orario di apertura dell'attività.
specialHours

object (SpecialHours)

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.
serviceArea

object (ServiceAreaBusiness)

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à.
locationKey

object (LocationKey)

Un insieme di chiavi che collegano questa attività ad altre proprietà di Google, come una pagina Google+ e Google Maps Places.
labels[]

string

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. Massimo 255 caratteri (per etichetta).
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Informazioni aggiuntive visualizzate in AdWords.
latlng

object (LatLng)

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 latlng fornito dall'utente è stato accettato durante la creazione o se il valore latlng è stato aggiornato tramite il sito web di Profilo dell'attività. Questo campo non può essere aggiornato.
openInfo

object (OpenInfo)

Una bandiera che indica se la sede è attualmente aperta.
locationState

object (LocationState)

Solo output. Un insieme di valori booleani che riflette lo stato di una località.
attributes[]

object (Attribute)

Attributi per questa località.
metadata

object (Metadata)

Solo output. Informazioni aggiuntive non modificabili dall'utente.
priceLists[]
(deprecated)

object (PriceList)

Obsoleto: informazioni sul listino prezzi per questa località.
profile

object (Profile)

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.
relationshipData

object (RelationshipData)

Tutte le sedi e le catene correlate a questo.
moreHours[]

object (MoreHours)

Più orari per i diversi reparti o per clienti specifici di un'attività.

BusinessHours

Rappresenta i periodi di tempo in cui questa sede è aperta al pubblico. Contiene una raccolta di TimePeriod istanze.

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

object (TimePeriod)

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 (DayOfWeek),
  "openTime": string,
  "closeDay": enum (DayOfWeek),
  "closeTime": string
}
Campi
openDay

enum (DayOfWeek)

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

string

Tempo in 24 ore in formato ISO 8601 esteso (hh:mm). I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato.
closeDay

enum (DayOfWeek)

Indica il day of the week il giorno di fine di questo periodo.
closeTime

string

Tempo in 24 ore in formato ISO 8601 esteso (hh:mm). 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

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 (SpecialHourPeriod)
    }
  ]
}
Campi
specialHourPeriods[]

object (SpecialHourPeriod)

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 (Date)
  },
  "openTime": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
Campi
startDate

object (Date)

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

string

Il tempo totale di intermittenza su startDate quando viene aperta una sede, espresso in formato esteso ISO 8601 in 24 ore. (hh:mm) 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 isClosed è false.
endDate

object (Date)

La data di calendario in cui termina questo periodo di ora speciale. Se il campo endDate non è impostato, viene impostata la data predefinita in startDate. Se impostato, questo campo deve essere uguale o al massimo 1 giorno dopo startDate.
closeTime

string

Il tempo di transito in endDate alla chiusura di una sede, espresso in formato esteso ISO 8601 in 24 ore. (hh:mm) 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 isClosed è false.
isClosed

boolean

Se il valore è true, endDate, openTime e closeTime vengono ignorati e la data specificata in startDate viene considerata come la sede chiusa per l'intera giornata.

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 (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
Campi
businessType

enum (BusinessType)

Indica l'entità type dell'attività al domicilio del cliente.
Campo di unione coverageArea. Indica l'area di copertura in cui l'attività offre servizi. coverageArea può essere solo uno dei seguenti:
radius

object (PointRadius)

Solo output. L'area servita da questa attività intorno a un punto.
places

object (Places)

L'area servita da questa attività è definita da un insieme di luoghi.

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à).
CUSTOMER_AND_BUSINESS_LOCATION Offre il servizio presso l'indirizzo dell'attività e nell'area circostante.

PointRadius

Un raggio intorno a un punto specifico (latitudine/longitudine).

Rappresentazione JSON 
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
Campi
latlng

object (LatLng)

La latitudine/longitudine che specifica il centro di un'area definita dal raggio.
radiusKm

number

La distanza in chilometri dell'area intorno al punto.

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

number

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

number

Longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0].

Luoghi

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

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

object (PlaceInfo)

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 
{
  "name": string,
  "placeId": string
}
Campi
name

string

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

string

L'ID del luogo. Deve corrispondere a una regione.

LocationKey

Riferimenti chiave alternativi/surrogati per una località.

Rappresentazione JSON 
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
Campi
plusPageId

string

Solo output. Se alla sede è associata una pagina Google+, viene inserito l'ID della pagina Google+ della sede.
placeId

string

Se la sede è stata verificata ed è collegata a/visualizzata su Google Maps, questo campo viene compilato con l'ID luogo della sede. Questo ID può essere utilizzato in varie API Places.

Se questa sede non è verificata, questo campo potrebbe essere compilato se la sede è stata associata a un luogo visualizzato su Google Maps.

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

Il bool explicitNoPlaceId aggiuntivo consente di verificare se un ID luogo non impostato è intenzionale o meno.
explicitNoPlaceId

boolean

Solo output. Il valore true indica che un ID luogo non impostato è intenzionale, diverso da nessuna associazione ancora creata.
requestId

string

Solo output. requestId utilizzato per creare questa sede. Può essere vuoto se questa sede è stata creata al di fuori dell'API Google My Business o di Sedi di Profilo dell'attività.

AdWordsLocationExtensions

Informazioni aggiuntive visualizzate in AdWords.

Rappresentazione JSON 
{
  "adPhone": string
}
Campi
adPhone

string

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

OpenInfo

Informazioni relative allo stato di apertura dell'attività.

Rappresentazione JSON 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Campi
status

enum (OpenForBusiness)

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

boolean

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

object (Date)

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. Questo valore può essere applicato solo alle località pubblicate (ad es. locationState.is_published = true). Quando il campo di stato viene aggiornato su questo valore, i client devono impostare esplicitamente updateMask su openInfo.status. Durante questa chiamata di aggiornamento non è possibile impostare altre maschere di aggiornamento. Si tratta di una limitazione temporanea che verrà allentata a breve.

LocationState

Contiene un insieme di valori booleani che riflettono lo stato di una località.

Rappresentazione JSON 
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
Campi
isGoogleUpdated

boolean

Solo output. Indica se l'ID luogo associato a questa sede ha degli aggiornamenti.
isDuplicate

boolean

Solo output. Indica se la sede è un duplicato.
isSuspended

boolean

Solo output. Indica se la sede è sospesa. Le sedi sospese non sono visibili agli utenti finali nei prodotti Google. Se ritieni che si sia trattato di un errore, consulta questo articolo del Centro assistenza.
canUpdate

boolean

Solo output. Indica se è possibile aggiornare la posizione.
canDelete

boolean

Solo output. Indica se la sede può essere eliminata utilizzando l'API Google My Business.
isVerified

boolean

Solo output. Indica se la sede è stata verificata.
needsReverification

boolean

Solo output. Indica se la sede deve essere nuovamente verificata.
isPendingReview

boolean

Solo output. Indica se la revisione della sede è in attesa.
isDisabled

boolean

Solo output. Indica se la posizione è disattivata.
isPublished

boolean

Solo output. Indica se la località è stata pubblicata.
isDisconnected

boolean

Solo output. Indica se la posizione è disconnessa da un luogo su Google Maps.
isLocalPostApiDisabled

boolean

Solo output. Indica se accounts.locations.localPosts è disattivato per questa località.
canModifyServiceList

boolean

Solo output. Indica se la scheda può modificare un ServiceList.
canHaveFoodMenus

boolean

Solo output. Indica se la scheda è idonea per il menu del cibo.
hasPendingEdits

boolean

Solo output. Indica se le proprietà di questa località sono in stato di modifica in attesa.
hasPendingVerification

boolean

Solo output. Indica se la sede ha richieste di verifica in attesa.
canOperateHealthData

boolean

Solo output. Indica se la posizione può operare sui dati sanitari.
canOperateLodgingData

boolean

Solo output. Indica se la posizione può operare sui dati dell'alloggio.

Attributo

Un attributo località. Gli attributi forniscono informazioni aggiuntive su una località. Gli attributi che è possibile impostare per una località possono variare in base alle proprietà della località (ad esempio, categoria). Gli attributi disponibili sono determinati da Google e possono essere aggiunti e rimossi senza modifiche all'API.

Rappresentazione JSON 
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
Campi
attributeId

string

L'ID dell'attributo. Gli ID attributo sono forniti da Google.
valueType

enum (AttributeValueType)

Solo output. Il tipo di valore contenuto in questo attributo. Questo dovrebbe essere utilizzato per determinare come interpretare il valore.
values[]

value (Value format)

I valori per questo attributo. Il tipo dei valori forniti deve corrispondere a quello previsto per l'attributo in questione; consulta AttributeValueType. Si tratta di un campo ripetuto in cui possono essere forniti più valori per gli attributi. I tipi di attributo supportano un solo valore.
repeatedEnumValue

object (RepeatedEnumAttributeValue)

Quando il tipo di valore dell'attributo è REPEATED_ENUM, contiene il valore dell'attributo, mentre gli altri campi devono essere vuoti.
urlValues[]

object (UrlAttributeValue)

Quando il tipo di valore dell'attributo è URL, questo campo contiene i valori per questo attributo e gli altri campi devono essere vuoti.

RepeatedEnumAttributeValue

Valori per un attributo con valueType pari a REPEATED_ENUM. Comprende due elenchi di ID valore: quelli impostati (true) e quelli non impostati (false). I valori assenti sono considerati sconosciuti. È necessario specificare almeno un valore.

Rappresentazione JSON 
{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}
Campi
setValues[]

string

Enumera i valori impostati.
unsetValues[]

string

Enumera i valori che non sono stati impostati.

UrlAttributeValue

Valori per un attributo con valueType di URL.

Rappresentazione JSON 
{
  "url": string
}
Campi
url

string

L'URL.

Metadati

Ulteriori informazioni sulla sede non modificabili dall'utente.

Rappresentazione JSON 
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
Campi
duplicate
(deprecated)

object (Duplicate)

Informazioni sulla località duplicata da questa sede. Presente solo quando locationState.is_duplicate è true. Obsoleto: non supportiamo più le informazioni dettagliate per i duplicati.
mapsUrl

string

Un link alla località su Maps.
newReviewUrl

string

Un link alla pagina nella Ricerca Google in cui un cliente può lasciare una recensione per la sede.

Duplica

Informazioni sulla località duplicata da questa sede.

Rappresentazione JSON 
{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}
Campi
locationName

string

Il nome della risorsa della località duplicata. Compilato solo se l'utente autenticato dispone dei diritti di accesso a quella località e quella località non viene eliminata.
placeId

string

L'ID della località duplicata.
access

enum (Access)

Indica se l'utente ha accesso alla posizione che duplica.

Accesso

Il livello di accesso dell'utente alla località che duplica. Questa opzione sostituisce Proprietà e deve essere utilizzata.

Enum
ACCESS_UNSPECIFIED Non specificato.
ACCESS_UNKNOWN Impossibile determinare se l'utente ha accesso alla sede che duplica.
ALLOWED L'utente ha accesso alla posizione che duplica.
INSUFFICIENT L'utente non ha accesso alla posizione duplicata.

PriceList

Obsoleta: un elenco di informazioni sui prezzi degli articoli. I listini prezzi sono strutturati come uno o più listini, ciascuno contenente una o più sezioni con uno o più articoli. Ad esempio, i listini prezzi dei prodotti alimentari possono rappresentare menu per colazione, pranzo e cena, con sezioni dedicate a hamburger, bistecche e frutti di mare.

Rappresentazione JSON 
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
Campi
priceListId

string

Obbligatorio. ID per il listino prezzi. Il listino prezzi, gli ID delle sezioni e degli articoli non possono essere duplicati all'interno di questa località.
labels[]

object (Label)

Obbligatorio. Etichette con tagging della lingua per il listino prezzi.
sourceUrl

string

URL di origine facoltativo della pagina da cui è stato recuperato il listino prezzi. Potrebbe essere, ad esempio, l'URL della pagina di cui è stato eseguito lo scraping automatico per compilare le informazioni del menu.
sections[]

object (Section)

Obbligatorio. Sezioni di questo listino prezzi. Ogni listino prezzi deve contenere almeno una sezione.

Etichetta

Etichetta da utilizzare quando visualizzi il listino prezzi, la sezione o l'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

Campo facoltativo. Descrizione del listino prezzi, della sezione o dell'elemento.
languageCode

string

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

Sezione

Una sezione del listino prezzi contenente uno o più articoli.

Rappresentazione JSON 
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
Campi
sectionId

string

Obbligatorio. ID della sezione. Il listino prezzi, gli ID delle sezioni e degli articoli non possono essere duplicati all'interno di questa località.
labels[]

object (Label)

Obbligatorio. Etichette della sezione con tag lingua. Consigliamo di non superare i 140 caratteri per i nomi e le descrizioni delle sezioni. È richiesto almeno un set di etichette.
sectionType

enum (SectionType)

Campo facoltativo. Tipo della sezione del listino prezzi corrente. Il valore predefinito è FOOD.
items[]

object (Item)

Articoli contenuti in questa sezione del listino prezzi.

SectionType

Tipo di sezione.

Enum
SECTION_TYPE_UNSPECIFIED Non specificato.
FOOD La sezione contiene elementi che rappresentano alimenti.
SERVICES La sezione contiene elementi che rappresentano i servizi.

Articolo

Una singola voce dell'elenco. Ogni variante di un articolo nel listino prezzi deve avere il proprio articolo con i propri dati sui prezzi.

Rappresentazione JSON 
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
Campi
itemId

string

Obbligatorio. ID dell'articolo. Il listino prezzi, gli ID delle sezioni e degli articoli non possono essere duplicati all'interno di questa località.
labels[]

object (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. È richiesto almeno un set di etichette.
price

object (Money)

Campo facoltativo. Prezzo dell'articolo.

Valuta

Rappresenta un importo di 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)

L'intera unità dell'importo. Ad esempio, se currencyCode è "USD", 1 unità equivale a un dollaro statunitense.
nanos

integer

Numero di nano (10^-9) unità della quantità. 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 è zero, nanos può essere positivo, zero o negativo. Se units è negativo, nanos deve essere negativo o pari a zero. Ad esempio,$ -1,75 è rappresentato come units=-1 e nanos=-750.000.000.

Profilo

Tutte le informazioni relative al profilo della sede.

Rappresentazione JSON 
{
  "description": string
}
Campi
description

string

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 
{
  "parentChain": string
}
Campi
parentChain

string

Il nome della risorsa della catena di cui fa parte questa sede. How to find Chain ID

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 orari. I clienti devono chiamare {#link businessCategories:BatchGet} per conoscere i tipi di orari supportati per le categorie delle loro sedi.
periods[]

object (TimePeriod)

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.

Metodi

associate

 Associa una località a un ID luogo.

batchGet

 Consente di acquisire tutte le località specificate nell'account in questione.

batchGetReviews

 Restituisce l'elenco impaginato delle recensioni di tutte le località specificate.

clearAssociation

 Consente di cancellare un'associazione tra una località e il relativo ID luogo.

create

 Crea un nuovo location di proprietà dell'account specificato e lo restituisce.

delete

 Elimina una posizione.

fetchVerificationOptions

 Segnala tutte le opzioni di verifica idonee per una sede in una lingua specifica.

findMatches

 Trova tutte le possibili località che corrispondono alla località specificata.

get

 Restituisce la località specificata.

getFoodMenus

 Restituisce i menu degli alimenti di una località specifica.

getGoogleUpdated

 Visualizza la versione aggiornata da Google della località specificata.

getHealthProviderAttributes

 Restituisce gli attributi del fornitore di servizi sanitari di una località specifica.

getServiceList

 Recupera l'elenco di servizi specificato di una località.

list

 Elenca le sedi dell'account specificato.

patch

 Aggiorna la località specificata.

reportInsights

 Restituisce un report contenente approfondimenti su una o più metriche in base alla località.

transfer
(deprecated)

 Sposta una sede da un account di proprietà dell'utente a un altro account gestito dallo stesso utente.

updateFoodMenus

 Aggiorna i menu degli alimenti di un luogo specifico.

updateHealthProviderAttributes

 Consente di aggiornare gli attributi del fornitore di servizi sanitari di una località specifica.

updateServiceList

 Aggiorna l'elenco di servizi specificato per una località.

verify

 Avvia la procedura di verifica di una sede.