Package google.maps.booking.v1alpha

string

L'URL del punto di contatto per questo link di azione.

string

Il tag lingua BCP-47 che identifica la lingua in cui sono disponibili i contenuti di questo URI.

string

Codice paese ISO 3166-1 alpha-2. Lascia vuoto per visibilità senza limitazioni.

ActionPlatform

La piattaforma su cui deve essere eseguita questa azione. Se questo campo non è impostato, verrà utilizzato ACTION_PLATFORM_WEB_APPLICATION come valore predefinito.

ActionLinkType

Tipo di azione predeterminato.

OrderOnlineMetadata

Metadati per il link online dell'ordine. Supporta l'azione con ActionLinkType di ACTION_LINK_TYPE_SHOP_ONLINE.

FoodOrderingMetadata

Metadati per i link alle ordinazioni di cibo. Supporta il tipo di azione: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT NON supporta ACTION_LINK_TYPE_ORDER_FOOD.

EventMetadata

Ulteriori informazioni sul link di azione univoco per il verticale Eventi.

Surface

Piattaforma di eventi predeterminata associata a un link di azioni. Viene utilizzato solo per il verticale Eventi.

string

Identificatore. Nome della risorsa di AdsAccountLink. Formato: partners/{partner}/adsAccountLinks/{ads_account_link}

string

Obbligatorio. Elenco degli ID articolo dell'inventario da collegare all'account Google Ads.

State

Solo output. Stato del collegamento dell'account Google Ads.

Text

Messaggio personalizzato da mostrare all'utente prenotando tramite Prenota con Google.

Timestamp

Ora di inizio dello spazio per appuntamenti.

Duration

Durata dello spazio per appuntamenti

int64

Numero di spot totali e di spot disponibili di questa disponibilità. Esempi:

• Corso di yoga in 10 luoghi di cui 3 prenotati: availability {spots_total: 10, spots_open: 7 ...}
• Sessione di massaggio poltrone già al completo: availability {spots_total: 1, spots_open: 0 ...}

Nota: se invii richieste utilizzando il formato di compressione della disponibilità definito di seguito, verranno dedotti questi due campi.

• Una ricorrenza implica spots_total=1 e spots_open=1.
• Un'eccezione ScheduleException implica spots_total=1 e spots_open=0.

int64

Numero di posti disponibili.

string

Una stringa opaca facoltativa per identificare questa slot di disponibilità. Se impostato, verrà incluso nelle richieste che prenotano/aggiornano/annullano gli appuntamenti.

Resources

Risorse facoltative utilizzate per distinguere questo spazio di disponibilità da altri quando diversi membri del personale o stanze fanno parte del servizio.

Ad es. la stessa lezione di yoga con due 2 istruttori:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }

string

Un elenco di ID che fanno riferimento alle opzioni di pagamento che possono essere utilizzati per pagare lo slot. Le opzioni di pagamento effettive sono definite a livello di commerciante e possono essere condivise anche tra più commercianti.

Questo campo sostituisce qualsiasi payment_option_id specificato nel messaggio di servizio. Allo stesso modo, payment_option_id specificati qui, NON deve essere presente nel messaggio di servizio, ma deve essere definito a livello di commerciante.

Recurrence

Informazioni sulla ricorrenza per la disponibilità, che rappresentano più di un'ora di inizio. Una ricorrenza deve contenere appuntamenti per un giorno lavorativo.

ScheduleException

Periodi in cui questo servizio non può essere pianificato. Per limitare il numero di messaggi schedule_exception, valuta la possibilità di unire le eccezioni adiacenti.

Deposit

Deposito facoltativo per questa disponibilità. Sostituisce il deposito per il servizio, se specificato.

NoShowFee

È facoltativo pagare una penale per mancata presentazione per questa disponibilità. Sostituisce la tariffa per il mancato arrivo, se specificata.

Prepayment

(Facoltativo) Informazioni facoltative sul pagamento anticipato per questa disponibilità.

RequireCreditCard

Indica se l'utente deve fornire una carta di credito per prenotare questa fascia di disponibilità. Se il valore non è impostato, viene ereditato dal livello di servizio, se impostato. (facoltativo)

string

Indica un elenco dei tipi di biglietti supportati per questo intervallo di disponibilità. Se il criterio non viene configurato, per questo spazio sono disponibili tutti i tipi di ticket nel servizio principale. Tieni presente che i valori di questo campo devono essere definiti nel servizio principale. Esempi:

• Servizio con quattro tipi di biglietti: TicketType {ticket_type_id: "adult_1" Short_description: "Adult weekenddays"} TicketType {ticket_type_id: "adult_2" short_description: "Adult weekends"} TicketType {ticket_type_id: "youth_1" Short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" Short_description: "Weekend per ragazzi"}

Per rappresentare l'inventario durante i giorni feriali: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. Per rappresentare l'inventario durante le festività: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

• Servizio con tre tipi di biglietti: TicketType {ticket_type_id: "adult" Short_description: "Adult"} TicketType {ticket_type_id: "youth" Short_description: "Youth"} TicketType {ticket_type_id: "senior" Short_description: "Senior"}

Per indicare che tutti e tre i tipi di biglietti sono disponibili per questa fascia oraria, utilizza availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} o "disponibilità {...}" (non impostare ticket_type_id in questo spazio).

(facoltativo)

DurationRequirement

Il requisito che richiede di mostrare la durata e/o l'ora di fine degli slot. Questo campo verrà ignorato se lo slot non è disponibile. Non utilizzato nel verticale Cose da fare. (facoltativo)

SchedulingRuleOverrides

Regole di pianificazione della disponibilità. Se i campi sono compilati, sostituiranno eventuali regole di pianificazione corrispondenti in SchedulingRules a livello di servizio.

ConfirmationMode

La modalità di conferma che verrà utilizzata per prenotare questa disponibilità. I tentativi di creare prenotazioni per le disponibilità con una modalità di conferma CONFIRMATION_MODE_SYNCHRONOUS devono essere confermati o rifiutati immediatamente. I tentativi di creare prenotazioni per le disponibilità con la modalità di conferma CONFIRMATION_MODE_ASYNCHRONOUS devono essere rifiutati immediatamente o creati con lo stato PENDING.

LinkoutRequiredReason

(Facoltativo) Il motivo per cui è necessario un linkout per questo slot. Se impostato, la risorsa Merchant per questa area deve avere un LinkoutTemplate valido. (facoltativo)

Timestamp

Il timestamp UTC massimo incluso fino al quale si ripete la disponibilità.

Duration

Definisce l'intervallo di tempo tra fasce orarie di disponibilità successive.

Esempio: una disponibilità con una durata di 20 minuti, una ripetizione ogni 30 minuti, un'ora di inizio iniziale delle 9:00 e una ripetizione fino alle 11:00 produrrà slot tra le 9:00 e le 09:20, dalle 9:30 alle 09:50, dalle 10:00 alle 10:20, dalle 10:30 alle 10:10 e dalle 10:00 alle 10:10. (obbligatorio)

TimeRange

L'intervallo di tempo dell'eccezione. Gli spazi descritti dalla ricorrenza che si sovrappongono a questo intervallo di tempo tra chiusura e apertura saranno considerati non disponibili.

Esempio: se la ricorrenza specifica una durata di 20 minuti, una ripetizione ogni 30 minuti, un'ora di inizio 9:00 e una ripetizione fino alle 11:00, una ScheduleException con un intervallo di tempo di 9:45-11:00 renderà non disponibili gli slot alle 9:30-9:50 e alle 10:30-10:30.

Tieni presente che, poiché l'intervallo di tempo è chiuso, lo slot che inizia alle 11:00 non sarà interessato.

int64

L'ultima ora (in secondi) in cui è possibile prenotare questo spazio. Questo timestamp deve precedere start_sec dello slot da rispettare (se gli utenti devono poter effettuare prenotazioni dopo l'ora di inizio, utilizza SchedulingRules.min_booking_before_end_time a livello di servizio). Se presente, sostituirà qualsiasi valore specificato in min_booking_buffer delle SchedulingRules del servizio corrispondente.

