Package google.mybusiness.businessinformation.v1

Indice

AttributesService

Consente ai client di cercare e aggiornare gli attributi di una determinata località.

GetAttributes

rpc GetAttributes(GetAttributesRequest) returns (Attributes)

Cerca tutti gli attributi impostati per una determinata località.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

GetGoogleUpdatedAttributes

rpc GetGoogleUpdatedAttributes(GetGoogleUpdatedAttributesRequest) returns (Attributes)

Visualizza la versione aggiornata da Google della località specificata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

Restituisce l'elenco degli attributi che sarebbero disponibili per una località con la categoria principale e il paese specificati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

UpdateAttributes

rpc UpdateAttributes(UpdateAttributesRequest) returns (Attributes)

Aggiorna gli attributi per una località specifica.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

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

rpc BatchGetCategories(BatchGetCategoriesRequest) returns (BatchGetCategoriesResponse)

Restituisce un elenco di categorie aziendali per gli ID lingua e GConcept forniti.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

ListCategories

rpc ListCategories(ListCategoriesRequest) returns (ListCategoriesResponse)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

Catene

Un servizio per la ricerca di informazioni su una catena di attività.

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

Restituisce la catena specificata. Restituisce NOT_FOUND se la catena non esiste.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

Cerca la catena in base al suo nome.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

GoogleLocations

Questa API consente l'accesso e la ricerca in GoogleLocation.

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

Cerca tutte le possibili posizioni che corrispondono alla richiesta specificata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

Località

Questa API consente di gestire le sedi dell'attività commerciale su Google.

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

Crea una nuova posizione che sarà di proprietà dell'utente che ha eseguito l'accesso.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

Elimina una posizione.

Se questa sede non può essere eliminata utilizzando l'API ed è contrassegnata in google.mybusiness.businessinformation.v1.LocationState, utilizza il sito web di Profilo dell'attività su Google.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetGoogleUpdatedLocationRequest) returns (GoogleUpdatedLocation)

Visualizza la versione aggiornata da Google della località specificata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

GetLocation

rpc GetLocation(GetLocationRequest) returns (Location)

Restituisce la località specificata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

Elenca le sedi dell'account specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

Aggiorna la località specificata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

AdWordsLocationExtensions

Informazioni aggiuntive visualizzate in AdWords.

Campi
ad_phone

string

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

string

Obbligatorio. Il nome della risorsa per questo attributo.

value_type

AttributeValueType

Solo output. Il tipo di valore contenuto in questo attributo. Questo dovrebbe essere utilizzato per determinare come interpretare il valore.

values[]

Value

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

RepeatedEnumAttributeValue

Quando il tipo di valore dell'attributo è REPEATED_ENUM, contiene il valore dell'attributo, mentre gli altri campi devono essere vuoti.

uri_values[]

UriAttributeValue

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

string

L'identificatore univoco dell'attributo.

value_type

AttributeValueType

Il tipo di valore dell'attributo. I valori impostati e recuperati devono essere di questo tipo.

display_name

string

Il nome visualizzato localizzato per l'attributo, se disponibile; in caso contrario, il nome visualizzato in inglese.

group_display_name

string

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

bool

Se true, l'attributo supporta più valori. Se il valore è false, deve essere specificato un solo valore.

value_metadata[]

AttributeValueMetadata

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

bool

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

Value

Il valore dell'attributo.

display_name

string

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

string

Obbligatorio. Identificatore di Google per questa località sotto forma di locations/{location_id}/attributes.

attributes[]

Attribute

Una raccolta di attributi che devono essere aggiornati.

BatchGetCategoriesRequest

Messaggio di richiesta relativo a BusinessCategories.BatchGetBusinessCategories.

Campi
names[]

string

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

string

Obbligatorio. Il codice della lingua BCP 47 in cui devono essere restituiti i nomi delle categorie.

region_code

string

