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

languageCode

string

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

storeCode

string

Campo facoltativo. 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.

title

string

Obbligatorio. 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").

phoneNumbers

object (PhoneNumbers)

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

categories

object (Categories)

Campo facoltativo. Le diverse categorie che descrivono l'attività.

storefrontAddress

object (PostalAddress)

Campo facoltativo. 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. 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 ma, se impostato, qualsiasi valore fornito verrà ignorato.

websiteUri

string

Campo facoltativo. 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)

Campo facoltativo. Orario di apertura dell'attività.

specialHours

object (SpecialHours)

Campo facoltativo. 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. Questo campo non può essere impostato senza gli orari normali.

serviceArea

object (ServiceAreaBusiness)

Campo facoltativo. 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à.

labels[]

string

Campo facoltativo. 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. Deve avere una lunghezza compresa tra 1 e 255 caratteri per etichetta.

adWordsLocationExtensions

object (AdWordsLocationExtensions)

Campo facoltativo. Informazioni aggiuntive visualizzate in AdWords.

latlng

object (LatLng)

Campo facoltativo. 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à su Google. Questo campo può essere aggiornato solo da clienti approvati.

openInfo

object (OpenInfo)

Campo facoltativo. Una bandiera che indica se la sede è attualmente aperta.

metadata

object (Metadata)

Solo output. Informazioni aggiuntive non modificabili dall'utente.

profile

object (Profile)

Campo facoltativo. 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.

Questo campo è obbligatorio per tutte le categorie, ad eccezione delle categorie di alloggio (ad es. hotel, motel, locande).

relationshipData

object (RelationshipData)

Campo facoltativo. Tutte le sedi e le catene correlate a questo.

moreHours[]

object (MoreHours)

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

serviceItems[]

object (ServiceItem)

Campo facoltativo. Elenco dei servizi supportati dai commercianti. Un servizio può essere un taglio di capelli, installare uno scaldabagno e così via. Gli elementi di servizio duplicati verranno rimossi automaticamente.

Metodi

delete

Elimina una posizione.

get

Restituisce la località specificata.

getAttributes

Cerca tutti gli attributi impostati per una determinata località.

getGoogleUpdated

Visualizza la versione aggiornata da Google della località specificata.

patch

Aggiorna la località specificata.

updateAttributes

Aggiorna gli attributi per una località specifica.