REST Resource: accounts.locations

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,
  "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 di questa sede nel formato: accounts/{accountId}/locations/{locationId}

Questo campo non verrà compilato.
languageCode

string

La lingua del luogo. Impostato durante la creazione e non aggiornabile.
storeCode

string

Identificatore esterno per questa località, che deve essere univoco all'interno di un determinato account. Consente di associare la sede ai tuoi record.
locationName

string

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 Address, Categories). Non aggiungere al nome informazioni non necessarie (ad esempio, preferisci "Google" a "Google Inc. - Sede centrale dell'azienda 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/prodotti, posizione/indirizzo o indicazioni stradali oppure informazioni sul contenimento (ad es. "Bancomat Chase in 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.
additionalPhones[]

string

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

object (PostalAddress)

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

object (Category)

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

object (Category)

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

string

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

object (BusinessHours)

Orario di apertura dell'attività.
specialHours

object (SpecialHours)

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

object (ServiceAreaBusiness)

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

object (LocationKey)

Una raccolta di chiavi che collega 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 rivolte 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. 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 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)

Un flag 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 il tuo stile e condivide con gli utenti la storia unica della tua attività e delle tue offerte.
relationshipData

object (RelationshipData)

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

object (MoreHours)

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

BusinessHours

Rappresenta i periodi di tempo in cui questa sede è aperta alle attività. Contiene una raccolta di TimePeriod istanze.

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

object (TimePeriod)

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

enum (DayOfWeek)

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

string

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

enum (DayOfWeek)

Indica il valore day of the week in cui termina il periodo.
closeTime

string

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

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

object (SpecialHourPeriod)

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

object (Date)

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

string

Il tempo effettivo su startDate all'apertura di una sede, espresso nel formato esteso ISO 8601 di 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 è falso.
endDate

object (Date)

La data di calendario di questo periodo di un'ora speciale. Se il campo endDate non viene configurato, il valore predefinito è la data specificata in startDate. Se impostato, questo campo deve essere uguale o al massimo 1 giorno dopo startDate.
closeTime

string

Il tempo totale di esecuzione su endDate alla chiusura di una sede, espresso nel formato esteso ISO 8601 di 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 è falso.
isClosed

boolean

Se 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 il proprio servizio presso la sede del cliente, ad esempio 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 il type dell'attività al domicilio del cliente.
Campo unione coverageArea. Indica l'area di copertura in cui l'attività offre il servizio. coverageArea può essere solo uno dei seguenti:
radius

object (PointRadius)

Solo output. L'area servita dall'attività commerciale intorno a un punto.
places

object (Places)

L'area servita da questa attività definita mediante una serie di luoghi.

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).
CUSTOMER_AND_BUSINESS_LOCATION Offre il servizio presso l'indirizzo dell'attività e nella zona 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 attorno al punto.

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

number

La 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 delle aree rappresentate da un insieme di luoghi.

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

object (PlaceInfo)

Le aree rappresentate dagli ID luogo. È consentito 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 in questione.
placeId

string

Se questa sede è stata verificata ed è collegata o 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 Crea, ma non per Update.

Il bool explicitNoPlaceId aggiuntivo è idoneo indipendentemente dal fatto che un ID luogo non impostato sia intenzionale o meno.
explicitNoPlaceId

boolean

Solo output. Il valore true indica che l'ID luogo non impostato è intenzionale, diversamente da quando non è stata ancora effettuata alcuna associazione.
requestId

string

Solo output. requestId utilizzato per creare questa sede. Il campo potrebbe essere vuoto se questa sede è stata creata al di fuori dell'API Google My Business o delle sedi in 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à AdWords anziché il numero di telefono principale della sede.

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 alla riapertura.
openingDate

object (Date)

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. Questo valore può essere applicato solo alle località pubblicate (ad es. locationState.is_publish = true). Quando il campo dello stato viene aggiornato impostandolo su questo valore, i clienti devono impostare updateMask in modo esplicito su openInfo.status. Durante la 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 località è aggiornato.
isDuplicate

boolean

Solo output. Indica se la sede è un duplicato di un'altra.
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 l'articolo del Centro assistenza.
canUpdate

boolean

Solo output. Indica se la posizione può essere aggiornata.
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 è verificata.
needsReverification

boolean

Solo output. Indica se la sede richiede una nuova verifica.
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à è pubblicata.
isDisconnected

boolean

Solo output. Indica se la sede è scollegata da un luogo su Google Maps.
isLocalPostApiDisabled

boolean

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

boolean

Solo output. Indica se l'elenco può modificare un ServiceList.
canHaveFoodMenus

boolean

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

boolean

