REST Resource: 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.

Metodi

delete

 Elimina una località.

get

 Restituisce la località specificata come ultima impostata dal commerciante.

getAttributes

 Recupera gli attributi di una sede così come sono stati impostati l'ultima volta dal commerciante.

getGoogleUpdated

 Restituisce la sede specificata così come appare in tempo reale su Google Maps e nella Ricerca.

patch

 Aggiorna la località specificata.

updateAttributes

 Aggiorna gli attributi per una determinata sede.