int64

La prima volta (in secondi) in cui è possibile prenotare questo intervallo. Questo timestamp deve precedere start_sec della fascia oraria o last_bookable_sec, se specificato.

int64

Se impostato, indica l'ultima volta (in secondi dall'epoca di Unix) in cui questo spazio per appuntamenti specifico può essere annullato tramite Prenota con Google. Questo campo sostituirà eventuali regole di annullamento a livello di servizio. (facoltativo)

string

Nome della risorsa, che ha il formato - partners/{partner_id}/feeds/{feed_name}.

GenericDeleteRecord

Record da eliminare. In una chiamata API sono consentiti al massimo 1000 record.

string

Nome della risorsa, che ha il formato - partners/{partner_id}/feeds/{feed_name}.

GenericRecord

Record da inserire e/o aggiornare. Sono consentiti massimo 1000 record in una chiamata API.

string

Formato di partners/{partner_id}.

ExtendedServiceAvailability

La disponibilità del servizio estesa utilizzata per sostituire gli slot di disponibilità esistenti.

ExtendedServiceAvailability

I messaggi di disponibilità del servizio esteso aggiornati correttamente che sono stati utilizzati per sostituire gli slot di disponibilità esistenti.

string

Nome della risorsa della prenotazione: partners/{partner ID}/bookings/{booking ID}

string

ID del commerciante per l'area

string

ID del servizio commerciante

Timestamp

Ora di inizio dello spazio per appuntamenti

Duration

Durata dello spazio per appuntamenti

ClientInformation

Informazioni personali del cliente che fissa l'appuntamento

BookingStatus

Stato della prenotazione

PaymentInformation

Informazioni sulle transazioni di pagamento relative alla prenotazione.

int64

Numero di persone della prenotazione

Cause

Il motivo della mancata riuscita della prenotazione. (obbligatorio)

CreditCardType

(obbligatorio solo se la causa è PAYMENT_ERROR_CARD_TYPE_REJECTED)

string

Questo campo facoltativo viene utilizzato dal partner per includere informazioni aggiuntive solo a scopo di debug. (facoltativo)

PaymentFailureInformation

Informazioni sugli errori di pagamento.

ThreeDS1Parameters

Parametri utilizzati da un aggregatore RwG per avviare un protocollo di autenticazione 3DS1 con l'utente. Verrà ignorato a meno che BookingFailure.cause non sia impostato su PAYMENT_REQUIRES_3DS1.

string

L'URL da cui caricare un modulo da presentare all'utente per l'autenticazione.

string

Una richiesta PaymentAuthentication. Da pubblicare nel modulo ACSUrl, se fornito.

string

Un identificatore utilizzato dal provider ACS. Da pubblicare nel modulo ACSUrl, se fornito.

string

Dati del commerciante. Da pubblicare nel modulo ACSUrl, se fornito.

RefundCondition

Zero o più condizioni di rimborso applicabili alle norme.

Duration

Durata prima dell'ora di inizio, fino al momento in cui il cliente può ricevere un rimborso per una parte del costo del servizio specificato in refund_percent. Se impostato su 0 (valore predefinito), il servizio può essere annullato in qualsiasi momento.

uint32

La percentuale rimborsabile, a condizione che la prenotazione del servizio venga annullata almeno min_duration_before_start_time prima dell'ora di inizio del servizio, compreso nell'intervallo [0, 100]. Se il valore è impostato su 0 (valore predefinito), il servizio non è rimborsabile. Se il valore è impostato su 100, il servizio è completamente rimborsabile.

string

Nome del cliente

string

Cognome del cliente

PostalAddress

Indirizzo del client

string

Numero di telefono del cliente

string

Indirizzo email del client

string

Obbligatorio. La risorsa padre in cui verrà creato questo collegamento all'account Google Ads. Corrisponde all'ID account del Centro partner. Formato: partners/{partner}

string

Obbligatorio. L'ID da utilizzare per il collegamento dell'account Google Ads. Corrisponde all'ID cliente Google Ads. Per maggiori dettagli, consulta la pagina https://support.google.com/google-ads/answer/1704344 Formato : xxx-xxx-xxxx.

AdsAccountLink

Obbligatorio. Il link all'account Ads da creare.

string

Il nome della risorsa padre per il partner proprietario di questo commerciante, nel formato partners/{partner_id}.

string

L'ID commerciante da utilizzare per questo commerciante.

Merchant

Il commerciante da creare.

string

Il nome della risorsa principale del commerciante proprietario di questo servizio, nel formato partners/{partner_id}/merchants/{merchant_id}.

string

L'ID servizio da utilizzare per questo servizio.

Service

Il servizio da creare.

CreditCardType

Un elenco di carte di credito supportate. Se non sono presenti, non sono supportate carte di credito.

string

Obbligatorio. Il nome del collegamento dell'account Google Ads da eliminare. Formato: partners/{partner}/adsAccountLinks/{ads_account_link}

string

Il nome della risorsa del commerciante da eliminare. Nel formato partners/{partner_id}/merchants/{merchant_id}

string

Il nome della risorsa del servizio da eliminare. Nel formato partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Price

Importo del deposito.

int64

Annullamento minimo anticipato per il deposito.

PriceType

Definisce la modalità di determinazione del deposito in base alla disponibilità.

Text

Consigliamo agli utenti di pagare solo tramite i metodi di pagamento indicati di seguito.

Duration

Durata minima.

Duration

Durata massima.

Text

Obbligatorio. Nome, indirizzo, numero di telefono e indirizzo email dell'operatore economico, definito come il produttore, il rappresentante autorizzato, l'importatore, il distributore, il fornitore di servizi di distribuzione o qualsiasi altra persona fisica o giuridica soggetta a obbligazioni relative alla produzione di prodotti, alla loro disponibilità o alla loro messa in servizio. Rappresentazione stringa in formato libero di economic_operator. Queste informazioni possono essere formattate utilizzando " " e "\n".

string

Questo è un campo obbligatorio necessario per specificare a quale commerciante appartengono i messaggi di disponibilità riportati di seguito.

string

Questo è un campo obbligatorio obbligatorio per specificare a quale servizio appartengono i messaggi sulla disponibilità riportati di seguito.

Timestamp

Se fornite, le entità Disponibilità fornite verranno considerate uno snapshot completo da [start_time_restrict, end_time_restrict]. In altre parole, tutta la disponibilità esistente verrà eliminata se è vera la seguente condizione:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Se è impostato un messaggio sulla durata, la condizione è ulteriormente limitata:

  availability.duration == duration_restrict

Se viene impostato un messaggio resource_restrict, la condizione è ulteriormente limitata:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Questi campi vengono in genere utilizzati per fornire un aggiornamento completo della disponibilità in un determinato intervallo di tempo.

Se imposti start_time_restrict e lasci il valore end_time_restrict non impostato, il valore viene interpretato come tutti i tempi a partire da start_time_restrict.

Timestamp

L'impostazione di end_time_restrict lasciando start_time_restrict non impostato viene interpretata come tutti i tempi fino a end_time_restrict.

Duration

L'impostazione della durata limita ulteriormente l'ambito dell'aggiornamento alla sola disponibilità con durata corrispondente.

Resources

L'impostazione resources_restrict limita ulteriormente l'ambito dell'aggiornamento solo a questo insieme di risorse. Tutti i campi ID delle risorse devono corrispondere esattamente.

Availability

Il nuovo elenco di disponibilità.

int64

Elementi appena aggiunti da questo feed. Gli elementi possono essere commercianti, servizi o fasce orarie di disponibilità, a seconda del tipo di feed.

int64

Articoli esistenti, aggiornati secondo necessità dalle informazioni più recenti del feed.

int64

Gli articoli non sono più presenti in questo feed e sono stati rimossi di conseguenza.

string

Il nome della risorsa del feed, che ha il formato

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

State

Lo stato di elaborazione di questo feed.