Solo output. Indica se una delle proprietà di questa località è 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 località può operare su dati sanitari.
canOperateLodgingData

boolean

Solo output. Indica se la località può utilizzare i dati delle strutture ricettive.

Attributo

Un attributo località. Gli attributi forniscono informazioni aggiuntive su una località. Gli attributi che è possibile impostare su una località possono variare in base alle proprietà di questa 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 degli attributi sono forniti da Google.
valueType

enum (AttributeValueType)

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

value (Value format)

I valori di 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 di 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 e gli altri campi dei valori devono essere vuoti.
urlValues[]

object (UrlAttributeValue)

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

RepeatedEnumAttributeValue

Valori per un attributo con valueType di REPEATED_ENUM. È costituito da 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

Valori enum impostati.
unsetValues[]

string

Valori enum non impostati.

UrlAttributeValue

Valori per un attributo con un valueType di URL.

Rappresentazione JSON 
{
  "url": string
}
Campi
url

string

L'URL.

Metadati

Ulteriori informazioni sulla località non modificabili dall'utente.

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

object (Duplicate)

Informazioni sulla sede duplicata da questa sede. Presente solo quando locationState.is_duplicate è true. Obsoleta: le informazioni dettagliate per i duplicati non sono più supportate.
mapsUrl

string

Un link alla posizione 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 sede 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 questa non viene eliminata.
placeId

string

L'ID della località duplicata.
access

enum (Access)

Indica se l'utente ha accesso alla posizione in cui viene duplicato.

Accesso

Il livello di accesso dell'utente alla località duplicata. Sostituisci Proprietà e deve essere utilizzata.

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

PriceList

Obsoleto: un elenco di informazioni sui prezzi degli articoli. I listini prezzi sono strutturati come uno o più listini prezzi, ciascuno contenente una o più sezioni con uno o più articoli. Ad esempio, i listini prezzi dei cibi possono rappresentare menu per colazione/pranzo/cena, con sezioni per hamburger/bistecca/pesce.

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

string

Obbligatorio. ID del listino prezzi. Gli ID listino prezzi, sezione e articolo non possono essere duplicati all'interno di questa località.
labels[]

object (Label)

Obbligatorio. Etichette con tag di lingua per il listino prezzi.
sourceUrl

string

URL di origine facoltativo della fonte da cui è stato recuperato il listino prezzi. Ad esempio, potrebbe trattarsi dell'URL della pagina di cui è stata eseguita automaticamente lo scraping 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 durante 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'articolo.
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 set 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. Gli ID listino prezzi, sezione e articolo non possono essere duplicati all'interno di questa località.
labels[]

object (Label)

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

enum (SectionType)

(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 il cibo.
SERVICES La sezione contiene elementi che rappresentano i servizi.

Elemento

Un singolo elemento dell'elenco. Ogni variante di un articolo nel listino prezzi deve avere un proprio articolo con i relativi dati sui prezzi.

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

string

Obbligatorio. ID dell'articolo. Gli ID listino prezzi, sezione e articolo non possono essere duplicati all'interno di questa località.
labels[]

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

object (Money)

(Facoltativo) Prezzo dell'articolo.

Denaro

Rappresenta un importo di denaro con il tipo di valuta.

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

string

Il codice valuta di tre lettere definito in ISO 4217.
units

string (int64 format)

Le unità intere 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 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 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 
{
  "parentChain": string
}
Campi
parentChain

string

Il nome della risorsa della catena di cui fa parte questa località. 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 ottenere i tipi di orari supportati per le categorie delle loro sedi.
periods[]

object (TimePeriod)

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.

Metodi

associate

 Associa una località a un ID luogo.

batchGet

 Recupera tutte le località specificate nell'account specificato.

batchGetReviews

 Restituisce l'elenco impaginato delle recensioni per tutte le sedi specificate.

clearAssociation

 Cancella l'associazione tra una località e il relativo ID.

create

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

delete

 Elimina una località.

fetchVerificationOptions

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

findMatches

 Trova tutte le possibili località corrispondenti alla località specificata.

get

 Recupera la località specificata.

getFoodMenus

 Restituisce i menu dei cibi di una località specifica.

getGoogleUpdated

 Recupera 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 per una località.

list

 Elenca le località dell'account specificato.

patch

 Aggiorna la località specificata.

reportInsights

 Restituisce un report contenente approfondimenti su una o più metriche per località.

transfer
(deprecated)

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

updateFoodMenus

 Consente di aggiornare i menu dei cibi di una località specifica.

updateHealthProviderAttributes

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

updateServiceList

 Aggiorna l'elenco di servizi specificato di una posizione.

verify

 Avvia la procedura di verifica per una sede.