REST Resource: 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,
  "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 Google per questa sede nel formato: locations/{locationId}.
languageCode

string

Immutabile. La lingua del luogo. 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. Consente di associare la sede ai tuoi record.
title

string

Obbligatorio. Il nome della sede deve rispecchiare il nome reale della tua attività, utilizzato in modo coerente sul negozio fisico, sul sito web e sulla cancelleria e come noto ai clienti. Eventuali informazioni aggiuntive, se pertinenti, possono essere incluse in altri campi della risorsa (ad esempio 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").
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 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. Questo campo deve essere impostato solo per le attività che dispongono di un negozio fisico. Questo campo non deve essere impostato per le località di tipo CUSTOMER_LOCATION_ONLY. Se impostato, qualsiasi valore fornito verrà ignorato.
websiteUri

string

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

object (BusinessHours)

(Facoltativo) Orario di apertura dell'attività.
specialHours

object (SpecialHours)

(Facoltativo) Orari speciali per l'attività. Ciò include in genere l'orario festivo e altri orari al di fuori del normale orario di apertura. Queste modifiche sostituiscono il normale orario di apertura. Questo campo non può essere impostato senza gli orari normali.
serviceArea

object (ServiceAreaBusiness)

(Facoltativo) Le attività al domicilio del cliente forniscono il proprio servizio presso la sede del cliente. Se questa attività è un'attività al domicilio del cliente, questo campo descrive l'area o le aree servite dall'attività.
labels[]

string

(Facoltativo) Una raccolta di stringhe in formato libero che ti consente di taggare la tua attività. Queste etichette NON sono rivolte agli utenti; solo tu puoi vederle. Deve avere una lunghezza compresa tra 1 e 255 caratteri per etichetta.
adWordsLocationExtensions

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 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à su Google. Questo campo può essere aggiornato solo da 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 il tuo stile e condivide con gli utenti la storia unica della tua attività e delle tue offerte.

Questo campo è obbligatorio per tutte le categorie tranne che per le categorie di alloggio (ad es. hotel, motel, locande).
relationshipData

object (RelationshipData)

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

object (MoreHours)

(Facoltativo) Altri orari per i diversi reparti o per 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 scaldabagni e così via. Gli articoli di servizio duplicati verranno rimossi automaticamente.

Metodi

delete

 Elimina una località.

get

 Restituisce la località specificata.

getAttributes

 Cerca tutti gli attributi impostati per una determinata località.

getGoogleUpdated

 Recupera la versione aggiornata da Google della località specificata.

patch

 Aggiorna la località specificata.

updateAttributes

 Aggiornare gli attributi per una determinata località.