string

Stringa leggibile che fornisce ulteriori dettagli se non è stato possibile elaborare il feed.

FeedStatistics

Statistiche specifiche di questo feed.

FeeDetails

Dettagli delle commissioni addebitate all'utente oltre al totale dell'articolo. Ripetuto per diversi tipi di commissioni, come commissione di servizio, commissione di consegna e così via.

AdvanceOrderDetails

Dettagli sul supporto degli ordini avanzati, noto anche come ordine in anticipo, con cui l'utente può effettuare un ordine per l'evasione degli ordini in un momento successivo rispetto a quello attuale.

Duration

Durata fissa. Ad esempio: 30 min.

DurationRange

Un intervallo di durata. Esempi: * 30-45 min * Più di 30 min * Meno di 50 min

bool

True se gli Ordini anticipati, noti anche come Ordine in anticipo, sono supportati. (obbligatorio)

FeeType

Tipo di tariffa. (obbligatorio)

FeeAmount

Importo della tariffa in valuta unitaria, una percentuale del valore del carrello o una combinazione di entrambi. (obbligatorio)

QuantitativeValue

Tariffa in termini di percentuale del valore del carrello. Supporta un intervallo (limitato e illimitato) o una percentuale fissa. Il valore deve essere compreso tra 0 e 100. Esempi: * Fisso 5,5% * Almeno 5,5% * Al massimo 5,5% * Da 4,5% a 5,5%

Money

Importo fisso. Ad esempio 3,50 $.

MoneyRange

Intervallo di importo. Esempi: * Da 3,5 € a 5,5 € * Almeno 3,5 € * Massimo 5,5 €

bool

Importo sconosciuto.

FulfillmentType

Obbligatorio. Il tipo di completamento.

AvailableDay

Obbligatorio. Un elenco di giorni in cui è disponibile questo metodo di evasione degli ordini (preferibilmente almeno 2).

FeeDetails

Obbligatorio. Dettagli delle commissioni per il metodo di evasione degli ordini.

Price

Obbligatorio. Ordine minimo per il metodo di evasione degli ordini associato al link all'azione.

Date

Obbligatorio. Una data disponibile per un metodo di evasione degli ordini. Si presume che si tratti del fuso orario del commerciante.

Timestamp

Obbligatorio. Timestamp Unix. L'ultima volta che un utente poteva ordinare e ricevere articoli entro il giorno fulfillment_date. In altre parole, dopo last_ordering_time, fulfillment_date non verrà più mostrato come disponibile.

Ad esempio, se il valore di fulfillment_date è 2020-08-10: - un valore last_ordering_time pari a 2020-08-10 18:00 indica che, per ricevere l'ordine il 10-08-2020, un cliente deve effettuarlo entro le 18:00 dello stesso giorno. - un valore last_ordering_time pari a 08-08-2020 20:00 indica che, per ricevere l'ordine il 10-08-2020, un cliente deve effettuare l'ordine entro le 20:00 di due giorni prima.

NoFee

Nessuna commissione per il metodo di evasione degli ordini.

MinimumFee

La tariffa di base associata al metodo di evasione degli ordini.

FixedFee

La tariffa fissa associata al metodo di evasione degli ordini.

Price

Obbligatorio. L'importo della tariffa fissa per il metodo di evasione degli ordini.

Price

Obbligatorio. L'importo della tariffa di base per il metodo di evasione degli ordini.

Timestamp

Obbligatorio. Questo timestamp viene utilizzato per determinare l'ordine in cui un'eliminazione verrà applicata all'inventario.

bytes

Per i feed non basati su protocollo.

Any

Per i feed basati su proto.

Timestamp

Obbligatorio. Questo timestamp viene utilizzato per garantire l'ordinamento corretto degli aggiornamenti dell'inventario.

bytes

Per i feed non basati su protocollo.

Any

Per feed basati su proto.

double

Latitudine in gradi. (facoltativo)

double

Longitudine in gradi. (facoltativo)

PostalAddress

Indirizzo postale della località, preferito.

string

Come opzione di riserva, è possibile fornire anche un indirizzo non strutturato. Ad es. "Vista di montagna con anfiteatro 1600, ca 94043 ca"

string

Obbligatorio. Il nome del collegamento dell'account Google Ads da recuperare. Formato: partners/{partner}/adsAccountLinks/{ads_account_link}

string

Obbligatorio. Nome della risorsa, nel formato partners/{partner_id}/merchants/{merchant_id}/status.

string

Il nome della risorsa del feed, che ha il formato

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

string

La categoria di alto livello a cui appartiene questo servizio a domicilio. Ad es. idraulico, elettricista e così via.

string

Il tipo di lavoro nella categoria a cui appartiene il servizio per la casa in questione. Ad esempio, unclog_drain, install_faucet sono i tipi di lavoro nella categoria idraulico.

string

Il nome della risorsa da invalidare.

Ad esempio, per una risorsa di ritiro, il nome deve avere il formato partners/{partner_id}/pickups/{pickup_id}. Le implementazioni DEVONO rimuovere le versioni memorizzate nella cache della risorsa identificata.

string

ID del servizio del commerciante.

int64

Ora di inizio dell'appuntamento in secondi di tempo UTC dall'epoca Unix.

int64

Durata dell'appuntamento in secondi.

OrderedTickets

Numero di biglietti ordinati per tipo di biglietto.

Price

Il prezzo totale (tasse escluse) di questo elemento pubblicitario.

BookingStatus

Stato dell'elemento pubblicitario.

string

ID di un tipo di biglietto.

int32

Numero di biglietti ordinati per questo tipo.

string

Obbligatorio. La società madre, proprietaria di questa raccolta di stati del commerciante. Formato: partners/{partner_id}/merchants

int32

Obbligatorio. Il numero massimo di articoli da restituire. Tieni presente che il server potrebbe ridurre le dimensioni della pagina.

string

(Facoltativo) Il valore nextPageToken restituito da un precedente ListMerchantStatusResponse, se presente.

BookingInventoryStatus

(Facoltativo) Limitazione facoltativa per filtrare i risultati in base allo stato dell'inventario di prenotazione.

WaitlistInventoryStatus

(Facoltativo) Limitazione facoltativa per filtrare i risultati in base allo stato dell'inventario della lista d'attesa.

GeoMatchingStatus

(Facoltativo) Limitazione facoltativa per filtrare i risultati in base allo stato della corrispondenza geografica.

MerchantStatus

Elenco di stati dei commercianti che soddisfano le condizioni del filtro.

string

Token per recuperare la pagina successiva dei risultati. Se il campo è vuoto, non ci sono altri risultati nell'elenco.

string

Il nome della risorsa del feed, che ha il formato

• partners/{partner_id}/feeds/merchants
• partners/{partner_id}/feeds/services
• partners/{partner_id}/feeds/availability

int32

Il numero massimo di elementi da restituire.

string

Il valore next_page_token restituito da una precedente richiesta di elenco, se presente.

State

Limitazione facoltativa per filtrare i risultati per stato del feed.

TimeRange

(Facoltativo) Limita per filtrare i risultati in base ai limiti superiore e inferiore. Se il valore start_time non è impostato, verrà usato per impostazione predefinita l'inizio del tempo unix. Se il valore di end_time non è impostato, il valore predefinito sarà la data e l'ora attuali.

FeedStatus

Elenco cronologico inverso degli stati dei feed caricati. Il numero massimo di elementi restituiti si basa sul campo page_size nella richiesta.

string

Token per recuperare la pagina successiva dei risultati. Se il campo è vuoto, non ci sono altri risultati nell'elenco.

string

Codice lingua IETF BCP 47, ad esempio "it", "mas", "zh-Hant", "de-CH-1901". Vedi http://www.w3.org/International/articles/language-tags/.

string

Messaggio nelle impostazioni internazionali precedenti (UTF-8).

string

L'ID luogo di un luogo nel database di Google Places e su Google Maps. Per saperne di più sugli ID luogo, visita la pagina https://developers.google.com/places/web-service/place-id. Se viene fornito, Google abbinerà la posizione a questo luogo.