Campo facoltativo. Il codice paese ISO 3166-1 alpha-2 utilizzato per dedurre una lingua non standard.

view

CategoryView

Obbligatorio. Specifica le parti alla risorsa Categoria da restituire nella risposta.

BatchGetCategoriesResponse

Messaggio di risposta per BusinessCategories.BatchGetBusinessCategories.

Campi
categories[]

Category

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[]

TimePeriod

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

Category

Obbligatorio. Categoria che descrive meglio l'attività principale di questa sede.

additional_categories[]

Category

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

string

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

string

Solo output. Il nome leggibile della categoria. Questa impostazione viene impostata durante la lettura della posizione. Quando modifichi la località, è necessario impostare category_id.

service_types[]

ServiceType

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

more_hours_types[]

MoreHoursType

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

string

Obbligatorio. Il nome della risorsa della catena, nel formato chains/{chain_id}.

chain_names[]

ChainName

I nomi della catena.

websites[]

ChainUri

Siti web della catena.

location_count

int32

Numero di sedi che fanno parte di questa catena.

ChainName

Nome da utilizzare quando si visualizza la catena.

Campi
display_name

string

Il nome visualizzato per questa catena.

language_code

string

Il codice lingua BCP 47 del nome.

ChainUri

URL da utilizzare per la visualizzazione della catena.

Campi
uri

string

L'URI di questa catena.

CreateLocationRequest

Messaggio di richiesta per locations.CreateLocation.

Campi
parent

string

Obbligatorio. Il nome dell'account in cui creare questa sede.

location

Location

Obbligatorio. I nuovi metadati relativi alla posizione.

validate_only

bool

Campo facoltativo. Se il valore è true, la richiesta viene convalidata senza creare effettivamente la località.

request_id

string

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

string

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

string

Obbligatorio. Identificatore di Google per questa località sotto forma di locations/{location_id}/attributes.

GetChainRequest

Messaggio di richiesta per locations.GetChain.

Campi
name

string

Obbligatorio. Il nome della risorsa della catena, nel formato chains/{chain_place_id}.

GetGoogleUpdatedAttributesRequest

Richiesta di AttributesService.GetGoogleUpdatedAttributes.

Campi
name

string

Obbligatorio. Identificatore di Google per questa località sotto forma di locations/{location_id}/attributes.

GetGoogleUpdatedLocationRequest

Messaggio di richiesta per locations.GetGoogleUpdatedLocation.

Campi
name

string

Obbligatorio. Il nome della posizione da recuperare.

read_mask

FieldMask

Obbligatorio. Maschera di lettura per specificare quali campi verranno restituiti nella risposta.

GetLocationRequest

Messaggio di richiesta per locations.GetLocation.

Campi
name

string

Obbligatorio. Il nome della posizione da recuperare.

read_mask

FieldMask

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

string

Nome risorsa di questa GoogleLocation, nel formato googleLocations/{googleLocationId}.

location

Location

Le informazioni Location scarsamente compilate. Questo campo può essere riutilizzato in CreateLocation se non è attualmente rivendicato da un utente.

request_admin_rights_uri

string

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

Location

La versione aggiornata da Google di questo luogo.

diff_mask

FieldMask

I campi aggiornati da Google.

pending_mask

FieldMask

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

string

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

description

string

Campo facoltativo. Descrizione del listino prezzi, della sezione o dell'elemento.

language_code

string

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

string

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

string

L'ID stabile della categoria principale per trovare gli attributi disponibili. Deve essere nel formato categorie/{category_id}.

region_code

string

Il codice paese ISO 3166-1 alpha-2 per trovare gli attributi disponibili.

language_code

string

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

bool

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

int32

Il numero di attributi da includere per pagina. Il valore predefinito è 200, il minimo è 1.

page_token

string

Se specificato, viene recuperata la pagina successiva dei metadati degli attributi.

ListAttributeMetadataResponse

