Package google.maps.booking.v1alpha

string

L'URL del punto di ingresso 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 viene impostato, ACTION_PLATFORM_WEB_APPLICATION verrà utilizzato come riserva.

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.

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 posti totali e posti disponibili per 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 di prenotazione/aggiornamento/annullamento degli appuntamenti.

Resources

Risorse facoltative utilizzate per distinguere questo slot 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 anche essere condivise 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

Orari in cui non è possibile pianificare questo servizio. 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

Tariffa facoltativa per il mancato arrivo per questa disponibilità. Sostituisce la tariffa per il mancato arrivo, se specificata.

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 di tipi di ticket supportati per questo slot 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 padre. 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 spazio non è disponibile. Non utilizzato nel verticale Cose da fare. (facoltativo)

SchedulingRuleOverrides

Regole di pianificazione della disponibilità. Se i campi vengono compilati, sostituiranno tutte le eventuali regole di pianificazione corrispondenti nelle regole di pianificazione Scheduling 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 la modalità di conferma CONFIRMATION_MODE_SYNCHRONOUS devono essere confermati o rifiutati immediatamente. I tentativi di creare prenotazioni di disponibilità con la modalità di conferma CONFIRMATION_MODE_ASYNCHRONOUS devono essere rifiutati immediatamente o creati con lo stato IN ATTESA.

Timestamp

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

Duration

Definisce l'intervallo di tempo tra gli slot di disponibilità successivi.

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. Tutti gli spazi descritti dalla ricorrenza che si sovrappongono a questo intervallo di tempo chiuso verranno 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 le fasce orarie alle 9:30-9:50 e 10-10:30.

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

int64