string

Il nome, il numero di telefono, l'URL e i dati geografici della posizione vengono utilizzati per consentire la corrispondenza della località con i luoghi già presenti su Google Maps.

Questo campo è facoltativo, ma potrebbe essere obbligatorio in alcuni contesti. Ad esempio, un Service.location senza un nome non verrà associato a un'entità aziendale, anche se si trova allo stesso indirizzo. (facoltativo)

string

Il numero di telefono pubblico della stazione di ricarica, inclusi il codice paese e il prefisso, ad esempio +14567891234. (facoltativo)

string

L'URL del sito web pubblico della stazione di ricarica. (facoltativo)

GeoCoordinates

Le informazioni geografiche della posizione, inclusi latitudine, longitudine e indirizzo. (facoltativo)

LocationType

Il tipo di località, da fornire se la località è fornita per un servizio.

string

Riferimento univoco della località all'interno del servizio. Questo ID può essere utilizzato per fare riferimento a questa posizione in altri campi del servizio. Ad es. nel modulo di accettazione personalizzato, è possibile utilizzare una serie di ID località per specificare le opzioni di ritiro. Se impostato, questo ID deve essere univoco all'interno dello stesso servizio. (facoltativo)

string

Il nome della risorsa del commerciante, che ha il formato partners/{partner_id}/merchants/{merchant_id}.

string

Merchant_name, phone, url e dati geografici vengono utilizzati per supportare la corrispondenza dell'inventario dei partner con i commercianti già presenti su Google Maps. Queste informazioni non verranno visualizzate.

Il nome del commerciante.

string

Il numero di telefono pubblico del commerciante, inclusi i codici paese e di area, ad esempio +14567891234.

string

L'URL del sito web pubblico del commerciante.

GeoCoordinates

Le informazioni geografiche del commerciante, inclusi latitudine, longitudine e indirizzo.

string

La categoria dell'attività nella piattaforma dell'aggregatore.

int64

Campo obsoleto.

uint32

L'aliquota fiscale del commerciante in punti base (un centesimo di un percento). Ad esempio, se l'aliquota fiscale è del 7,5%, questo campo deve essere impostato su 750.

Se questo campo non viene configurato o viene impostato su 0, il prezzo totale addebitato a un utente per qualsiasi servizio fornito da questo commerciante corrisponde al prezzo esatto specificato da Service.price. Si presume che il prezzo del servizio sia esente dalle tasse applicabili o già comprensivo di tasse. Le imposte non verranno mostrate all'utente come voce separata.

Se questo campo è impostato su un valore diverso da zero, il prezzo totale addebitato a un utente per qualsiasi servizio fornito da questo commerciante includerà il prezzo del servizio più l'imposta calcolata utilizzando l'aliquota fiscale fornita qui. Le frazioni dell'unità di valuta più piccola (ad esempio, le frazioni di un centesimo) verranno arrotondate utilizzando l'arrotondamento pari più prossimo. Le imposte verranno mostrate all'utente come voce separata.

Questo campo è obsoleto. Utilizza il valore Tax_rate.

TaxRate

L'aliquota fiscale del commerciante. Se presente, questo campo sostituisce il campo tax_rate_basis_points ritirato. Un messaggio vuoto (ad es. tax_rate { }) reimposta l'aliquota fiscale applicata su zero.

PaymentRestrictions

Limitazioni relative ai metodi di pagamento accettati da questo commerciante. Se questo campo non è impostato, si presume che non esistano restrizioni.

PaymentOption

Opzioni di pagamento disponibili per questo commerciante. I servizi di questo commerciante potranno limitare singolarmente le opzioni di pagamento consentite.

PaymentProcessorConfig

Configurazione per un elaboratore dei pagamenti con token, se il commerciante lo supporta.

TokenizationConfig

Configurazione per un elaboratore dei pagamenti con token, se il commerciante lo supporta.

Terms

I Termini e condizioni del commerciante specifico mostrati all'utente quando viene prenotato un servizio tramite Prenota con Google. Oltre a questi, i Termini e condizioni del partner aggregatore vengono sempre mostrati all'utente e non devono essere forniti qui.

string

Una stringa opaca che identifica il brand rivolto ai consumatori da utilizzare per visualizzare l'attribuzione del partner. Questo campo consente ai partner con più brand rivolti ai consumatori di fornire commercianti per tutti i brand all'interno dello stesso feed.

Un brand è costituito da proprietà rivolte ai consumatori, come il nome, il logo, i Termini di servizio e le Norme sulla privacy.

Se esiste un solo brand partner rivolto ai consumatori, questo campo non deve essere impostato e può essere ignorato.

Se il partner…

Non ha più brand rivolti ai consumatori? --> Ignora questo campo

Sono stati configurati più brand?

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

Nota importante: la maggior parte dei partner non ha bisogno di impostare questo campo. Se un partner vuole utilizzare questo campo, deve prima contattarci per configurare brand separati, incluso quello predefinito.

MerchantMatchingHints

Suggerimenti per aiutare Google ad abbinare un commerciante a un luogo su Google Maps. Nota: la maggior parte dei partner non deve impostare questo campo, in quanto Google assocerà i commercianti ai luoghi su Google Maps utilizzando le informazioni fornite sopra. (facoltativo)

ServiceAttribute

Definizioni di tutti gli attributi dei servizi utilizzati per descrivere i Servizi per questo Commerciante. (facoltativo)

ActionLink

(Facoltativo) Un URL dell'azione con lingua associata, elenco di paesi a cui è limitato, tipo e piattaforma facoltativa che indica la piattaforma su cui deve essere eseguita questa azione

Advisement

(Facoltativo) Consigli generali di un commerciante specifico per un utente che si iscrive a una lista d'attesa tramite Prenota con Google. I singoli campi di testo nell'avviso devono avere una lunghezza massima di 100 byte.

EconomicOperator

(Facoltativo) Informazioni sull'operatore economico associate a questo commerciante specifico necessarie per la conformità normativa. (facoltativo)

string

L'ID luogo di un luogo nel database di Google Places e su Google Maps. Per saperne di più sugli ID luogo, visita la pagina https://developers.google.com/places/web-service/place-id.

string

Il nome della risorsa di stato del commerciante, che ha il formato partners/{partner_id}/merchants/{merchant_id}/status

string

Nome del commerciante fornito dai partner.

GeoCoordinates

I partner hanno fornito le informazioni geografiche del commerciante.

ProcessingStatus

Stato di elaborazione del commerciante.

BookingStatus

Stato relativo all'integrazione end-to-end delle prenotazioni.

WaitlistStatus

Stato relativo all'integrazione della lista d'attesa.

PlaceInfo

Luogo geografico corrispondente di questo commerciante. Vuoto se il commerciante non ha una corrispondenza geografica.

LocalServicesMatchInfo

Corrispondenza di Servizi locali di questo commerciante. Il campo è vuoto se non è un commerciante di servizi locali o non corrisponde ad alcun fornitore.

DirectUrl

Un elenco di URL per dimostrare i contenuti dell'inventario corrente del commerciante. Tieni presente che questo non significa che l'inventario venga effettivamente pubblicato e che l'URL potrebbe essere diverso da quelli visibili al pubblico.

bool

True se il commerciante ha un inventario nei prossimi 30 giorni. Non garantisce che il commerciante venga effettivamente pubblicato.

UrlType

Tipo di URL.

string

URL che potrebbe mostrare questo commerciante.

MatchedProvider

Fornitori di servizi corrispondenti. Un commerciante può essere associato a più fornitori di servizi.

int64

ID cliente esterno di Servizi locali di Google.

string

Categorie di servizi locali (verticali). Ad esempio, "idraulico" e "pulizia_tappeti".

string

Nome del luogo.

string

Indirizzo formattato nella lingua locale.

string

ID Google Place di questo luogo. Può essere utilizzato per creare l'URL di Google Maps o recuperare più dettagli sul luogo. Per un esempio di utilizzo, visita la pagina https://developers.google.com/places/web-service/place-id.