Risposta per AttributesService.ListAttributeMetadata.

Campi
attribute_metadata[]

AttributeMetadata

Una raccolta di metadati degli attributi per gli attributi disponibili.

next_page_token

string

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 attributes.list. Se non ci sono altri attributi, questo campo non sarà presente nella risposta.

ListCategoriesRequest

Messaggio di richiesta relativo a BusinessCategories.ListCategories.

Campi
region_code

string

Obbligatorio. Il codice paese ISO 3166-1 alpha-2.

language_code

string

Obbligatorio. Il codice lingua BCP 47.

filter

string

Campo facoltativo. Filtra stringa da utente. L'unico campo supportato è displayName. Ad esempio: filter=displayName=foo.

page_size

int32

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

string

Campo facoltativo. Se specificata, verrà recuperata la pagina successiva di categorie.

view

CategoryView

Obbligatorio. Specifica le parti alla risorsa Categoria da restituire nella risposta.

ListCategoriesResponse

Messaggio di risposta per BusinessCategories.ListCategories.

Campi
categories[]

Category

Le categorie corrispondenti in base ai parametri richiesti.

next_page_token

string

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

ListLocationsRequest

Messaggio di richiesta per locations.ListLocations.

Campi
parent

string

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

int32

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

string

Campo facoltativo. Se specificato, recupera le località successive (page). Il token di pagina viene restituito dalle precedenti chiamate a ListLocations quando la posizione è maggiore di quella che rientra nelle dimensioni di pagina richieste.

filter

string

Campo facoltativo. Un filtro che vincola le località da restituire. La risposta include solo le voci che corrispondono al filtro. Se filter è vuoto, i vincoli vengono applicati e tutte le posizioni (suddivise in pagine) vengono recuperate per l'account richiesto.

Per ulteriori informazioni sui campi validi e sull'utilizzo di esempio, consulta la Guida all'utilizzo dei dati sulla posizione.

order_by

string

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

FieldMask

Obbligatorio. Maschera di lettura per specificare quali campi verranno restituiti nella risposta.

ListLocationsResponse

Messaggio di risposta per locations.ListLocations.

Campi
locations[]

Location

Le località.

next_page_token

string

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 ListLocations. Se non ci sono altre località, questo campo non è presente nella risposta.

total_size

int32

Il numero approssimativo di località nell'elenco indipendentemente dall'impaginazione. Questo campo verrà restituito solo se filter viene utilizzato come parametro di ricerca.

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

string

Identificatore di Google per questa località nel formato: locations/{location_id}.

language_code

string

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

store_code

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

phone_numbers

PhoneNumbers

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

categories

Categories

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

storefront_address

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

website_uri

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.

regular_hours

BusinessHours

Campo facoltativo. Orario di apertura dell'attività.

special_hours

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.

service_area

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.

ad_words_location_extensions

AdWordsLocationExtensions

Campo facoltativo. Informazioni aggiuntive visualizzate in AdWords.

latlng

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.

open_info

OpenInfo

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

metadata

Metadata

Solo output. Informazioni aggiuntive non modificabili dall'utente.

profile

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

RelationshipData

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

more_hours[]

MoreHours

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

service_items[]

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.

Metadati

Ulteriori informazioni sulla sede non modificabili dall'utente.

Campi
has_google_updated

bool

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 getGoogleUpdated per cercare le informazioni che devono essere verificate.

has_pending_edits

bool

Solo output. Indica se le proprietà di questa località sono in stato di modifica in attesa.

can_delete

bool

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

can_operate_local_post

bool

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

can_modify_service_list

bool

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

can_have_food_menus

bool

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

can_operate_health_data

bool

Solo output. Indica se la posizione può operare sui dati sanitari.

can_operate_lodging_data

bool

Solo output. Indica se la posizione può operare sui dati dell'alloggio.

place_id

string

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

string

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

maps_uri