L'ultima volta (in secondi) in cui questo slot può essere prenotato. Questo timestamp deve essere precedente al valore start_sec dell'area da rispettare (se gli utenti devono essere in grado di prenotare dopo l'ora di inizio, utilizza il livello di servizio SchedulingRules.min_booking_before_end_time). Se presente, sostituirà qualsiasi valore specificato in min_booking_buffer delle SchedulingRules del servizio corrispondente.

int64

La prima volta (in secondi) in cui lo slot può essere prenotato. Questo timestamp deve essere precedente al valore start_sec dello slot o, se specificato, last_bookable_sec.

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. Sono consentiti massimo 1000 record in una chiamata API.

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à estesa del servizio utilizzata per sostituire gli slot di disponibilità esistenti.

ExtendedServiceAvailability

I messaggi relativi alla disponibilità estesa del servizio sono stati aggiornati correttamente e sono stati utilizzati per sostituire gli slot di disponibilità esistenti.

string

Nome 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 per cui la prenotazione non è riuscita. (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

Periodo di tempo prima dell'ora di inizio, fino a quando il cliente può ricevere un rimborso per parte del costo del servizio specificato in refund_percent. Se il criterio viene impostato su 0 (valore predefinito), è possibile annullare il servizio 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

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 padre per il 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. Le carte di credito vuote non sono supportate.

string

Il nome della risorsa del commerciante da eliminare. Nel formato partner/{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

Agli utenti viene consigliato di pagare solo tramite i metodi di pagamento indicati di seguito.

Duration

Durata minima.

Duration

Durata massima.

string

Questo è un campo obbligatorio obbligatorio per specificare a quale commerciante appartengono i messaggi sulla 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, considereremo le entità disponibilità fornite come un'istantanea completa 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 viene impostato un messaggio relativo alla 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.

L'impostazione di start_time_restrict senza che venga impostata l'opzione end_time_restrict significa che l'intero orario inizia alle ore start_time_restrict.

Timestamp

Se il criterio viene impostato su end_time_restrict senza essere impostato su start_time_restrict, significa che indica l'intero tempo 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 di resource_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

Articoli appena aggiunti da questo feed. Gli articoli possono essere commercianti, servizi o slot 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 in caso di errori di elaborazione del feed.

FeedStatistics

Statistiche specifiche di questo feed.

FeeDetails

Dettagli delle tariffe addebitate all'utente, oltre al totale dell'articolo. Ripetito per diversi tipi di commissioni, come commissione di servizio, spese 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,5 EUR.

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 dei giorni in cui è disponibile questo metodo di evasione degli ordini (preferibilmente almeno 2).

FeeDetails

Obbligatorio. Dettagli della commissione per il metodo di evasione degli ordini.

Price

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

Date

Obbligatorio. Una data disponibile per un metodo di evasione degli ordini. Sia nel fuso orario del commerciante.

Timestamp

Obbligatorio. Timestamp Unix. L'ultima volta che un utente ha potuto 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 2020-08-08 20:00 significa che, per ricevere l'ordine il 10-08-2020, un cliente deve effettuarlo entro le 20:00 di due giorni prima.

NoFee

Nessuna commissione per il metodo di evasione degli ordini.

MinimumFee

La tariffa 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 feed basati su proto.

Timestamp

Obbligatorio. Questo timestamp viene utilizzato per garantire il corretto ordine 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

Potresti anche fornire un indirizzo non strutturato come riserva. Ad es. "Vista di montagna con anfiteatro 1600, ca 94043 ca"

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

string

Il tipo di prestazione nella categoria a cui appartiene il servizio a domicilio specificato. Ad es. unclog_drain e install_faucet sono i tipi di prestazione nella categoria idraulici.

string

Il nome della risorsa da invalidare.

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

string

ID del Servizio commerciante.

int64

Ora di inizio dello spazio per appuntamenti in secondi rispetto al fuso orario UTC dall'epoca di Unix.

int64

Durata dello spazio per appuntamenti 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 ticket.

int32

Numero di biglietti ordinati per questo tipo.

string

Obbligatorio. L'inserzionista principale, proprietario di questa raccolta dello stato di 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 articoli 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

Limitazione facoltativa per filtrare i risultati in base al limite 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à now.

FeedStatus

Elenco cronologico inverso degli stati dei feed caricati. Il numero massimo di articoli 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 "en", "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, consulta 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 sede, inclusi i prefissi e il paese, ad esempio +14567891234. (facoltativo)

string

L'URL del sito web pubblico della sede. (facoltativo)

GeoCoordinates

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

LocationType

Il tipo di località, deve essere specificato se questa località viene fornita per un servizio.

string

Riferimento univoco della località all'interno del servizio. Questo ID può essere utilizzato per fare riferimento a questa località in altri campi relativi ai servizi. 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 il paese e i prefissi, 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 impostato 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ù vicino. 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 obsoleto. Un messaggio vuoto (ad esempio, aliquota fiscale { }) reimposterà l'aliquota fiscale applicata su zero.

PaymentRestrictions

Restrizioni relative ai metodi di pagamento accettati da questo commerciante. Partiamo dal presupposto che non esistano limitazioni se questo campo non è impostato.

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 tokenizzato, se il commerciante è supportato.

TokenizationConfig

Configurazione per un elaboratore dei pagamenti tokenizzato, se il commerciante è supportato.

Terms

I Termini e condizioni del commerciante specifico mostrati all'utente quando un servizio viene prenotato 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 quando viene visualizzata 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 nome, logo, Termini di servizio e Norme sulla privacy.

Se è presente 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 contattarci prima 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 è necessario impostare questo campo, perché 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 nel consiglio devono essere limitati a 100 byte di lunghezza.

string

L'ID luogo di un luogo nel database di Google Places e su Google Maps. Per saperne di più sugli ID luogo, consulta 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 della prenotazione end-to-end.

WaitlistStatus

Stato relativo all'integrazione della lista d'attesa.

PlaceInfo

Luogo geografico corrispondente di questo commerciante. Vuoto se il commerciante non ha corrispondenze per i dati geografici.

LocalServicesMatchInfo

Gli annunci di Servizi locali corrispondono di questo commerciante. Il campo non è specificato se non è un commerciante di servizi locali o non corrisponde ad alcun fornitore.

DirectUrl

Un elenco di URL per dimostrare i contenuti dell'inventario attuale del commerciante. Tieni presente che ciò non significa che l'inventario viene effettivamente pubblicato e che l'URL potrebbe essere diverso da quelli visibili pubblicamente.

bool

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

UrlType

Tipo di questo URL.

string

URL che potrebbe mostrare questo commerciante.

MatchedProvider

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

int64

ID cliente esterno di Servizi locali di Google.

string

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

string

Il nome del luogo.

string

Indirizzo formattato nella lingua locale.

string

ID posizione di Google 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 il 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 nella prenotazione.

PriceType

Definisce come viene determinata la tariffa dalla disponibilità.

string

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

ClientInformation

Informazioni 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 in 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 per più commercianti consente a un utente di pagare con l'opzione di pagamento corrispondente per tutti i commercianti in questione.

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. Di conseguenza, una best practice consiste nel fare in modo che tutte le opzioni di pagamento condividano lo stesso ID e vengano sempre aggiornate con valori identici, per evitare qualsiasi rischio di comportamenti ministi.

string

Il nome dell'opzione di pagamento. 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 esempio, aliquota fiscale { }) reimposterà 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 cui può essere utilizzata 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 di tempo.

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 il modo in cui viene determinata la data di inizio 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 configurato, tutti gli utenti sono idonei.

Processor

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

string

Il codice utilizzato per identificare il commerciante presso 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

Restrizioni relative alle carte di credito accettate da questo commerciante. Supponiamo che tutte le carte di credito siano accettate se questo campo non è impostato. Tieni presente che l'elenco di carte supportate da CreditCardType aumenterà nel tempo, il che significa che lasciare vuoto questo campo soggetto a modifiche future.

Price

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

Price

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

Price

È previsto un costo aggiuntivo per un servizio.

Price

Una commissione da versare alla sede/strutture.

Price

Tasse 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

La via, ad esempio "1600 Amphitheatre Pkwy". (obbligatorio)

int64

Prezzo in micro-unità della valuta. Le frazioni dell'unità di valuta più piccola verranno arrotondate usando l'arrotondamento 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.

double

Un valore singolare. Ad esempio: 5,6

RangeValue

Un intervallo di valori che potrebbe 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 medio della valutazione (obbligatorio quando number_of_ratings > 0). Il valore deve essere compreso nell'intervallo [1, 5] e può essere omesso se e solo se il valore number_of_ratings è zero.

uint64

Numero di valutazioni utilizzate per il calcolo del valore (obbligatorio).

string

URL di questa fonte multimediale. Google eseguirà la scansione dei contenuti multimediali ospitati a questo URL.

MediaType

Tipo di questa fonte 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

Deprecato, preferibile usare 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 della camera 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 room_name è presente.

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.

int64

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

Price

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

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 le 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) da quando può essere effettuata l'ultima prenotazione fino a quando termina lo slot di disponibilità. Se questo campo è impostato, il valore di "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 di capelli da uomo". Deprecato, utilizza invece localized_service_name.

Text

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

string

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

Text

La descrizione del servizio visibile all'utente.

Questo campo supporta sia la formattazione di testo normale che quella HTML. Diversamente dalle sezioni di testo normale, qui è possibile creare layout personalizzati utilizzando intestazioni, paragrafi, elenchi e alcuni tag a frase. Leggi attentamente le seguenti istruzioni e note per assicurarti di creare un'esperienza utente ottimale.

Tag di formattazione simili a HTML supportati:

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

Tag paragrafo: <p>
il tag paragrafo può essere utilizzato per mettere in evidenza un'introduzione dettagliata o contenuti. 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.

Elenca i tag: <ul>, <ol>, <li>
<ul> può essere utilizzato con il tag <li> per visualizzare gli elenchi non ordinati e il tag <ol> Il tag 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 Division: <div>
Tutti i tag interni supportati del tag <div> verrà analizzato in base alle regole sopra indicate, ossia l'utilizzo di <div> non implica alcun raggruppamento o rientro in questo caso. Inoltre, verranno ignorati eventuali attributi e stili interni.

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 corrispondenza a frase verranno ignorati.

Tag non supportati:

• <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, eccetto quelli supportati indicati sopra, perché i contenuti all'interno di tag non supportati verranno rimossi e potrebbero causare un'esperienza utente indesiderata.
  
• Cerca di evitare strutture nidificate profonde, ad esempio più di 3 livelli di intestazione o elenchi nidificati diversi. Mantenere la struttura piatta, semplice e diretta contribuisce a 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 come il prezzo viene interpretato e visualizzato 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 per richiedere ulteriori informazioni all'utente quando prenota questo servizio. Questo modulo deve essere compilato una volta per ogni biglietto che l'utente prenota. (facoltativo)

TaxRate

L'aliquota fiscale del servizio. Se presente, questo campo sostituisce qualsiasi aliquota fiscale impostata a livello di commerciante. Un messaggio vuoto (ad esempio, aliquota fiscale { }) reimposterà 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 anche essere condivise 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 il mancato arrivo che potrebbe essere addebitata all'utente. Sostituisce la tariffa per il mancato arrivo, 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 poter prenotare questo servizio. Questo campo può essere sostituito a livello di disponibilità. (facoltativo)

ActionLink

Un link all'azione relativo a questo servizio. Se esiste un link all'azione, è necessario impostare il tipo (vedi di seguito) 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 l'archiviazione dei contenuti multimediali per garantire 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 di servizio definito nel Commerciante corrispondente. (facoltativo)

WaitlistRules

Regole per iscriversi 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. L'opzione end-to-end sarà sempre disattivata per questi partner.

PerOrderFee

Tariffe 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 ci sono più località visitate correlate a questo servizio o se la località START_LOCATION è diversa da VISITED_LOCATION, è necessario specificare START_LOCATION. Esempio: un tour guidato in bicicletta che visita tre punti di partenza. È necessario specificare la sede di partenza. - Un tour in autobus presso la hall dell'hotel, per poi dirigersi verso il luogo visitato. È necessario specificare la sede della riunione.

Rating

Valutazione degli utenti per questo servizio come metrica aggregata in tutte le recensioni.

HomeServiceData

Informazioni aggiuntive specifiche per il verticale dei servizi a domicilio. (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.

ChargeTiming

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

int64

Tempo in secondi precedente all'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 di 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, considereremo le entità disponibilità fornite come un'istantanea completa 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 viene impostato un messaggio relativo alla 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.

L'impostazione di start_time_restrict senza che venga impostata l'opzione end_time_restrict significa che l'intero orario inizia alle ore start_time_restrict.

Timestamp

Se il criterio viene impostato su end_time_restrict senza essere impostato su start_time_restrict, significa che indica l'intero tempo 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 di resource_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 accettazione.

bool

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

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

Impostalo solo se il tipo di campo è LOCATION_SEARCH. Utilizza "location_id" nella "località" per specificare il valore della località.

Text

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

bool

Indica se un utente richiede una risposta a questo campo.

bool

Indica se è consentito un valore personalizzato in aggiunta alle risposte predefinite. Ciò è applicabile solo quando il tipo di campo è LOCATION_SEARCH. (facoltativo)

Text

Opzioni aggiuntive fornite oltre ai valori forniti. Applicabile solo quando il tipo di campo è LOCATION_SEARCH. Ad es. oltre all'elenco delle località fornito, un'altra opzione disponibile può essere "Contatterò il fornitore più tardi". (facoltativo)

string

Se questa domanda deve essere mostrata solo quando l'utente prenota determinati tipi di ticket, questo campo deve essere impostato come l'insieme di ID dei tipi di ticket 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 impostato 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ù 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 testo in una lingua sconosciuta. Obbligatorio se e solo se il campo localized_value è vuoto. L'impostazione internazionale di questo valore potrebbe dipendere dal partner o dal fornitore di servizi: non deve essere una lingua specifica.

LocalizedString

Valori di testo per ogni lingua. (Facoltativo)

string

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

string

Una breve descrizione per questo TicketType.

Può essere visibile all'utente, ad esempio "adult", "bambino", "veteran", "Row J" e così via. Obbligatorio, ogni tipo di biglietto deve avere una descrizione per essere visibile all'utente. Deprecato, usa localized_short_description al suo posto.

Text

Una breve descrizione di questo TicketType con supporto i18n.

Può essere visibile all'utente, ad esempio "adult", "bambino", "veteran", "Row 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 biglietto singolo di questo tipo, al netto di eventuali imposte. Ai biglietti del Servizio si applica l'aliquota fiscale del servizio.

PerTicketFee

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

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 d'ingresso con diversi tipi di "adulti" e "bambini" e lingua come opzione aggiuntiva, l'elenco TicketType previsto sarebbe: - { 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: "spagnolo" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: &quot;child&quot; } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: &quot;child&quot; } localized_option_description { value: "spagnolo" }

Esempio 2: noleggio di kayak per più ore con l'aggiunta opzionale di una borsa asciutta; il valore Short_description potrebbe essere "3 ore" e options_description potrebbe essere "con sacchetto asciutto" o "senza sacchetto asciutto": - { ticket_type_id: "ticket_type_1" localized_short_description { value: "2 ore" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_2" localized_short_description { value: "2 ore" } localized_option_description { value: "spagnolo" } } - { ticket_type_id: "ticket_type_3" localized_short_description { value: "3 ore" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "3 ore" } localized_option_description { value: "spagnolo" }

Facoltativo, ma se questo campo è impostato per qualsiasi tipo di ticket all'interno del servizio, prevediamo che venga impostato anche per tutti gli altri tipi di ticket (potrebbe essere utilizzato un valore options_description predefinito). Ad es. [{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 opzioni sia con un titolo che una descrizione dettagliata, ad esempio: "Posti a sedere Premium
Questa opzione offre posti a sedere ai palchi privati, inclusi sedili completamente imbottiti, TV private, servizio cibo e bevande a sedere. Questi posti offrono una vista pittoresca dei campi."

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.

string

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

string

Nome dell'entità. (obbligatorio)

string

URL della pagina web che descrive in modo inequivocabile l'entità. Questa è la pagina web sul sito web del partner relativa all'entità, se presente; per gli 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

URL pubblico di qualsiasi pagina web dedicata esclusivamente all'argomento. Potrebbero essere inclusi siti web ufficiali, discog, piattaforme di social media, pagine 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. Visita la pagina 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.

Gli altri parametri dipendono dal processore. Per saperne di più, consulta la documentazione di Google Pay.

Esempio di Braintree: tokenization_parameter { chiave: "gateway" value: "braintree" } tokenization_parameter { key: &quot;braintree:apiVersion&quot; valore: "v1" } tokenization_parameter { key: &quot;braintree:sdkVersion&quot; valore: "2.30.0" } tokenization_parameter { chiave: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: &quot;braintree:clientKey&quot; valore: "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" }

Adyen example: tokenization_parameter { chiave: "gateway" value: "adyen" } tokenization_parameter { chiave: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

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