bool

True se il commerciante offre un servizio in lista d'attesa. Non garantisce che il commerciante venga effettivamente pubblicato.

Money

Importo minimo.

Money

Importo massimo.

Price

L'importo che potrebbe essere addebitato all'utente se non si presenta per la prenotazione.

PriceType

Definisce come viene determinata la tariffa dalla disponibilità.

string

Nome della risorsa dell'ordine: partners/{partner ID}/orders/{order ID}

ClientInformation

Dati personali del cliente che effettua l'ordine.

PaymentInformation

Informazioni sulle transazioni di pagamento relative all'ordine.

string

ID del commerciante a cui appartengono tutti i servizi di questo ordine.

LineItem

Elementi pubblicitari in questo ordine.

FulfillmentOption

Opzioni di evasione degli ordini disponibili per un link di azione online per l'ordine.

PrepaymentStatus

Stato del pagamento anticipato della prenotazione. Se prepayment_status è PREPAYMENT_PROVIDED o PREPAYMENT_REFUNDED, Payment_transaction_id contiene l'ID transazione univoco associato.

string

Identificatore univoco di una transazione di pagamento associata alla prenotazione. Vuoto se non applicabile.

string

Questo ID viene utilizzato per identificare l'opzione di pagamento.

Questo ID è globale per l'intero aggregatore e il riutilizzo di un valore in più commercianti consentirà a un utente di pagare con l'opzione di pagamento corrispondente in tutti i commercianti.

Quando viene riutilizzato un documento di identità per più commercianti, l'aggiornamento del valore di un'opzione di pagamento per un commerciante comporta anche l'aggiornamento di qualsiasi altra opzione di pagamento con lo stesso ID, per un altro commerciante. Pertanto, è buona norma che tutte le opzioni di pagamento condividano lo stesso ID e vengano sempre aggiornate con valori identici per evitare qualsiasi possibilità di comportamento fraudolento.

string

Il nome dell'opzione di pagamento. Questo può essere visibile all'utente.

string

Una descrizione dell'opzione di pagamento. Può essere visibile all'utente.

Price

Il prezzo dell'opzione di pagamento.

TaxRate

L'aliquota fiscale per questa opzione di pagamento. Se presente, questo campo sostituisce il campo Tax_rate presente nel Commerciante o nel Servizio. Un messaggio vuoto (ad es. tax_rate { }) reimposta l'aliquota fiscale applicata su zero.

PaymentOptionType

Il tipo di questa opzione di pagamento. Uso singolo per i drop-in, multiuso per i pacchetti e illimitato per gli abbonamenti.

int64

Il numero di sessioni per le quali è possibile utilizzare questa opzione di pagamento. Valido solo per più sessioni / pacchetti, dove il valore deve essere > 1.

TimeRange

L'opzione di pagamento può essere acquistata entro questo intervallo.

TimeRange

L'opzione di pagamento può essere utilizzata entro questo intervallo di tempo (ad es. prezzo speciale per gennaio 2017). Se presente, sostituisce valid_duration e activation_type.

Duration

Durata della validità dell'opzione di pagamento (ad es. abbonamento di 30 giorni).

ActivationType

Definisce in che modo viene determinata la data di inizio della validità per questa opzione di pagamento.

UserPurchaseRestriction

Limita gli utenti idonei all'acquisto di questa opzione di pagamento. Può essere utilizzato per limitare un'opzione di pagamento promozionale a un sottoinsieme di utenti. Se non viene impostato, tutti gli utenti sono idonei.

Processor

Definisce il partner elaboratore dei pagamenti a cui si applica questa configurazione.

string

La chiave utilizzata per identificare questo commerciante con l'elaboratore dei pagamenti.

Per Stripe, visita la pagina: https://stripe.com/docs/dashboard#api-keys Per Braintree, visita la pagina: https://articles.braintreepayments.com/control-panel/important-gateway-credentials

string

Il numero di versione dell'API inviato all'elaboratore dei pagamenti insieme alle richieste di pagamento.

CreditCardRestrictions

Limitazioni relative alle carte di credito accettate da questo commerciante. Se questo campo non è impostato, si presume che tutte le carte di credito siano accettate. Tieni presente che l'elenco delle carte supportate da CreditCardType aumenterà nel tempo, il che significa che se lasci vuoto questo campo, la configurazione sarà soggetta a modifiche future.

Price

Una commissione che può variare in base al metodo di consegna.

Price

Una commissione per l'elaborazione del metodo di pagamento dell'utente.

Price

Un addebito extra per un servizio.

Price

Una commissione che va alla sede/struttura.

Price

Imposte per biglietto.

string

Il paese, specificato mediante il codice paese ISO 3166-1 alpha-2, ad esempio "US" (obbligatorio)

string

Località, ad es. "Milano". (obbligatorio)

string

La regione, ad esempio "CA". Questo campo è obbligatorio solo nei paesi in cui la regione fa comunemente parte dell'indirizzo. (facoltativo)

string

Il codice postale, ad esempio "94043". (obbligatorio)

string

L'indirizzo, ad esempio "1600 Amphitheatre Pkwy". (obbligatorio)

PriceInfo

Contenitore per i dettagli sui prezzi.

int64

Il prezzo in micro-unità della valuta. Le frazioni dell'unità di valuta più piccola verranno arrotondate utilizzando l'arrotondamento al numero pari più vicino. (ad es. per 2,5 centesimi di dollaro arrotondati a 2 centesimi, 3,5 centesimi arrotondati a 4 centesimi, 0,5 centesimi arrotondati a 0 centesimi, 2,51 centesimi arrotondati a 3 centesimi).

string

La valuta del prezzo definita nella norma ISO 4217.

string

Una stringa facoltativa e opaca che identifica l'opzione di prezzo associata al prezzo esteso.

PriceType

Definisce come viene applicato il prezzo o la fascia di prezzo (a persona o fisso)

Price

Il prezzo di un servizio o una commissione.

PriceRange

Il limite superiore e/o inferiore di un servizio o di una commissione.

Price

Importo minimo.

Price

Importo massimo. Deve sempre essere > prezzo_min.

double

Un valore singolare. Ad esempio: 5.6

RangeValue

Un intervallo di valori che può anche essere aperto o limitato. Esempi: * Almeno 5,5 * Al massimo 5,5 * Da 5,5 a 6,5

double

Valore minimo.

double

Valore massimo.

double

Valore della valutazione media (obbligatorio se number_of_ratings > 0). Il valore deve essere compreso nell'intervallo [1, 5] e può essere omesso se e solo se il numero_di_valutazioni è pari a zero.

uint64

Numero di valutazioni utilizzate per calcolare il valore (obbligatorio).

string

L'URL di questa origine di contenuti multimediali. Google eseguirà la scansione dei contenuti multimediali ospitati in questo URL.

MediaType

Tipo di questa sorgente multimediale.

Text

Didascalia dei contenuti multimediali che supportano i18n. È supportato solo il testo normale. Verranno rimossi tutti i componenti HTML. (facoltativo)

Attribution

Informazioni sull'attribuzione sulla fonte dei contenuti multimediali. Tieni presente che, se l'attribuzione deve essere visualizzata insieme ai media per citare il fotografo o l'agenzia, è necessario impostare questo campo. (facoltativo)

string

Deprecato, preferibile usare localized_caption.

Text

Il testo da citare al fotografo o all'agenzia che ha supportato i18n. Questo testo verrà visualizzato insieme ai contenuti multimediali di origine. Tieni presente che per questo campo è supportato solo il testo normale, tutti i componenti HTML verranno rimossi (l'attribuzione basata su link ipertestuale non è supportata).

string

Ritirato, è preferibile utilizzare localized_text.

ServiceAvailability

La disponibilità del servizio utilizzata per sostituire quelle esistenti.

string