string

Solo output. Un link alla località su Maps.

new_review_uri

string

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

can_have_business_calls

bool

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

has_voice_of_merchant

bool

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

string

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[]

TimePeriod

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

string

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

display_name

string

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

localized_display_name

string

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

OpenInfo

Informazioni relative allo stato di apertura dell'attività.

Campi
status

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.

can_reopen

bool

Solo output. Indica se questa attività è idonea per la riapertura.

opening_date

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

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 di assistenza centrale.

additional_phones[]

string

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

string

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

place_id

string

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[]

PlaceInfo

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

string

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

RelevantLocation

La sede principale con cui è correlata questa sede.

children_locations[]

RelevantLocation

L'elenco dei luoghi dei bambini con cui questa località è correlata.

parent_chain

string

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

string

Obbligatorio. Specifica la località che si trova dall'altro lato della relazione tramite il relativo PlaceID.

relation_type

RelationType

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[]

string

Enumera i valori impostati.

unset_values[]

string

Enumera i valori che non sono stati impostati.

SearchChainsRequest

Messaggio di richiesta per locations.SearchChains.

Campi
chain_name

string

Obbligatorio. Cerca una catena in base al nome. Sono supportate query esatte/parziali/parziali/correlate. Esempi: "walmart", "wal-mart", "walmmmart", "沃尔玛"

page_size

int32

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[]

Chain

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

int32

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

Location

Località da cercare. Se fornito, troverai le sedi che corrispondono ai dettagli sulla posizione forniti.

query

string

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[]

GoogleLocation

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

BusinessType

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

places

Places

L'area servita da questa attività è definita da un insieme di luoghi.

region_code

string

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

Money

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

StructuredServiceItem

Campo facoltativo. Questo campo imposterà il caso dei dati dei servizi strutturati.

free_form_service_item

FreeFormServiceItem

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

string

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

label

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

string

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

description

string

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

string

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

display_name

string

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

Date

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

open_time

TimeOfDay

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 è false.

end_date

Date

Campo facoltativo. La data di calendario in cui termina questo periodo di ora speciale. Se il campo end_date non è impostato, viene impostata la data predefinita in start_date. Se impostato, questo campo deve essere uguale o al massimo 1 giorno dopo start_date.

close_time

TimeOfDay

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 è false.

closed

bool

Campo facoltativo. Se il valore è true, end_date, open_time e close_time vengono ignorati e la data specificata in start_date viene considerata come la sede chiusa per l'intera giornata.

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[]

SpecialHourPeriod

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

DayOfWeek

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

open_time

TimeOfDay

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

close_day

DayOfWeek

Obbligatorio. Indica il day of the week il giorno di fine di questo periodo.

close_time

TimeOfDay

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

Attributes

Una raccolta di attributi che devono essere aggiornati.

attribute_mask

FieldMask

Obbligatorio. Nome degli attributi che vuoi aggiornare. Rappresentato da attributes/{attribute}.

Aggiornamenti: tutti gli attributi forniti nel campo degli attributi che vuoi aggiornare devono essere impostati nel campo attribute_mask. Gli attributi impostati nell'elenco precedente ma non in attribute_mask verranno ignorati.

Eliminazioni: se vuoi eliminare determinati attributi, devi specificarli nel attribute_mask senza alcuna voce corrispondente nell'elenco degli attributi. Se vuoi eliminare tutti gli attributi impostati su una località, devi cercare tutti gli attributi applicabili per la località e aggiungerli a attribute_mask con il campo degli attributi vuoto.

UpdateLocationRequest

Messaggio di richiesta per locations.UpdateLocation.

Campi
location

Location

Obbligatorio. Le informazioni sulla posizione aggiornate.

update_mask

FieldMask

Obbligatorio. I campi specifici da aggiornare.

validate_only

bool

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

string

Obbligatorio. Il valore dell'URI proposto per questo attributo.