Indice
AttributesService
(interfaccia)CategoriesService
(interfaccia)Chains
(interfaccia)GoogleLocations
(interfaccia)Locations
(interfaccia)AdWordsLocationExtensions
(messaggio)Attribute
(messaggio)AttributeMetadata
(messaggio)AttributeMetadata.AttributeValueMetadata
(messaggio)AttributeValueType
(enum)Attributes
(messaggio)BatchGetCategoriesRequest
(messaggio)BatchGetCategoriesResponse
(messaggio)BusinessHours
(messaggio)Categories
(messaggio)Category
(messaggio)CategoryView
(enum)Chain
(messaggio)Chain.ChainName
(messaggio)Chain.ChainUri
(messaggio)CreateLocationRequest
(messaggio)DeleteLocationRequest
(messaggio)ErrorCode
(enum)GetAttributesRequest
(messaggio)GetChainRequest
(messaggio)GetGoogleUpdatedAttributesRequest
(messaggio)GetGoogleUpdatedLocationRequest
(messaggio)GetLocationRequest
(messaggio)GoogleLocation
(messaggio)GoogleUpdatedLocation
(messaggio)Label
(messaggio)ListAttributeMetadataRequest
(messaggio)ListAttributeMetadataResponse
(messaggio)ListCategoriesRequest
(messaggio)ListCategoriesResponse
(messaggio)ListLocationsRequest
(messaggio)ListLocationsResponse
(messaggio)Location
(messaggio)Metadata
(messaggio)MoreHours
(messaggio)MoreHoursType
(messaggio)OpenInfo
(messaggio)OpenInfo.OpenForBusiness
(enum)PhoneNumbers
(messaggio)PlaceInfo
(messaggio)Places
(messaggio)Profile
(messaggio)RelationshipData
(messaggio)RelevantLocation
(messaggio)RelevantLocation.RelationType
(enum)RepeatedEnumAttributeValue
(messaggio)SearchChainsRequest
(messaggio)SearchChainsResponse
(messaggio)SearchGoogleLocationsRequest
(messaggio)SearchGoogleLocationsResponse
(messaggio)ServiceAreaBusiness
(messaggio)ServiceAreaBusiness.BusinessType
(enum)ServiceItem
(messaggio)ServiceItem.FreeFormServiceItem
(messaggio)ServiceItem.StructuredServiceItem
(messaggio)ServiceType
(messaggio)SpecialHourPeriod
(messaggio)SpecialHours
(messaggio)TimePeriod
(messaggio)UpdateAttributesRequest
(messaggio)UpdateLocationRequest
(messaggio)UriAttributeValue
(messaggio)
AttributesService
Consente ai client di cercare e aggiornare gli attributi di una determinata località.
GetAttributes |
---|
Cerca tutti gli attributi impostati per una determinata località.
|
GetGoogleUpdatedAttributes |
---|
Visualizza la versione aggiornata da Google della località specificata.
|
ListAttributeMetadata |
---|
Restituisce l'elenco degli attributi che sarebbero disponibili per una località con la categoria principale e il paese specificati.
|
UpdateAttributes |
---|
Aggiorna gli attributi per una località specifica.
|
CategoriesService
Questa API fornisce informazioni sulle categorie supportate per le sedi delle attività commerciali su Google. Come riferimento, consulta la sezione relativa alle categorie in questo articolo: https://support.google.com/business/answer/3038177
BatchGetCategories |
---|
Restituisce un elenco di categorie aziendali per gli ID lingua e GConcept forniti.
|
ListCategories |
---|
Restituisce un elenco di categorie di attività commerciali. La ricerca corrisponderà al nome della categoria, ma non all'ID della categoria. La ricerca corrisponde solo all'inizio del nome di una categoria (vale a dire, "cibo" può restituire "area ristorazione", ma non "ristorante fast food").
|
Catene
Un servizio per la ricerca di informazioni su una catena di attività.
GetChain |
---|
Restituisce la catena specificata. Restituisce
|
SearchChains |
---|
Cerca la catena in base al suo nome.
|
GoogleLocations
Questa API consente l'accesso e la ricerca in GoogleLocation.
SearchGoogleLocations |
---|
Cerca tutte le possibili posizioni che corrispondono alla richiesta specificata.
|
Località
Questa API consente di gestire le sedi dell'attività commerciale su Google.
CreateLocation |
---|
Crea una nuova posizione che sarà di proprietà dell'utente che ha eseguito l'accesso.
|
DeleteLocation |
---|
Elimina una posizione. Se questa sede non può essere eliminata utilizzando l'API ed è contrassegnata in
|
GetGoogleUpdatedLocation |
---|
Visualizza la versione aggiornata da Google della località specificata.
|
GetLocation |
---|
Restituisce la località specificata.
|
ListLocations |
---|
Elenca le sedi dell'account specificato.
|
UpdateLocation |
---|
Aggiorna la località specificata.
|
AdWordsLocationExtensions
Informazioni aggiuntive visualizzate in AdWords.
Campi | |
---|---|
ad_phone |
Obbligatorio. Un numero di telefono alternativo da mostrare nelle estensioni di località di AdWords al posto del numero di telefono principale della località. |
Attributo
Un attributo località. Gli attributi forniscono informazioni aggiuntive su una località. Gli attributi che è possibile impostare per una località possono variare in base alle proprietà della località (ad esempio, categoria). Gli attributi disponibili sono determinati da Google e possono essere aggiunti e rimossi senza modifiche all'API.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa per questo attributo. |
value_type |
Solo output. Il tipo di valore contenuto in questo attributo. Questo dovrebbe essere utilizzato per determinare come interpretare il valore. |
values[] |
I valori per questo attributo. Il tipo dei valori forniti deve corrispondere a quello previsto per l'attributo in questione. Si tratta di un campo ripetuto in cui possono essere forniti più valori per gli attributi. I tipi di attributo supportano un solo valore. |
repeated_enum_value |
Quando il tipo di valore dell'attributo è REPEATED_ENUM, contiene il valore dell'attributo, mentre gli altri campi devono essere vuoti. |
uri_values[] |
Quando il tipo di valore dell'attributo è URL, questo campo contiene i valori per questo attributo e gli altri campi devono essere vuoti. |
AttributeMetadata
I metadati di un attributo. Contiene informazioni di visualizzazione relative all'attributo, tra cui un nome localizzato e un'intestazione per raggruppare gli attributi correlati.
Campi | |
---|---|
parent |
L'identificatore univoco dell'attributo. |
value_type |
Il tipo di valore dell'attributo. I valori impostati e recuperati devono essere di questo tipo. |
display_name |
Il nome visualizzato localizzato per l'attributo, se disponibile; in caso contrario, il nome visualizzato in inglese. |
group_display_name |
Il nome visualizzato localizzato del gruppo che contiene questo attributo, se disponibile; in caso contrario, il nome del gruppo in inglese. Gli attributi correlati vengono raccolti in un gruppo e devono essere visualizzati insieme sotto l'intestazione qui indicata. |
repeatable |
Se true, l'attributo supporta più valori. Se il valore è false, deve essere specificato un solo valore. |
value_metadata[] |
Per alcuni tipi di attributi (ad esempio le enumerazioni), viene fornito un elenco dei valori supportati e i nomi visualizzati corrispondenti per questi valori. |
deprecated |
Se true, l'attributo è obsoleto e non deve più essere utilizzato. Se è obsoleto, l'aggiornamento di questo attributo non genererà un errore, ma gli aggiornamenti non verranno salvati. A un certo punto, dopo essere stato ritirato, l'attributo verrà rimosso completamente e diventerà un errore. |
AttributeValueMetadata
Metadati per i valori degli attributi supportati.
Campi | |
---|---|
value |
Il valore dell'attributo. |
display_name |
Il nome visualizzato per questo valore, localizzato se disponibile; altrimenti, in inglese. Il nome visualizzato del valore deve essere utilizzato insieme al nome visualizzato dell'attributo. Ad esempio, per un attributo enum "Wi-Fi", potrebbe contenere "A pagamento" per rappresentare una rete Wi-Fi a pagamento. |
AttributeValueType
Il tipo di valore dell'attributo.
Enum | |
---|---|
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED |
Non specificato. |
BOOL |
I valori per questo attributo sono valori booleani. |
ENUM |
L'attributo dispone di un elenco predefinito di valori disponibili che possono essere utilizzati. I metadati per questo attributo elencheranno questi valori. |
URL |
I valori per questo attributo sono URL. |
REPEATED_ENUM |
Il valore dell'attributo è un'enumerazione con più valori possibili che è possibile impostare o annullare esplicitamente. |
Attributi
Un contenitore per tutti gli attributi di una determinata località.
Campi | |
---|---|
name |
Obbligatorio. Identificatore di Google per questa località sotto forma di |
attributes[] |
Una raccolta di attributi che devono essere aggiornati. |
BatchGetCategoriesRequest
Messaggio di richiesta relativo a BusinessCategories.BatchGetBusinessCategories.
Campi | |
---|---|
names[] |
Obbligatorio. Devi impostare almeno un nome. Gli ID di GConcept per i quali devono essere restituiti i nomi delle categorie localizzate. Per restituire i dettagli di più categorie, ripeti questo parametro nella richiesta. |
language_code |
Obbligatorio. Il codice della lingua BCP 47 in cui devono essere restituiti i nomi delle categorie. |
region_code |
Campo facoltativo. Il codice paese ISO 3166-1 alpha-2 utilizzato per dedurre una lingua non standard. |
view |
Obbligatorio. Specifica le parti alla risorsa Categoria da restituire nella risposta. |
BatchGetCategoriesResponse
Messaggio di risposta per BusinessCategories.BatchGetBusinessCategories.
Campi | |
---|---|
categories[] |
Categorie corrispondenti agli ID GConcept forniti nella richiesta. Non arriveranno nello stesso ordine degli ID categoria nella richiesta. |
BusinessHours
Rappresenta i periodi di tempo in cui questa sede è aperta al pubblico. Contiene una raccolta di istanze [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].
Campi | |
---|---|
periods[] |
Obbligatorio. Una raccolta degli orari in cui questa sede è aperta al pubblico. Ogni periodo rappresenta un intervallo di ore in cui la sede è aperta durante la settimana. |
Categorie
Una raccolta di categorie che descrivono l'attività. Durante gli aggiornamenti è necessario impostare entrambi i campi. Ai clienti non è consentito aggiornare singolarmente la categoria principale o aggiuntiva utilizzando la maschera di aggiornamento.
Campi | |
---|---|
primary_category |
Obbligatorio. Categoria che descrive meglio l'attività principale di questa sede. |
additional_categories[] |
Campo facoltativo. Categorie aggiuntive per descrivere la tua attività. Le categorie aiutano i clienti a trovare risultati precisi e specifici per i servizi di loro interesse. Per fare in modo che le informazioni sulla tua attività siano sempre precise e aggiornate, assicurati di utilizzare il minor numero possibile di categorie per descrivere la tua attività principale nel complesso. Scegli le categorie più specifiche possibili, ma rappresentative dell'attività principale. |
Categoria
Una categoria che descrive l'attività (non la sua funzione). Per un elenco degli ID categoria validi e le mappature ai relativi nomi leggibili, consulta categories.list
.
Campi | |
---|---|
name |
Obbligatorio. Un ID stabile (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à). |
display_name |
Solo output. Il nome leggibile della categoria. Questa impostazione viene impostata durante la lettura della posizione. Quando modifichi la località, è necessario impostare |
service_types[] |
Solo output. Un elenco di tutti i tipi di servizi disponibili per questa categoria di attività. |
more_hours_types[] |
Solo output. Altri tipi di orari disponibili per questa categoria di attività. |
CategoryView
Un'enumerazione per limitare la quantità di dati restituiti dal server.
Enum | |
---|---|
CATEGORY_VIEW_UNSPECIFIED |
Non specificato, equivalente a CATEGORY_METADATA_only. |
BASIC |
La risposta del server includerà solo i campi Categoria display_name, category_id e language_code. Omette tutti i campi relativi ai metadati dei tipi di servizi. |
FULL |
Restituisce tutti i campi nella risposta. |
Catena
Una catena è un brand al quale le sedi della tua attività possono essere affiliate.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa della catena, nel formato |
chain_names[] |
I nomi della catena. |
websites[] |
Siti web della catena. |
location_count |
Numero di sedi che fanno parte di questa catena. |
ChainName
Nome da utilizzare quando si visualizza la catena.
Campi | |
---|---|
display_name |
Il nome visualizzato per questa catena. |
language_code |
Il codice lingua BCP 47 del nome. |
ChainUri
URL da utilizzare per la visualizzazione della catena.
Campi | |
---|---|
uri |
L'URI di questa catena. |
CreateLocationRequest
Messaggio di richiesta per locations.CreateLocation.
Campi | |
---|---|
parent |
Obbligatorio. Il nome dell'account in cui creare questa sede. |
location |
Obbligatorio. I nuovi metadati relativi alla posizione. |
validate_only |
Campo facoltativo. Se il valore è true, la richiesta viene convalidata senza creare effettivamente la località. |
request_id |
Campo facoltativo. Un ID richiesta univoco affinché il server possa rilevare le richieste duplicate. Ti consigliamo di utilizzare gli UUID. La lunghezza massima è di 50 caratteri. |
DeleteLocationRequest
Messaggio di richiesta per locations.DeleteLocation.
Campi | |
---|---|
name |
Obbligatorio. Il nome della sede da eliminare. |
ErrorCode
Tutti i codici di errore restituiti dall'API.
Enum | |
---|---|
ERROR_CODE_UNSPECIFIED |
Codice di errore mancante. |
INVALID_ATTRIBUTE_NAME |
Uno degli attributi forniti non può essere applicato a questa località. Solo gli attributi restituiti nella risposta ListAttributeMetadata possono essere applicati a questa località. Tutti i nomi degli attributi problematici verranno restituiti nella chiave attribute_names nei metadati. |
ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION |
Questo errore viene restituito quando un client tenta di associare una località o di cancellare un'associazione di località per una sede in stato verificato. |
ASSOCIATE_LOCATION_INVALID_PLACE_ID |
Il valore place_id fornito nella richiesta associateLocation non corrisponde alla località oppure non è valido. Assicurati che il valore place_id impostato corrisponda a uno degli ID restituiti nella risposta SearchGoogleLocations . |
LAT_LNG_UPDATES_NOT_PERMITTED |
Questo progetto non è autorizzato ad aggiornare il campo lat/lng in Località. Puoi aggiornare lat/lng utilizzando la funzionalità segnaposto nell'interfaccia utente oppure fornirci un indirizzo. |
PO_BOX_IN_ADDRESS_NOT_ALLOWED |
Impossibile utilizzare una casella postale nell'indirizzo. Le chiavi dei metadati includono "field_mask". |
BLOCKED_REGION |
A causa di sanzioni internazionali che siamo tenuti a rispettare, non possiamo accettare attività commerciali in questa regione. Le chiavi dei metadati includono "field_maks". |
MISSING_BOTH_PHONE_AND_WEBSITE |
Per le attività CUSTOMER_LOCATION_only è necessario un telefono o un sito web. Le chiavi dei metadati includono "field_mask". |
MISSING_STOREFRONT_ADDRESS_OR_SAB |
Tutte le sedi devono avere almeno un indirizzo di negozio o un'area coperta dal servizio. Le chiavi dei metadati includono "field_mask". |
LAT_LNG_TOO_FAR_FROM_ADDRESS |
La coppia di latitudine/longitudine e indirizzo sono troppo distanti tra loro. Le chiavi dei metadati includono "field_mask". |
LAT_LNG_REQUIRED |
OBSOLETO. Sostituito da PIN_DROP_REQUIRED. Impossibile individuare l'indirizzo specificato. Specifica latitudine/longitudine. Le chiavi dei metadati includono "field_mask". |
INVALID_CHARACTERS |
Sono stati trovati caratteri non validi. Le chiavi dei metadati includono "field_mask" e "invalid_characters". |
FORBIDDEN_WORDS |
Sono state trovate parole vietate. Le chiavi dei metadati includono "field_mask" e "forbidden_words". |
INVALID_INTERCHANGE_CHARACTERS |
Sono stati trovati caratteri non validi. Le chiavi dei metadati includono "field_mask". |
FIELDS_REQUIRED_FOR_CATEGORY |
Per questa categoria di località sono obbligatori altri campi. Le chiavi dei metadati includono "field_mask", "value" e "fields_required". |
STOREFRONT_REQUIRED_FOR_CATEGORY |
La categoria della tua attività richiede una sede del negozio fisico che i clienti possono visitare. Le chiavi dei metadati includono "field_mask". |
ADDRESS_MISSING_REGION_CODE |
Manca il codice regione obbligatorio per l'indirizzo. Le chiavi dei metadati includono "field_mask". |
ADDRESS_EDIT_CHANGES_COUNTRY |
L'indirizzo non può essere spostato in un altro paese. Le chiavi dei metadati includono "field_mask". |
SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS |
Gli orari speciali possono essere specificati solo se la sede ha orari di apertura regolari. Metadati vuoti. |
INVALID_TIME_SCHEDULE |
Pianificazione dell'orario non valida, ora sovrapposta o ora di fine precedente all'ora di inizio. Le chiavi dei metadati includono "field_mask". |
INVALID_HOURS_VALUE |
Formato o valore dell'orario non valido. Le chiavi dei metadati includono "field_mask". |
OVERLAPPED_SPECIAL_HOURS |
Gli orari_speciali non possono sovrapporsi. Le chiavi dei metadati includono "field_mask". |
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY |
La categoria principale della tua attività non supporta questo tipo di orario. Le chiavi dei metadati includono "field_mask" e "incompatible_hours_type". |
DUPLICATE_CHILDREN_LOCATIONS |
Children_locations duplicato inRelationship_data. Le chiavi dei metadati includono "field_mask". |
INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY |
Un'attività al domicilio del cliente non può avere la categoria principale selezionata. Le chiavi dei metadati includono "field_mask". |
INVALID_SERVICE_AREA_PLACE_ID |
Place_id non valido in service_area. Le chiavi dei metadati includono "field_mask" e "place_id". |
INVALID_AREA_TYPE_FOR_SERVICE_AREA |
Tipo di area non valido per service_area. Le chiavi dei metadati includono "field_mask" e "place_id". |
OPENING_DATE_TOO_FAR_IN_THE_FUTURE |
Inserisci una data di apertura che non superi un anno. Le chiavi dei metadati includono "field_mask". |
OPENING_DATE_MISSING_YEAR_OR_MONTH |
È necessario specificare un anno o un mese per la data di apertura. Le chiavi dei metadati includono "field_mask". |
OPENING_DATE_BEFORE_1AD |
La data di apertura non può essere precedente a 1 AD. Le chiavi dei metadati includono "field_mask". |
TOO_MANY_ENTRIES |
Troppe voci per il campo. Le chiavi dei metadati includono "field_mask" e "max_count". |
INVALID_PHONE_NUMBER |
Il numero di telefono inserito non è riconosciuto. Le chiavi dei metadati includono "field_mask" e "value". |
INVALID_PHONE_NUMBER_FOR_REGION |
Numero di telefono non valido per la regione. Le chiavi dei metadati includono "field_mask" e "value". |
MISSING_PRIMARY_PHONE_NUMBER |
Numero di telefono principale mancante. Le chiavi dei metadati includono "field_mask". |
THROTTLED |
Al momento il campo non può essere aggiornato. Le chiavi dei metadati includono "field_mask" e "value". |
UNSUPPORTED_POINT_RADIUS_SERVICE_AREA |
Le aree coperte dal servizio del raggio del punto non sono più supportate. Le chiavi dei metadati includono "field_mask". |
INVALID_CATEGORY |
ID categoria non valido. Le chiavi dei metadati includono "field_mask" e "value". |
CANNOT_REOPEN |
L'attività non può riaprire. Le chiavi dei metadati includono "field_mask". |
INVALID_BUSINESS_OPENING_DATE |
Data di apertura dell'attività non valida. Le chiavi dei metadati includono "field_mask". |
INVALID_LATLNG |
Latlng non valido. Le chiavi dei metadati includono "field_mask". |
PROFILE_DESCRIPTION_CONTAINS_URL |
La descrizione dell'attività non deve contenere un URL. Le chiavi dei metadati includono "field_mask". |
LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION |
La descrizione del profilo della località della struttura non può essere modificata. Le chiavi dei metadati includono "field_mask". |
INVALID_URL |
Link non valido. Le chiavi dei metadati includono "field_mask". |
INVALID_ADDRESS |
Indirizzo non valido. Le chiavi dei metadati includono "field_mask". |
PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF |
ParentChain non può essere la località stessa. Le chiavi dei metadati includono "field_mask" e "value". |
RELATION_CANNOT_BE_THE_LOCATION_ITSELF |
La relazione non può essere la località stessa. Le chiavi dei metadati includono "field_mask" e "value". |
MISSING_ADDRESS_COMPONENTS |
Valore mancante per i componenti dell'indirizzo. Le chiavi dei metadati includono "field_mask". |
READ_ONLY_ADDRESS_COMPONENTS |
Impossibile modificare i componenti dell'indirizzo di sola lettura. Le chiavi dei metadati includono "field_mask". |
STRING_TOO_LONG |
La stringa è troppo lunga. Le chiavi dei metadati includono "field_mask" e "max_length". |
STRING_TOO_SHORT |
La stringa è troppo corta. Le chiavi dei metadati includono "field_mask" e "min_length". |
REQUIRED_FIELD_MISSING_VALUE |
Valore mancante per il campo obbligatorio. Le chiavi dei metadati includono "field_mask". |
ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED |
Impossibile aggiungere o modificare l'URL di un fornitore. Le chiavi dei metadati includono "attribute_name". |
ATTRIBUTE_INVALID_ENUM_VALUE |
Valore sconosciuto per l'attributo enum. Le chiavi dei metadati includono "attribute_name". |
ATTRIBUTE_NOT_AVAILABLE |
Attributo scalabile non valido per questa località. Le chiavi dei metadati includono ""attribute_name". |
ATTRIBUTE_CANNOT_BE_REPEATED |
L'attributo scalabile può essere specificato una sola volta. Le chiavi dei metadati includono "attribute_name". |
ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY |
L'attributo scalabile non è compatibile con le categorie impostate nella località. Le chiavi dei metadati includono "attribute_name". |
ADDRESS_REMOVAL_NOT_ALLOWED |
La rimozione dell'indirizzo non è consentita per la tua attività. Le chiavi dei metadati includono "field_mask". |
AMBIGUOUS_TITLE |
Il nome migliore è ambiguo per una lingua. Le chiavi dei metadati includono "field_mask". |
INVALID_CATEGORY_FOR_SAB |
Un SAB puro non può avere gcid che sono sottotipi di gcid:establishment_poi. Le chiavi dei metadati includono "field_mask" e "value". |
RELATION_ENDPOINTS_TOO_FAR |
Gli endpoint della relazione sono troppo lontani l'uno dall'altro. Le chiavi dei metadati includono "field_mask" e "value". |
INVALID_SERVICE_ITEM |
Nessun asset strutturato_service_item o free_form_service_item impostato. Le chiavi dei metadati includono "field_mask". |
SERVICE_ITEM_LABEL_NO_DISPLAY_NAME |
Manca il nome visualizzato dell'etichetta. Le chiavi dei metadati includono "field_mask". |
SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME |
Il nome visualizzato non è univoco per tutte le etichette in tutti i listini prezzi. Le chiavi dei metadati includono "field_mask". |
SERVICE_ITEM_LABEL_INVALID_UTF8 |
L'etichetta contiene simboli UTF-8 non validi. Le chiavi dei metadati includono "field_mask". |
FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID |
Campo category_id mancante in free_form_service_item. Le chiavi dei metadati includono "field_mask". |
FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL |
Etichetta mancante in free_form_service_item. Le chiavi dei metadati includono "field_mask". |
SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID |
Campo service_type_id mancante instructured_service_item. Le chiavi dei metadati includono "field_mask". |
INVALID_LANGUAGE |
Il codice lingua non è valido. Le chiavi dei metadati includono "field_mask". |
PRICE_CURRENCY_MISSING |
Codice valuta ISO 4217 mancante. Le chiavi dei metadati includono "field_mask". |
PRICE_CURRENCY_INVALID |
Il codice valuta fornito non è valido ISO 4217. Le chiavi dei metadati includono "field_mask". |
SERVICE_TYPE_ID_DUPLICATE |
Gli ID del tipo di servizio non sono univoci all'interno della località. Le chiavi dei metadati includono "field_mask". |
PIN_DROP_REQUIRED |
Impossibile individuare l'indirizzo specificato. Utilizza l'interfaccia utente per specificare un segnaposto. Le chiavi dei metadati includono "field_mask". |
STALE_DATA |
Uno o più elementi sono stati aggiornati di recente da Google. Al momento, solo il proprietario di questa attività può apportare modifiche ai dati situati nel campo "field" visitando il sito business.google.com. Le chiavi dei metadati includono "field_mask". |
PHONE_NUMBER_EDITS_NOT_ALLOWED |
Il campo del numero di telefono è stato disattivato per questa località e non è consentito apportare modifiche. Le chiavi dei metadati includono "field_mask". |
MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION |
Esistono più relazioni che modellano la relazione logica tra due località (ad es. ritiro di, opere in). Le chiavi dei metadati includono "field_mask" e "value". |
GetAttributesRequest
Richiesta di AttributesService.GetAttributes.
Campi | |
---|---|
name |
Obbligatorio. Identificatore di Google per questa località sotto forma di |
GetChainRequest
Messaggio di richiesta per locations.GetChain.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa della catena, nel formato |
GetGoogleUpdatedAttributesRequest
Richiesta di AttributesService.GetGoogleUpdatedAttributes.
Campi | |
---|---|
name |
Obbligatorio. Identificatore di Google per questa località sotto forma di |
GetGoogleUpdatedLocationRequest
Messaggio di richiesta per locations.GetGoogleUpdatedLocation.
Campi | |
---|---|
name |
Obbligatorio. Il nome della posizione da recuperare. |
read_mask |
Obbligatorio. Maschera di lettura per specificare quali campi verranno restituiti nella risposta. |
GetLocationRequest
Messaggio di richiesta per locations.GetLocation.
Campi | |
---|---|
name |
Obbligatorio. Il nome della posizione da recuperare. |
read_mask |
Obbligatorio. Maschera di lettura per specificare quali campi verranno restituiti nella risposta. |
GoogleLocation
Rappresenta un Location
presente su Google. Potrebbe trattarsi di una sede che è stata rivendicata dall'utente, da qualcun altro o che potrebbe non essere rivendicata.
Campi | |
---|---|
name |
Nome risorsa di questa GoogleLocation, nel formato |
location |
Le informazioni |
request_admin_rights_uri |
Un URL che reindirizza l'utente all'interfaccia utente per i diritti di amministrazione della richiesta. Questo campo è presente solo se la sede è già stata rivendicata da un utente, incluso l'utente corrente. |
GoogleUpdatedLocation
Rappresenta una sede modificata da Google.
Campi | |
---|---|
location |
La versione aggiornata da Google di questo luogo. |
diff_mask |
I campi aggiornati da Google. |
pending_mask |
I campi con modifiche in attesa non ancora trasmesse a Maps e Ricerca. |
Etichetta
Etichetta da utilizzare quando visualizzi il listino prezzi, la sezione o l'articolo.
Campi | |
---|---|
display_name |
Obbligatorio. Nome visualizzato del listino prezzi, della sezione o dell'elemento. |
description |
Campo facoltativo. Descrizione del listino prezzi, della sezione o dell'elemento. |
language_code |
Campo facoltativo. Il codice lingua BCP-47 a cui si applicano queste stringhe. È possibile impostare un solo insieme di etichette per lingua. |
ListAttributeMetadataRequest
Richiesta di AttributesService.ListAttributeMetadata.
Campi | |
---|---|
parent |
Nome della risorsa della località per cercare gli attributi disponibili. Se questo campo è impostato, categoria_name, regione_code, language_code e show_all non sono obbligatori e non devono essere impostati. |
category_name |
L'ID stabile della categoria principale per trovare gli attributi disponibili. Deve essere nel formato categorie/{category_id}. |
region_code |
Il codice paese ISO 3166-1 alpha-2 per trovare gli attributi disponibili. |
language_code |
Il codice di lingua BCP 47 in cui ottenere i nomi visualizzati degli attributi. Se questa lingua non è disponibile, le lingue verranno fornite in inglese. |
show_all |
I metadati di tutti gli attributi disponibili vengono restituiti quando questo campo è impostato su true, senza tenere conto dei campi padre e category_name. language_code e regional_code sono obbligatori quando show_all è impostato su true. |
page_size |
Il numero di attributi da includere per pagina. Il valore predefinito è 200, il minimo è 1. |
page_token |
Se specificato, viene recuperata la pagina successiva dei metadati degli attributi. |
ListAttributeMetadataResponse
Risposta per AttributesService.ListAttributeMetadata.
Campi | |
---|---|
attribute_metadata[] |
Una raccolta di metadati degli attributi per gli attributi disponibili. |
next_page_token |
Se il numero di attributi supera le dimensioni di pagina richieste, questo campo verrà completato con un token per recuperare la pagina successiva di attributi in una chiamata successiva a |
ListCategoriesRequest
Messaggio di richiesta relativo a BusinessCategories.ListCategories.
Campi | |
---|---|
region_code |
Obbligatorio. Il codice paese ISO 3166-1 alpha-2. |
language_code |
Obbligatorio. Il codice lingua BCP 47. |
filter |
Campo facoltativo. Filtra stringa da utente. L'unico campo supportato è |
page_size |
Campo facoltativo. Il numero di categorie da recuperare per pagina. Il valore predefinito è 100, il minimo è 1 e la dimensione massima della pagina è 100. |
page_token |
Campo facoltativo. Se specificata, verrà recuperata la pagina successiva di categorie. |
view |
Obbligatorio. Specifica le parti alla risorsa Categoria da restituire nella risposta. |
ListCategoriesResponse
Messaggio di risposta per BusinessCategories.ListCategories.
Campi | |
---|---|
categories[] |
Le categorie corrispondenti in base ai parametri richiesti. |
next_page_token |
Se il numero di categorie supera le dimensioni di pagina richieste, questo campo verrà completato con un token per recuperare la pagina successiva di categorie in una chiamata successiva a |
ListLocationsRequest
Messaggio di richiesta per locations.ListLocations.
Campi | |
---|---|
parent |
Obbligatorio. Il nome dell'account da cui recuperare le posizioni. Se l'account principale [Account] [google.mybusiness.accountmanagement.v1.Account] è di [AccountType] [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL, vengono restituite solo le sedi di proprietà dell'account, altrimenti verranno restituite tutte le sedi accessibili dall'account, direttamente o indirettamente. |
page_size |
Campo facoltativo. Quante posizioni recuperare per pagina. Se non è impostato, il valore predefinito è 10. Il valore minimo è 1, mentre la dimensione massima della pagina è 100. |
page_token |
Campo facoltativo. Se specificato, recupera le località successive ( |
filter |
Campo facoltativo. Un filtro che vincola le località da restituire. La risposta include solo le voci che corrispondono al filtro. Se Per ulteriori informazioni sui campi validi e sull'utilizzo di esempio, consulta la Guida all'utilizzo dei dati sulla posizione. |
order_by |
Campo facoltativo. Ordinamento della richiesta. Più campi devono essere separati da virgole, seguendo la sintassi SQL. L'ordinamento predefinito è crescente. Per specificare l'ordine decrescente, è necessario aggiungere un suffisso " desc". I campi validi per order_by sono title e store_code. Ad esempio: "title, store_code desc" o "title" o "store_code desc". |
read_mask |
Obbligatorio. Maschera di lettura per specificare quali campi verranno restituiti nella risposta. |
ListLocationsResponse
Messaggio di risposta per locations.ListLocations.
Campi | |
---|---|
locations[] |
Le località. |
next_page_token |
Se il numero di località supera le dimensioni di pagina richieste, questo campo viene compilato con un token per recuperare la pagina successiva delle località in una chiamata successiva a |
total_size |
Il numero approssimativo di località nell'elenco indipendentemente dall'impaginazione. Questo campo verrà restituito solo se |
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.
Campi | |
---|---|
name |
Identificatore di Google per questa località nel formato: |
language_code |
Immutabile. La lingua della località. Impostata durante la creazione e non aggiornabile. |
store_code |
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 |
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, |
phone_numbers |
Campo facoltativo. I diversi numeri di telefono che i clienti possono utilizzare per contattare l'attività. |
categories |
Campo facoltativo. Le diverse categorie che descrivono l'attività. |
storefront_address |
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 |
website_uri |
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. |
regular_hours |
Campo facoltativo. Orario di apertura dell'attività. |
special_hours |
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. |
service_area |
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[] |
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. |
ad_words_location_extensions |
Campo facoltativo. Informazioni aggiuntive visualizzate in AdWords. |
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 |
open_info |
Campo facoltativo. Una bandiera che indica se la sede è attualmente aperta. |
metadata |
Solo output. Informazioni aggiuntive non modificabili dall'utente. |
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). |
relationship_data |
Campo facoltativo. Tutte le sedi e le catene correlate a questo. |
more_hours[] |
Campo facoltativo. Più orari per i diversi reparti o per clienti specifici di un'attività. |
service_items[] |
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. |
Metadati
Ulteriori informazioni sulla sede non modificabili dall'utente.
Campi | |
---|---|
has_google_updated |
Solo output. Indica se l'ID luogo associato a questa sede contiene aggiornamenti che devono essere aggiornati o rifiutati dal cliente. Se questo valore booleano è impostato, devi chiamare il metodo |
has_pending_edits |
Solo output. Indica se le proprietà di questa località sono in stato di modifica in attesa. |
can_delete |
Solo output. Indica se la località può essere eliminata utilizzando l'API. |
can_operate_local_post |
Solo output. Indica se la scheda può gestire post locali. |
can_modify_service_list |
Solo output. Indica se la scheda può modificare l'elenco dei servizi. |
can_have_food_menus |
Solo output. Indica se la scheda è idonea per il menu del cibo. |
can_operate_health_data |
Solo output. Indica se la posizione può operare sui dati sanitari. |
can_operate_lodging_data |
Solo output. Indica se la posizione può operare sui dati dell'alloggio. |
place_id |
Solo output. Se la località viene visualizzata su Google Maps, il campo viene compilato con l'ID del luogo. Questo ID può essere utilizzato in varie API Places. Questo campo può essere impostato durante le chiamate Create, ma non per Update. |
duplicate_location |
Solo output. La risorsa della località duplicata da questa località. |
maps_uri |
Solo output. Un link alla località su Maps. |
new_review_uri |
Solo output. Un link alla pagina nella Ricerca Google in cui un cliente può lasciare una recensione per la sede. |
can_have_business_calls |
Solo output. Indica se la scheda è idonea per le chiamate di attività commerciali. |
has_voice_of_merchant |
Solo output. Indica se la scheda ha Voice of Merchant. Se questo valore booleano è false, devi chiamare l'API locations.getVoiceOfMerchantState per ottenere dettagli sul motivo per cui non ha Voice of Merchant. |
MoreHours
I periodi di tempo durante i quali una sede è aperta per determinati tipi di attività.
Campi | |
---|---|
hours_type_id |
Obbligatorio. Tipo di orari. I clienti devono chiamare {#link businessCategories:BatchGet} per conoscere i tipi di orari supportati per le categorie delle loro sedi. |
periods[] |
Obbligatorio. Una raccolta degli orari di apertura di questa sede. Ogni periodo rappresenta un intervallo di ore in cui la sede è aperta durante la settimana. |
MoreHoursType
Altri tipi di orari offerti da un'attività, oltre ai normali orari.
Campi | |
---|---|
hours_type_id |
Solo output. Un ID stabile fornito da Google per questo tipo di orario. |
display_name |
Solo output. Il nome visualizzato in inglese leggibile per il tipo di orario. |
localized_display_name |
Solo output. Il nome visualizzato localizzato leggibile per il tipo di orario. |
OpenInfo
Informazioni relative allo stato di apertura dell'attività.
Campi | |
---|---|
status |
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. |
can_reopen |
Solo output. Indica se questa attività è idonea per la riapertura. |
opening_date |
Campo facoltativo. La data di apertura della sede. Se non si conosce il giorno esatto, è possibile indicare solo il mese e l'anno. La data deve essere nel passato o non essere più di 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 chiusa temporaneamente. |
PhoneNumbers
Una raccolta di numeri di telefono dell'attività. Durante gli aggiornamenti è necessario impostare entrambi i campi. I clienti non possono aggiornare solo il numero di telefono principale o aggiuntivo utilizzando la maschera di aggiornamento. È preferibile il formato telefonico internazionale, ad esempio "+1 415 555 0132". Per saperne di più, consulta la pagina https://developers.google.com/style/phone-numbers#international-phone-numbers).
Campi | |
---|---|
primary_phone |
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 di assistenza centrale. |
additional_phones[] |
Campo facoltativo. Fino a due numeri di telefono (cellulare o fisso, nessun fax) ai quali è possibile chiamare l'attività, oltre al numero di telefono principale. |
PlaceInfo
Definisce un'area rappresentata da un ID luogo.
Campi | |
---|---|
place_name |
Obbligatorio. Il nome localizzato del luogo. Ad esempio, |
place_id |
Obbligatorio. L'ID del luogo. Deve corrispondere a una regione. (https://developers.google.com/places/web-service/supported_types#table3) |
Luoghi
Definisce l'unione di aree rappresentate da un insieme di luoghi.
Campi | |
---|---|
place_infos[] |
Le aree rappresentate dagli ID luogo. L'offerta è limitata a un massimo di 20 posti. |
Profilo
Tutte le informazioni relative al profilo della sede.
Campi | |
---|---|
description |
Obbligatorio. Descrizione del luogo a tua voce, non modificabile da nessun altro. |
RelationshipData
Informazioni di tutte le posizioni principali e secondarie correlate a questo.
Campi | |
---|---|
parent_location |
La sede principale con cui è correlata questa sede. |
children_locations[] |
L'elenco dei luoghi dei bambini con cui questa località è correlata. |
parent_chain |
Il nome della risorsa della catena di cui fa parte la sede. [Come trovare l'ID catena] [Locations.SearchChains] |
RelevantLocation
Informazioni su un'altra posizione correlata a quella attuale. La relazione può essere una qualsiasi tra DEPARTMENT_OF o INDEPENDENT_ESTABLISHMENT_OF e la località specificata qui può essere su entrambi i lati (principale/secondario) della località.
Campi | |
---|---|
place_id |
Obbligatorio. Specifica la località che si trova dall'altro lato della relazione tramite il relativo PlaceID. |
relation_type |
Obbligatorio. Il tipo di relazione. |
RelationType
Le relazioni di tipo da specificare.
Enum | |
---|---|
RELATION_TYPE_UNSPECIFIED |
Tipo non specificato. |
DEPARTMENT_OF |
Questo rappresenta una relazione tra due sedi che condividono un'unica area fisica, lo stesso brand/alta dirigenza/organizzazione, ma con attributi chiave diversi come orari di apertura o numeri di telefono. Ad esempio, Costco Pharmacy è un dipartimento della catena Costco Wholesale. |
INDEPENDENT_ESTABLISHMENT_IN |
Questo è il caso in cui due sedi sono con sede nella stessa posizione fisica, ma di aziende diverse (ad es. Starbucks al supermercato Carrefour, negozi in un centro commerciale). |
RepeatedEnumAttributeValue
Valori per un attributo con value_type
pari a REPEATED_ENUM. Comprende due elenchi di ID valore: quelli impostati (true) e quelli non impostati (false). I valori assenti sono considerati sconosciuti. È necessario specificare almeno un valore.
Campi | |
---|---|
set_values[] |
Enumera i valori impostati. |
unset_values[] |
Enumera i valori che non sono stati impostati. |
SearchChainsRequest
Messaggio di richiesta per locations.SearchChains.
Campi | |
---|---|
chain_name |
Obbligatorio. Cerca una catena in base al nome. Sono supportate query esatte/parziali/parziali/correlate. Esempi: "walmart", "wal-mart", "walmmmart", "沃尔玛" |
page_size |
Il numero massimo di catene corrispondenti da restituire da questa query. Il valore predefinito è 10. Il valore massimo possibile è 500. |
SearchChainsResponse
Messaggio di risposta per locations.SearchChains.
Campi | |
---|---|
chains[] |
Catene che corrispondono al valore chain_display_name oggetto della query in SearchChainsRequest. Se non viene trovata alcuna corrispondenza, il campo rimane vuoto. I risultati sono elencati in ordine di pertinenza. |
SearchGoogleLocationsRequest
Messaggio di richiesta per GoogleLocations.SearchGoogleLocations.
Campi | |
---|---|
page_size |
Il numero di corrispondenze da restituire. Il valore predefinito è 3, con un massimo di 10. Tieni presente che la latenza può aumentare se ne vengono richieste di più. Non è prevista l'impaginazione. |
Campo di unione search_query . Query di ricerca. Può essere fornito come oggetto posizione o come query stringa. search_query può essere solo uno dei seguenti: |
|
location |
Località da cercare. Se fornito, troverai le sedi che corrispondono ai dettagli sulla posizione forniti. |
query |
Query di testo da cercare. I risultati di ricerca da una stringa di query saranno meno precisi rispetto a quando si fornisce una posizione esatta, ma possono fornire corrispondenze più inesatte. |
SearchGoogleLocationsResponse
Messaggio di risposta per GoogleLocations.SearchGoogleLocations.
Campi | |
---|---|
google_locations[] |
Un insieme di località Google che sono potenziali corrispondenze alla richiesta specificata, elencate in ordine decrescente. |
ServiceAreaBusiness
Le attività al domicilio del cliente forniscono i propri servizi presso la sede del cliente (ad es. un fabbro o un idraulico).
Campi | |
---|---|
business_type |
Obbligatorio. Indica [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] dell'attività al domicilio del cliente. |
places |
L'area servita da questa attività è definita da un insieme di luoghi. |
region_code |
Immutabile. Codice regione CLDR del paese o della regione in cui ha sede l'attività al domicilio del cliente. Per informazioni dettagliate, visita i siti 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 in caso contrario viene ignorato. La regione specificata qui può essere diversa dalle regioni delle aree servite da questa attività (ad es. le 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 il suo rappresentante autorizzato deve essere in grado di ricevere posta all'indirizzo di verifica fornito. |
BusinessType
Indica se questa attività offre servizi solo presso la 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 consegne anche ai clienti).
Enum | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Solo output. Non specificato. |
CUSTOMER_LOCATION_ONLY |
Offre il servizio solo nell'area circostante (non presso l'indirizzo dell'attività). Se un'attività viene aggiornata da CUSTOMER_AND_BUSINESS_LOCATION a CUSTOMER_LOCATION_ONLY, l'aggiornamento della località deve includere la maschera di campo storefront_address e impostare il campo su vuoto. |
CUSTOMER_AND_BUSINESS_LOCATION |
Offre il servizio presso l'indirizzo dell'attività e nell'area circostante. |
ServiceItem
Un messaggio che descrive un singolo elemento del servizio. È utilizzato per descrivere il tipo di servizio fornito dal commerciante. Ad esempio, taglio di capelli può essere un servizio.
Campi | |
---|---|
price |
Campo facoltativo. Rappresenta il prezzo monetario dell'articolo di servizio. Ti consigliamo di impostare currency_code e unità quando includi un prezzo. Verrà considerato un prezzo fisso per l'articolo del servizio. |
Campo di unione service_item_info . Uno dei seguenti campi deve essere sempre impostato. service_item_info può essere solo uno dei seguenti: |
|
structured_service_item |
Campo facoltativo. Questo campo imposterà il caso dei dati dei servizi strutturati. |
free_form_service_item |
Campo facoltativo. Questo campo imposterà la distinzione tra maiuscole e minuscole per i dati dei servizi in formato libero. |
FreeFormServiceItem
Rappresenta un servizio in formato libero offerto dal commerciante. Questi sono servizi che non sono esposti nei dati dei nostri servizi strutturati. Il commerciante inserisce manualmente i nomi di questi servizi tramite una piattaforma geomerchant.
Campi | |
---|---|
category |
Obbligatorio. Questo campo rappresenta il nome della categoria (ovvero l'ID stabile della categoria). |
label |
Obbligatorio. Etichette dell'elemento con tag della lingua. È consigliabile che i nomi degli elementi non superino i 140 caratteri e le descrizioni non superino i 250 caratteri. Questo campo deve essere impostato solo se l'input è un elemento di servizio personalizzato. I tipi di servizi standardizzati devono essere aggiornati tramite service_type_id. |
StructuredServiceItem
Rappresenta un servizio strutturato offerto dal commerciante. Ad esempio: toilet_installation.
Campi | |
---|---|
service_type_id |
Obbligatorio. Il campo |
description |
Campo facoltativo. Descrizione dell'elemento di servizio strutturato. Il limite di caratteri è 300. |
ServiceType
Messaggio che descrive un tipo di servizio offerto dall'attività.
Campi | |
---|---|
service_type_id |
Solo output. Un ID stabile (fornito da Google) per questo tipo di servizio. |
display_name |
Solo output. Il nome leggibile visualizzato per il tipo di servizio. |
SpecialHourPeriod
Rappresenta un singolo periodo di tempo in cui gli orari di apertura di una sede differiscono dal normale orario di apertura. Un periodo di ore speciale deve rappresentare un intervallo inferiore a 24 ore. open_time
e start_date
devono essere precedenti a close_time
e end_date
. close_time
e end_date
possono essere estesi fino alle 11:59 del giorno successivo a start_date
specificato. Ad esempio, i seguenti input sono validi:
start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59
I seguenti input non sono validi:
start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00
Campi | |
---|---|
start_date |
Obbligatorio. La data di calendario in cui inizia questo periodo di ora speciale. |
open_time |
Campo 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 |
end_date |
Campo facoltativo. La data di calendario in cui termina questo periodo di ora speciale. Se il campo |
close_time |
Campo 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 |
Campo facoltativo. Se il valore è true, |
SpecialHours
Rappresenta una serie di periodi di tempo in cui gli orari di apertura di una sede sono diversi dal normale orario di apertura.
Campi | |
---|---|
special_hour_periods[] |
Obbligatorio. Un elenco di eccezioni all'orario normale dell'attività. |
TimePeriod
Rappresenta un intervallo di tempo in cui l'attività è aperta, a partire dal giorno/ora di apertura specificati e fino alla chiusura nel giorno/ora di chiusura specificati. L'orario di chiusura deve essere successivo all'orario di apertura, ad esempio più tardi dello stesso giorno o in un giorno successivo.
Campi | |
---|---|
open_day |
Obbligatorio. Indica il |
open_time |
Obbligatorio. I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato. |
close_day |
Obbligatorio. Indica il |
close_time |
Obbligatorio. I valori validi sono 00:00-24:00, dove 24:00 rappresenta la mezzanotte alla fine del campo del giorno specificato. |
UpdateAttributesRequest
Richiesta di AttributesService.UpdateAttributes.
Campi | |
---|---|
attributes |
Una raccolta di attributi che devono essere aggiornati. |
attribute_mask |
Obbligatorio. Nome degli attributi che vuoi aggiornare. Rappresentato da Aggiornamenti: tutti gli attributi forniti nel campo degli attributi che vuoi aggiornare devono essere impostati nel campo Eliminazioni: se vuoi eliminare determinati attributi, devi specificarli nel |
UpdateLocationRequest
Messaggio di richiesta per locations.UpdateLocation.
Campi | |
---|---|
location |
Obbligatorio. Le informazioni sulla posizione aggiornate. |
update_mask |
Obbligatorio. I campi specifici da aggiornare. |
validate_only |
Campo facoltativo. Se il valore è true, la richiesta viene convalidata senza aggiornare effettivamente la località. Quando questo campo è impostato, verranno restituiti solo errori di convalida. La risposta sarà vuota se non sono stati trovati errori. |
UriAttributeValue
Valori per un attributo con value_type
di URL.
Campi | |
---|---|
uri |
Obbligatorio. Il valore dell'URI proposto per questo attributo. |