ID facoltativo per un membro del personale che fornisce il servizio. Questo campo identifica il membro del personale in tutti i record di commercianti, servizi e disponibilità. Inoltre, deve essere stabile nel tempo per consentire la correlazione con le prenotazioni passate. Questo campo deve essere presente se staff_name è presente.

string

Nome facoltativo di un membro del personale che fornisce il servizio. Questo campo verrà mostrato agli utenti che effettuano una prenotazione e deve essere leggibile, invece di un identificatore opaco. Questo campo deve essere presente se staff_id è presente.

string

Un ID facoltativo per la stanza in cui si trova il servizio. Questo campo identifica la camera in tutti i record di commercianti, servizi e disponibilità. Inoltre, deve essere stabile nel tempo per consentire la correlazione con le prenotazioni passate. Questo campo deve essere presente se è presente room_name.

string

Un nome facoltativo per la stanza in cui si trova il servizio. Questo campo verrà mostrato agli utenti che effettuano una prenotazione e deve essere leggibile, invece di un identificatore opaco. (facoltativo, ma obbligatorio se è presente room_id) Nella sala da pranzo il nome di una sala deve essere utilizzato solo per la zona salotto, come il bar o il patio, e non per menu a prezzo fisso, attività speciali o qualsiasi altro valore diverso da quello della camera (come una prenotazione o una cena). È vivamente consigliato che alla zona con posti a sedere predefinita non sia associata una stanza.

int32

Applicabile solo per i pasti: il numero di persone che possono essere ospitati in questa fascia oraria. Un ristorante può essere associato a più slot per volta, ognuno specificando un valore party_size diverso, se, ad esempio, 2, 3 o 4 persone possono sedere al momento della prenotazione.

Text

(Facoltativo) Descrizione localizzata della stanza. Se impostato, è necessario fornire un valore predefinito. È preferibile fornire anche lingue comuni per la lingua del commerciante. (facoltativo)

int64

Il preavviso minimo in secondi necessario per annullare un appuntamento prenotato online. (facoltativo)

Price

La tariffa per l'annullamento entro il periodo di preavviso minimo.

Price

La commissione per il mancato arrivo senza cancellazione.

AdmissionPolicy

Le norme di ammissione che si applicano a questo servizio. Se non viene configurato, il valore predefinito è TIME_STRICT. (facoltativo)

CancellationPolicy

Criterio di annullamento delle regole di pianificazione. (obbligatorio per Cose da fare)

int64

La durata (in secondi) da quando può essere effettuata l'ultima prenotazione a quando inizia lo slot di disponibilità.

int64

La durata (in secondi) dal momento in cui è possibile effettuare l'ultima prenotazione a quello in cui termina lo spazio di disponibilità. Se questo campo è impostato, il campo "admission_policy" deve essere impostato su TIME_FLEXIBLE per indicare che gli utenti possono utilizzare i biglietti acquistati dopo l'inizio degli slot.

string

Il nome della risorsa di servizio, nel formato partners/{partner_id}/merchants/{merchant_id}/services/{service_id}.

string

Il nome del servizio, ad esempio "Taglio capelli uomo". Deprecato, utilizza invece localized_service_name.

Text

Il nome del servizio, ad esempio "Taglio di capelli da uomo". Possibilmente in più lingue.

string

La descrizione visibile all'utente del servizio. Deprecato, usa localized_description al suo posto.

Text

La descrizione del servizio visibile all'utente.

Questo campo supporta sia il testo normale sia la formattazione simile a HTML. A differenza delle sezioni di testo normale, qui è possibile creare layout personalizzati utilizzando intestazioni, paragrafi, elenchi e alcuni tag di frase. Leggi attentamente le istruzioni e le note riportate di seguito per assicurarti di creare un'esperienza utente ottimale.

Tag di formattazione simili a HTML supportati:

Tag heading: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
I tag heading possono essere utilizzati per visualizzare titoli e sottotitoli. Ad esempio, <h1>Itinerario</h1> mostrerà il testo in linea come l'intestazione più importante della sezione. Tieni presente che eventuali tag, stili o attributi HTML interni verranno ignorati. Ad esempio, <h1 style=".."> verrà trattato come <h1>. Verrà conservato solo il testo puro.

Tag paragrafo: <p>
Il tag paragrafo può essere utilizzato per mettere in evidenza un'introduzione o dei contenuti dettagliati. Eventuali tag, stili o attributi interni verranno ignorati, con alcune eccezioni: <br>, <strong> e <em>. Per ulteriori dettagli, consulta la sezione sui tag a frase di seguito.

Tag elenco: <ul>, <ol>, <li>
Il tag <ul> può essere utilizzato con il tag <li> per visualizzare elenchi non ordinati, mentre il tag <ol> può essere utilizzato con <li> per visualizzare elenchi ordinati. È un buon modo per mostrare elenchi di controllo, pianificazioni o qualsiasi altro elenco adatto ai tuoi casi d'uso.
Esempio: per mostrare un elenco delle caratteristiche di un viaggio in crociera:
<ol>
<li>Splendida vista sull'oceano e possibilità di giocare con gli animali selvatici.</li>
<li>Servizi e servizi di viaggio ben progettati.</li>
<li>Prezzo più basso garantito.</li>
</ol>
Tieni presente che solo <li> bambini di età inferiore a <ul> o <ol> verranno convertiti. Tutti gli altri account secondari verranno eliminati. Inoltre, verranno ignorati tutti i tag, gli attributi e gli stili interni; conserviamo solo contenuti testuali.

Tag di divisione: <div>
Tutti i tag interni supportati del tag <div> verranno analizzati con le regole indicate sopra, il che implica che il tag <div> stesso non indica alcun raggruppamento o rientro. Inoltre, eventuali attributi e stili interni verranno ignorati.

Tag a frase: <br>, <strong>, <em>:
sono supportati solo i tre tag menzionati in precedenza. &lt;br&gt; può essere utilizzato per interrompere le righe nei paragrafi e <strong>/<em> può essere utilizzata per evidenziare testo importante. Eventuali altri tag di frase verranno ignorati.

Tag non supportati:

• I tag <html>, <header> e <body> non sono consentiti.
• Tutti gli altri tag non menzionati sopra non sono supportati (ad esempio <table>, <td> ...).
  Gli URL, gli ancoraggi e i link verranno rimossi e non saranno mai mostrati agli utenti finali. Se vuoi utilizzare le foto per creare un'esperienza utente completa, utilizza il link "related_media" campo sottostante per inviare gli URL delle tue foto.
  

Note importanti:

• Cerca di non utilizzare altri tag, ad eccezione di quelli supportati sopra indicati, perché i contenuti all'interno dei tag non supportati verranno rimossi e potrebbero portare a un'esperienza utente indesiderata.
  
• Prova a evitare strutture nidificate profonde, come più di tre diversi livelli di intestazione o elenchi nidificati. Mantieni la struttura piatta, semplice e lineare per creare un'esperienza utente migliore.
  
• Se i layout attualmente supportati non sono sufficienti per i tuoi casi d'uso, contatta il team di Prenota con Google.
  
• La dimensione massima consigliata è di 32.000 caratteri.

Price

Il prezzo del servizio.

PriceInterpretation

Descrive in che modo il prezzo viene interpretato e mostrato all'utente. Può essere utilizzato da qualsiasi verticale, ad eccezione di Ristoranti e Cose da fare, per configurare la visualizzazione del prezzo del servizio.

SchedulingRules

Regole per prenotare/annullare un appuntamento.

PrepaymentType

Indica se un pagamento anticipato è obbligatorio, facoltativo o non supportato.

PrepaymentTerms

Termini relativi al completamento del pagamento anticipato.

ServiceIntakeForm

Deprecato. Utilizza intake_form e per_ticket_intake_form.

ServiceIntakeForm

Un modulo per richiedere ulteriori informazioni all'utente quando prenota questo servizio. (facoltativo)

ServiceIntakeForm

Un modulo che richiede all'utente ulteriori informazioni al momento della prenotazione di questo servizio. Questo modulo deve essere compilato una volta per ogni biglietto che l'utente sta prenotando. (facoltativo)

