REST Resource: accounts.locations

{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}

string

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

string

(Facoltativo) 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.

{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}

object (Category)

Obbligatorio. Categoria che descrive meglio l'attività principale in cui opera questa sede.

object (Category)

(Facoltativo) 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.

{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}

string

Obbligatorio. Un ID fisso (fornito da Google) per questa categoria. Il valore deve essere specificato quando si modifica la categoria (durante la creazione o l'aggiornamento di una località).

string

Solo output. Il nome leggibile della categoria. Viene impostato durante la lettura della posizione. Quando modifichi la località, è necessario impostare category_id.

object (ServiceType)

Solo output. Un elenco di tutti i tipi di servizi disponibili per questa categoria dell'attività.

object (MoreHoursType)

Solo output. Altri tipi di orari disponibili per questa categoria dell'attività.

{
  "serviceTypeId": string,
  "displayName": string
}

string

Solo output. Un ID stabile (fornito da Google) per questo tipo di servizio.

string

Solo output. Il nome visualizzato leggibile per il tipo di servizio.

{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}

string

Solo output. Un ID stabile fornito da Google per questo tipo di orario.

string

Solo output. Il nome visualizzato in inglese leggibile per il tipo di orario.

string

Solo output. Il nome visualizzato localizzato leggibile per il tipo di orario.

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

La revisione dello schema di PostalAddress. Deve essere impostato su 0, ovvero la revisione più recente.

Tutte le nuove revisioni devono essere compatibili con le versioni precedenti.

string

Obbligatorio. Codice regione CLDR del paese o della regione dell'indirizzo. Ciò non viene mai dedotto e spetta all'utente assicurarsi che il valore sia corretto. Per informazioni dettagliate, visita le pagine https://cldr.unicode.org/ e https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera.

string

(Facoltativo) Codice lingua BCP-47 dei contenuti di questo indirizzo (se noto). Spesso si tratta della lingua dell'interfaccia utente del modulo di input o dovrebbe corrispondere a una delle lingue utilizzate nell'indirizzo. paese/regione o i loro equivalenti traslitterati. Questo può influenzare la formattazione in alcuni paesi, ma non è fondamentale per la correttezza dei dati e non influirà mai su convalida o altre operazioni correlate alla formattazione.

Se questo valore non è noto, dovrebbe essere omesso (anziché specificare un valore predefinito potenzialmente errato).

Esempi: "zh-Hant", "ja", "ja-Latn", "en".

string

(Facoltativo) Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali, ma se vengono utilizzati, possono attivare un'ulteriore convalida con altre parti dell'indirizzo (ad es. convalida stato/codice postale negli Stati Uniti).

string

(Facoltativo) Codice di ordinamento aggiuntivo specifico per il paese. Questa opzione non è utilizzata nella maggior parte delle regioni. Dove viene utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguita da un numero (ad es. "CEDEX 7") o solo un numero, che rappresenta il "codice di settore" (Giamaica), "indicatore zona di consegna" (Malawi) o "indicatore dell'ufficio postale" (ad es. Costa d'Avorio).

string

(Facoltativo) Suddivisione amministrativa di livello più elevato utilizzata per gli indirizzi postali di un paese o di una regione. Ad esempio, può essere uno stato, una provincia, un oblast o una prefettura. In particolare, per la Spagna si tratta della provincia e non della comunità autonoma (ad es. "Barcellona" e non "Catalogna"). Molti paesi non utilizzano un'area amministrativa negli indirizzi postali. Ad es. in Svizzera, deve essere lasciato vuoto.

string

(Facoltativo) In genere si riferisce alla porzione di città dell'indirizzo. Esempi: città USA, comune in Italia, città postale nel Regno Unito. Nelle regioni del mondo in cui le località non sono ben definite o non si adattano bene a questa struttura, lascia il campo della località vuoto e utilizza addressLines.

string

(Facoltativo) Quartiere dell'indirizzo. Ad esempio, possono essere quartieri, quartieri e distretti.

string

Righe di indirizzo non strutturate che descrivono i livelli inferiori di un indirizzo.

Poiché i valori in addressLines non hanno informazioni sul tipo e a volte possono contenere più valori in un singolo campo (ad es. "Austin, TX"), è importante che l'ordine delle righe sia chiaro. L'ordine delle righe dell'indirizzo deve essere "ordine busta" per il paese o la regione dell'indirizzo. Nei luoghi dove questo valore può variare (ad es. in Giappone), viene utilizzato address_language per renderlo esplicito (ad es. "ja" per ordinamenti di grandi dimensioni e "ja-Latn" o "en" per valori di piccole dimensioni). In questo modo, è possibile selezionare la riga più specifica di un indirizzo in base alla lingua.

La rappresentazione strutturale minima consentita di un indirizzo è composta da un regionalCode con tutte le informazioni rimanenti inserite in addressLines. Sarebbe possibile formattare un indirizzo del genere in modo molto approssimativo senza geocodifica, ma non è stato possibile effettuare alcun ragionamento semantico su nessuno dei componenti dell'indirizzo fino a quando non è stato almeno parzialmente risolto.

Creare un indirizzo che contenga solo countryCode e addressLines e poi la geocodifica è il metodo consigliato per gestire indirizzi completamente non strutturati (anziché indovinare quali parti dell'indirizzo devono essere località o aree amministrative).

string

(Facoltativo) Il destinatario all'indirizzo. In determinate circostanze, questo campo può contenere informazioni su più righe. Ad esempio, potrebbe contenere "cura di" informazioni.

string

(Facoltativo) Il nome dell'organizzazione all'indirizzo.

{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

object (TimePeriod)

Obbligatorio. Una raccolta degli orari di apertura di questa sede. Ogni periodo rappresenta un intervallo di orari in cui la sede è aperta durante la settimana.

{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}

enum (DayOfWeek)

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

object (TimeOfDay)

Obbligatorio. I valori validi sono: 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo giorno specificato.

enum (DayOfWeek)

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

object (TimeOfDay)

Obbligatorio. I valori validi sono: 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo giorno specificato.

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

integer

Le ore del giorno nel formato 24 ore. Deve essere compreso tra 0 e 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.

integer

Minuti dell'ora del giorno. Il valore deve essere compreso tra 0 e 59.

integer

Secondi di minuti del tempo. Normalmente deve essere compreso tra 0 e 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.

integer

Frazioni di secondi in nanosecondi. Deve essere compreso tra 0 e 999.999.999.

{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}

object (SpecialHourPeriod)

Obbligatorio. Un elenco di eccezioni al normale orario di apertura dell'attività.

{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}

object (Date)

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

object (TimeOfDay)

(Facoltativo) 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 closed è falso.

object (Date)

(Facoltativo) 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.

object (TimeOfDay)

(Facoltativo) 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 closed è falso.

boolean

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

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

integer

Mese dell'anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 e deve essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e mese in cui il giorno non è significativo.

{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}

enum (BusinessType)

Obbligatorio. Indica il [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] dell'attività al domicilio del cliente.

object (Places)

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

string

Immutabile. Codice regione CLDR del paese/della regione in cui ha sede questa attività al domicilio del cliente. Per informazioni dettagliate, visita le pagine http://cldr.unicode.org/ e http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera.

Questo campo è obbligatorio per le attività CUSTOMER_LOCATION_ONLY e viene ignorato negli altri casi.

La regione specificata qui può essere diversa dalle regioni per le aree in cui questa attività opera (ad es. attività al domicilio del cliente che forniscono servizi in regioni diverse da quella in cui hanno sede).

Se questa sede richiede la verifica dopo la creazione, l'indirizzo fornito ai fini della verifica deve trovarsi in questa regione e il proprietario dell'attività o un suo rappresentante autorizzato deve essere in grado di ricevere la posta ordinaria all'indirizzo di verifica fornito.

{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}

object (PlaceInfo)

Le aree rappresentate dagli ID luogo. È consentito un massimo di 20 posti.

{
  "placeName": string,
  "placeId": string
}

string

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

string

Obbligatorio. L'ID del luogo. Deve corrispondere a una regione. (https://developers.google.com/places/web-service/supported_types#table3)

{
  "adPhone": string
}

string

Obbligatorio. Un numero di telefono alternativo da mostrare nelle estensioni di località AdWords anziché il numero di telefono principale della sede.

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

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

enum (OpenForBusiness)

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

boolean

Solo output. Indica se questa attività è idonea alla riapertura.

object (Date)

(Facoltativo) 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.

{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean
}

boolean

Solo output. Indica se sono presenti aggiornamenti che devono essere aggiornati o rifiutati dal cliente per l'ID luogo associato a questa sede. Se questo valore booleano è impostato, devi chiamare il metodo getGoogleUpdated per cercare le informazioni che devono essere verificate.

boolean

Solo output. Indica se una delle proprietà di questa località è in stato di modifica in attesa.

boolean

Solo output. Indica se la località può essere eliminata utilizzando l'API.

boolean

Solo output. Indica se la scheda può gestire i post locali.

boolean

Solo output. Indica se la scheda può modificare l'elenco di servizi.

boolean

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

boolean

Solo output. Indica se la località può operare su dati sanitari.

boolean

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

string

Solo output. Se questa sede viene visualizzata su Google Maps, questo campo viene compilato con l'ID della località. Questo ID può essere utilizzato in varie API Places.

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

string

Solo output. La risorsa località duplicata da questa località.

string

Solo output. Un link alla posizione su Maps.

string

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

boolean

Solo output. Indica se la scheda è idonea per le chiamate alle attività commerciali.

boolean

Solo output. Indica se la scheda include Voice of Merchant. Se questo valore booleano è falso, devi chiamare l'API locations.getVoiceOfMerchantState per ricevere informazioni dettagliate sul motivo per cui non dispone di Voice of Merchant.

{
  "description": string
}

string

Obbligatorio. Descrizione del luogo con i tuoi comandi vocali e non modificabile da nessun altro.

{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}

object (RelevantLocation)

La località principale con cui è correlata questa località.

object (RelevantLocation)

L'elenco di località secondarie con cui è correlata questa località.

string

Il nome della risorsa della catena di cui fa parte questa località. [Come trovare l'ID catena] [Locations.SearchChains]

{
  "placeId": string,
  "relationType": enum (RelationType)
}

string

Obbligatorio. Specifica la località che si trova sul lato opposto della relazione con il relativo ID posizione.

enum (RelationType)

Obbligatorio. Il tipo di relazione.

{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

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.

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.

{
  "price": {
    object (Money)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}

object (Money)

(Facoltativo) Rappresenta il prezzo monetario dell'articolo del servizio. Quando includi un prezzo, ti consigliamo di impostare l'opzione currencyCode e le unità. Questo verrà considerato un prezzo fisso per l'articolo del servizio.

object (StructuredServiceItem)

(Facoltativo) Questo campo verrà impostato in caso di dati di servizi strutturati.

object (FreeFormServiceItem)

(Facoltativo) Questo campo viene impostato per i dati di servizi in formato libero.

{
  "serviceTypeId": string,
  "description": string
}

string

Obbligatorio. Il campo serviceTypeId è un ID univoco fornito da Google che puoi trovare in ServiceType. Queste informazioni sono fornite dal servizio RPC di categories.batchGet.

string

(Facoltativo) Descrizione dell'elemento di servizio strutturato. Il limite di caratteri è 300.

{
  "category": string,
  "label": {
    object (Label)
  }
}

string

Obbligatorio. Questo campo rappresenta il nome della categoria (ovvero l'ID stabile della categoria). category e serviceTypeId devono corrispondere alle possibili combinazioni fornite nel messaggio Category.

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. Questo campo deve essere impostato solo se l'input è un elemento di servizio personalizzato. I tipi di servizi standardizzati devono essere aggiornati tramite serviceTypeId.

{
  "displayName": string,
  "description": string,
  "languageCode": string
}

string

Obbligatorio. Nome visualizzato del listino prezzi, della sezione o dell'articolo.

string

(Facoltativo) Descrizione del listino prezzi, della sezione o dell'articolo.

string

(Facoltativo) Il codice lingua BCP-47 a cui si applicano queste stringhe. È possibile impostare un solo set di etichette per lingua.

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

Il codice valuta di tre lettere definito in ISO 4217.

string (int64 format)

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

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.