TaxRate

L'aliquota fiscale del servizio. Se presente, questo campo sostituisce qualsiasi aliquota impostata a livello di commerciante. Un messaggio vuoto (ad es. tax_rate { }) reimposta l'aliquota fiscale applicata su zero.

string

Un elenco di ID che fanno riferimento alle opzioni di pagamento utilizzabili per pagare questo servizio. Le opzioni di pagamento effettive sono definite a livello di commerciante e possono essere condivise anche tra più commercianti.

Deposit

Definisce la modalità di addebito di un deposito all'utente. Sostituisce il deposito per il servizio, se specificato. L'impostazione di un messaggio Deposito vuoto comporta la rimozione dell'eventuale deposito a livello di servizio. (facoltativo)

NoShowFee

Definisce una tariffa per mancata presentazione che potrebbe essere addebitata all'utente. Sostituisce la tariffa per mancata presentazione al servizio, se specificata. L'impostazione di un messaggio NoShowFee vuoto comporta la rimozione di eventuali commissioni per il mancato arrivo a livello di servizio. (facoltativo)

RequireCreditCard

Indica se l'utente deve fornire una carta di credito per prenotare questo servizio. Questo campo può essere sostituito a livello di disponibilità. (facoltativo)

ActionLink

Un link ad un'azione correlata a questo servizio. Se il link all'azione esiste, il tipo (vedi di seguito) deve essere impostato nel servizio.

ServiceType

Il tipo predefinito di questo servizio. (facoltativo)

TicketType

Tipi di biglietti che possono essere prenotati/acquistati per questo servizio, se i biglietti sono supportati. (facoltativo)

RelatedMedia

Foto relative a questo servizio. Google eseguirà la scansione e memorizzerà i contenuti multimediali per assicurarsi che vengano mostrati agli utenti finali nel modo più efficiente. (facoltativo)

ServiceAttributeValueId

(Facoltativo) Valori degli attributi del servizio che si applicano a questo servizio. Ogni servizio può avere zero o più valori per ogni attributo del servizio definito nel commerciante corrispondente. (facoltativo)

WaitlistRules

Regole per l'iscrizione alla lista d'attesa.

TicketingVerticalSpecificData

Informazioni aggiuntive specifiche per il verticale della vendita di biglietti per eventi. (facoltativo)

IntegrationType

Livello di integrazione supportato per questo servizio. (Facoltativo) Non pertinente per i partner con l'integrazione iniziale. La modalità end-to-end sarà sempre disattivata per questi partner.

PerOrderFee

Commissioni a livello di ordine per l'acquisto di questo servizio. (facoltativo)

ToursAndActivitiesContent

Campi dei contenuti specifici di Tour e Attività.

Location

Località correlate a questo servizio. NOTE IMPORTANTI: se sono presenti più località visitate correlate a questo servizio o se START_LOCATION è diverso da VISITED_LOCATION, è necessario specificare START_LOCATION. Esempio: - Un tour in bici guidato che visita tre sedi. È necessario specificare la sede di partenza. - Un tour in autobus che parte dalla hall di un hotel e si dirige verso la sede visitata. È necessario specificare la sede della riunione.

Rating

La valutazione degli utenti per questo servizio come metrica aggregata per tutte le recensioni.

HomeServiceData

Informazioni aggiuntive specifiche per il verticale dei servizi per la casa. (facoltativo)

VirtualSession

(Facoltativo) Informazioni sulla sessione virtuale. È obbligatorio per abilitare i servizi virtuali.

DirectMerchantPayment

(Facoltativo) Ulteriori informazioni che devono essere aggiunte se il servizio richiede all'utente di pagare direttamente al commerciante. NOTA IMPORTANTE: RwG non è coinvolta in questa transazione. È obbligatorio se è definita virtual_session e il servizio non è senza costi o se prepayment_type NON è impostato su REQUIRED.

UriTemplate

(Facoltativo) Un modello facoltativo che specifica in che modo Google deve generare gli URL dei siti esterni.

ChargeTiming

Quando viene eseguito l'addebito in base al momento dell'acquisto.

int64

Tempo in secondi prima dell'ora di inizio del servizio in cui all'utente viene addebitato il pagamento. Questo campo deve essere impostato solo quando ChargeTiming è CHARGE_LATER.

string

Un identificatore che identifica in modo univoco questo attributo di servizio tra gli altri per lo stesso commerciante, ad esempio "account-type".

string

Un nome visibile all'utente per questo attributo, ad esempio "Tipo di account".

Value

Tutti i valori possibili per questo attributo di servizio.

string

Un identificatore che identifica in modo univoco questo valore tra gli altri per l'attributo di servizio, ad esempio "personale".

string

Un nome visibile all'utente per il valore, ad esempio "Personale".

string

ID di un attributo come definito in Merchant.service_attribute, ad esempio "service-type".

string

ID del valore di questo attributo, ad es. "taglio di capelli". Deve corrispondere a un value_id nella definizione dell'attributo del servizio.

string

Il nome della risorsa del servizio a cui applicarlo. Nel formato partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Timestamp

Se fornite, le entità Disponibilità fornite verranno considerate uno snapshot completo da [start_time_restrict, end_time_restrict]. In altre parole, tutta la disponibilità esistente verrà eliminata se si verifica la seguente condizione:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

Se è impostato un messaggio sulla durata, la condizione è ulteriormente limitata:

  availability.duration == duration_restrict

Se viene impostato un messaggio resource_restrict, la condizione è ulteriormente limitata:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

Questi campi vengono in genere utilizzati per fornire un aggiornamento completo della disponibilità in un determinato intervallo di tempo.

Se imposti start_time_restrict e lasci il valore end_time_restrict non impostato, il valore viene interpretato come tutti i tempi a partire da start_time_restrict.

Timestamp

L'impostazione di end_time_restrict lasciando start_time_restrict non impostato viene interpretata come tutti i tempi fino a end_time_restrict.

Duration

L'impostazione della durata limita ulteriormente l'ambito dell'aggiornamento alla sola disponibilità con durata corrispondente.

Resources

L'impostazione resources_restrict limita ulteriormente l'ambito dell'aggiornamento solo a questo insieme di risorse. Tutti i campi ID delle risorse devono corrispondere esattamente.

Availability

Il nuovo elenco di disponibilità.

ServiceIntakeFormField

Campi che verranno mostrati all'utente.

bool

Se impostato su true, questo modulo verrà mostrato ai nuovi clienti. Deprecato. Questa funzionalità non è supportata per i moduli di accoglienza.

bool

Se impostato su true, questo modulo verrà mostrato ai clienti abituali. Deprecato. Questa funzionalità non è supportata per i moduli di accoglienza.

string

Una stringa di un partner aggregatore che identifica in modo univoco un campo del modulo. Questo ID deve essere uguale all'ID nella risposta del campo corrispondente del modulo e deve essere univoco sia nel livello di servizio sia nel modulo di accettazione delle richieste di assistenza. (obbligatorio)

FieldType

Il tipo di questo campo.

string

Il testo mostrato all'utente per questo campo. Deprecato, usa localized_label.

Text

Il testo mostrato all'utente per questo campo. Il campo può essere specificato in più impostazioni internazionali. (obbligatorio)

string

Imposta se e solo se il tipo di campo è LOCATION_SEARCH. Utilizza "location_id" nel campo "location" per specificare il valore della località.

Text

Impostalo solo se il tipo di campo è MULTIPLE_CHOICE, CHECKBOXES o DROPDOWN. Utilizzato per elencare le possibili scelte.

bool

Indica se un utente richiede una risposta a questo campo.

bool

Indica se è consentito un valore personalizzato in aggiunta alle risposte predefinite. Questo vale solo se il tipo di campo è LOCATION_SEARCH. (facoltativo)

Text

Opzioni aggiuntive fornite oltre ai valori specificati. Applicabile solo quando il tipo di campo è LOCATION_SEARCH. Ad esempio, oltre all'elenco di sedi fornito, un'altra opzione disponibile può essere "Contattarò il fornitore in un secondo momento". (facoltativo)

string

Se questa domanda deve essere mostrata solo quando l'utente prenota determinati tipi di biglietti, questo campo deve essere impostato come l'insieme di ID tipo di biglietto applicabili. Lascia vuoto il campo se la domanda è sempre applicabile.

Text

Il testo del suggerimento per l'input, che viene visualizzato come segnaposto di testo. Ciò è applicabile solo quando il tipo di campo è SHORT_ANSWER o paragraph. (facoltativo)

int32

Un'aliquota fiscale in milionesimi dell'uno per cento, che fornisce effettivamente 6 decimali di precisione. Ad esempio, se l'aliquota fiscale è 7,253%, questo campo deve essere impostato su 7253000.

Se questo campo non viene configurato o viene impostato su 0, il prezzo totale addebitato a un utente per qualsiasi servizio fornito da questo commerciante corrisponde al prezzo esatto specificato da Service.price. Si presume che il prezzo del servizio sia esente o già comprensivo delle imposte applicabili. Le imposte non verranno mostrate all'utente come voce separata.

Se questo campo è impostato su un valore diverso da zero, il prezzo totale addebitato a un utente per qualsiasi servizio fornito da questo commerciante includerà il prezzo del servizio più l'imposta calcolata utilizzando l'aliquota fiscale fornita qui. Le frazioni dell'unità di valuta più piccola (ad esempio le frazioni di un centesimo) verranno arrotondate utilizzando l'arrotondamento al numero pari più vicino. Le imposte verranno mostrate all'utente come voce separata.

string

Facoltativamente, l'URL dei Termini e condizioni.

string

Il testo da mostrare all'utente. Utilizza localized_text di seguito per le nuove integrazioni.

Text

Il testo localizzato da mostrare all'utente.

string

Valore di testo in una lingua sconosciuta. Obbligatorio se e solo se localized_value è vuoto. Le impostazioni internazionali per questo valore possono dipendere dal partner o dal fornitore di servizi e non si deve presumere che si tratti di una lingua specifica.

LocalizedString

Valori di testo per ogni lingua. (Facoltativo)

string

L'ID richiesta viene utilizzato per distinguere i diversi tipi di richieste dello stesso servizio e deve essere univoco solo all'interno di un servizio.

string

Una breve descrizione per questo TicketType.

Questo può essere visibile all'utente, ad esempio "adulto", "bambino", "veterano", "Riga J" e così via. Obbligatorio: ogni tipo di biglietto deve avere una descrizione per essere visibile all'utente. Deprecato. Utilizza localized_short_description.

Text

Una breve descrizione di questo TicketType con supporto i18n.

Può essere visibile all'utente, ad esempio "adulto", "bambino", "veterano", "Riga J" e così via. Obbligatorio: ogni tipo di biglietto deve avere una descrizione per essere visibile all'utente. È possibile fornire valori separati per ogni lingua.

Price

Il prezzo di un singolo biglietto di questo tipo, escluse le tasse. Ai biglietti del Servizio si applica l'aliquota fiscale del servizio.

PerTicketFee

Costi aggiuntivi per l'acquisto di questo biglietto. (facoltativo)

PriceDisplayType

(Facoltativo) Tipo di visualizzazione del prezzo predeterminato per un biglietto singolo di questo tipo.

string

Descrizione di qualsiasi opzione aggiuntiva rappresentata da questo tipo di ticket, se presente. Deprecato, utilizza invece localized_option_description.

Text

Descrizione di qualsiasi opzione aggiuntiva rappresentata da questo tipo di ticket, se presente. È possibile fornire valori separati per ogni lingua.

Le opzioni aggiuntive sono utili quando il tipo di ticket rappresenta più dimensioni.

Esempio 1: un biglietto di ingresso con diversi tipi "adulto", "bambino" e la lingua come opzione aggiuntiva, l'elenco TicketType previsto sarà: - { ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } localized_option_description { value: "spanish" } }

Esempio 2: una locazione di kayak per più ore con un componente aggiuntivo facoltativo come una borsa asciutta. La descrizione breve potrebbe essere "3 ore" e la descrizione dell'opzione potrebbe essere "con borsa asciutta" o "senza borsa asciutta": - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

Facoltativo, ma se per qualsiasi tipo di ticket all'interno del servizio è impostato questo campo, prevediamo che lo sia anche per tutti gli altri tipi di ticket (potrebbe essere utilizzata una descrizione_opzione predefinita). Ad esempio, [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] non è un elenco valido.

Sono supportati solo due tag di formattazione HTML: e
. Sono destinati a essere utilizzati per specificare le opzioni con un titolo e una descrizione dettagliata, ad esempio: "Posti premium
Questa opzione offre posti nelle tribune private, inclusi sedili completamente imbottiti, TV private e servizio di cibi e bevande a sedere. Questi posti offrono una vista pittoresca dei campi."

InventoryType

(Facoltativo) Tipo di inventario predeterminato di un singolo biglietto di questo tipo.

EventCategory

La categoria dell'evento. Impostato solo quando l'evento rientra in una delle categorie predefinite. (facoltativo)

string

L'URL dell'evento sul sito web del partner. (facoltativo)

Entity

Un elenco di entità correlate all'evento. (facoltativo)

AttendanceMode

Obbligatorio. Il tipo di partecipazione all'evento.

string

(Facoltativo) URL in cui è possibile guardare l'evento.

Text

(Facoltativo) Organizzatore che ospita l'evento.

string

(Facoltativo) URL dell'organizzatore che ospita l'evento.

OrganizerType

(Facoltativo) Il tipo di organizzatore.

string

Obbligatorio. URL delle pagine in cui sono disponibili le informazioni o le descrizioni degli eventi.

EventState

(Facoltativo) Stato dell'evento.

Text

(Facoltativo) Il nome del brand localizzato.

EventCreator

(Facoltativo) Informazioni sul creatore dell'evento.

string

Identificatore univoco dell'entità nel database del partner. (facoltativo)

string

Nome dell'entità. (obbligatorio)

string

URL della pagina web che descrive in modo univoco l'entità. Si tratta della pagina web sul sito web del partner per l'entità, se presente; per altri URL pubblici dell'entità, utilizza relevant_url in public_identification_data. (facoltativo)

EntityType

Il tipo di entità. (facoltativo)

EntityRole

Il ruolo dell'entità nell'evento. (facoltativo)

PublicIdentificationData

Riferimenti pubblici dell'entità. (facoltativo)

string

(Facoltativo) Il nome dell'autore dell'evento. Nessuna limitazione di caratteri.

string

URL pubblico di qualsiasi pagina web dedicata esclusivamente all'argomento. Potrebbero essere inclusi siti web ufficiali, Discogs, piattaforme di social media, pagine di Wikipedia o IMDb, ad esempio https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (facoltativo)

string

L'identificatore di 36 caratteri di musicbrainz dell'artista o di altre entità musicali, se applicabile. Consulta https://musicbrainz.org/doc/MusicBrainz_Identifier. (facoltativo)

Timestamp

Il limite inferiore dell'intervallo di tempo.

Timestamp

Il limite superiore dell'intervallo di tempo.

map<string, string>

Una configurazione di tokenizzazione ha in genere un parametro tokenization_parameter la cui chiave è "gateway" e il cui valore è il nome del processore.

Il resto dei parametri dipende dal processore. Per saperne di più, consulta la documentazione di Google Pay.

Esempio di Braintree: tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Esempio di Stripe: tokenization_parameter { chiave: "gateway" value: "striscia" } tokenization_parameter { key: &quot;stripe:version&quot; valore: "2018-02-28" } tokenization_parameter { key: &quot;stripe:publishableKey&quot; valore: "pk_1234" }

Esempio di Adyen: tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

Includi nel token di pagamento i dati di fatturazione dell'utente inseriti in Google Pay con il suo FOP (vedi sopra). Lasciare vuoto il campo equivale a specificare MIN.