Package google.maps.booking.v1alpha

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

repeat_every

ExtendedServiceAvailability

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)

ScheduleException

I messaggi ScheduleException rappresentano gli intervalli di tempo prenotati/non disponibili all'interno della giornata lavorativa, che sono eccezioni alla ricorrenza descritta sopra. Poiché le fasce orarie sono prenotate, l'elenco delle eccezioni dovrebbe essere aggiornato in modo da riflettere i nuovi intervalli di tempo non disponibili. La ricorrenza in sé non deve essere modificata.

Campi

Campi
`time_range`	`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.

time_range

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.

SchedulingRuleOverrides

Regole di pianificazione a livello di disponibilità.

Campi

Campi
`last_bookable_sec`	`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.
`first_bookable_sec`	`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.
`last_online_cancellable_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)

last_bookable_sec

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.

first_bookable_sec

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.

last_online_cancellable_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)

BatchDeleteGenericRecordsRequest

La richiesta batch per eliminare i record del tipo di feed specificato.

Campi

Campi
`parent`	`string` Nome della risorsa, che ha il formato - `partners/{partner_id}/feeds/{feed_name}`.
`records[]`	`GenericDeleteRecord` Record da eliminare. Sono consentiti massimo 1000 record in una chiamata API.

parent

string

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

records[]

GenericDeleteRecord

Record da eliminare. Sono consentiti massimo 1000 record in una chiamata API.

BatchPushGenericRecordRequest

La richiesta batch per inserire e/o aggiornare i record del tipo di feed specificato nell'URL della richiesta.

Campi

Campi
`parent`	`string` Nome della risorsa, che ha il formato - `partners/{partner_id}/feeds/{feed_name}`.
`records[]`	`GenericRecord` Record da inserire e/o aggiornare. Sono consentiti massimo 1000 record in una chiamata API.

parent

string

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

records[]

GenericRecord

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

BatchReplaceServiceAvailabilityRequest

Richiesta batch di sostituzione di più slot di disponibilità di Service.

Campi

Campi
`parent`	`string` Formato di `partners/{partner_id}`.
`extended_service_availability[]`	`ExtendedServiceAvailability` La disponibilità estesa del servizio utilizzata per sostituire gli slot di disponibilità esistenti.

parent

string

Formato di partners/{partner_id}.

extended_service_availability[]

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

BatchReplaceServiceAvailabilityResponse

La risposta batch per sostituire più slot di disponibilità di Service. In questo messaggio verranno inclusi solo gli slot aggiornati correttamente

Campi

Campi
`extended_service_availability[]`	`ExtendedServiceAvailability` I messaggi relativi alla disponibilità estesa del servizio sono stati aggiornati correttamente e sono stati utilizzati per sostituire gli slot di disponibilità esistenti.

extended_service_availability[]

ExtendedServiceAvailability

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

Prenotazione

Una prenotazione per uno spazio pubblicitario

Campi
`name`	`string` Nome risorsa della prenotazione: `partners/{partner ID}/bookings/{booking ID}`
`merchant_id`	`string` ID del commerciante per l'area
`service_id`	`string` ID del servizio commerciante
`start_time`	`Timestamp` Ora di inizio dello spazio per appuntamenti
`duration`	`Duration` Durata dello spazio per appuntamenti
`client_information`	`ClientInformation` Informazioni personali del cliente che fissa l'appuntamento
`status`	`BookingStatus` Stato della prenotazione
`payment_information`	`PaymentInformation` Informazioni sulle transazioni di pagamento relative alla prenotazione.
`party_size`	`int64` Numero di persone della prenotazione

BookingFailure

Dati di stato che indicano perché l'elaborazione di una prenotazione non è riuscita in modo asincrono. BookingFailure è pensato per acquisire principalmente gli errori della logica di business.

Campi
`cause`	`Cause` Il motivo per cui la prenotazione non è riuscita. (obbligatorio)
`rejected_card_type`	`CreditCardType` (obbligatorio solo se la causa è PAYMENT_ERROR_CARD_TYPE_REJECTED)
`description`	`string` Questo campo facoltativo viene utilizzato dal partner per includere informazioni aggiuntive solo a scopo di debug. (facoltativo)
`payment_failure`	`PaymentFailureInformation` Informazioni sugli errori di pagamento.

Causa

Enumerazione delle cause di errore.

Enum
`CAUSE_UNSPECIFIED`	Valore predefinito: Non usare; equivale a un "errore sconosciuto"
`SLOT_UNAVAILABLE`	Lo slot di disponibilità a cui viene fatto riferimento non è più disponibile.
`SLOT_ALREADY_BOOKED_BY_USER`	L'utente ha già prenotato un appuntamento per lo spazio di disponibilità indicato.
`LEASE_EXPIRED`	Il leasing (se fornito) è scaduto e non può più essere utilizzato per completare la prenotazione richiesta.
`OUTSIDE_CANCELLATION_WINDOW`	Al momento non è possibile effettuare l'annullamento richiesto a causa dei limiti di tempo previsti dalle norme sull'annullamento del commerciante.
`PAYMENT_ERROR_CARD_TYPE_REJECTED`	Si è verificato un errore durante l'elaborazione del pagamento perché il tipo di carta di credito fornito non è stato accettato dal commerciante. Il tipo di carta di credito deve essere specificato in allowed_card_type.
`PAYMENT_ERROR_CARD_DECLINED`	Si è verificato un errore durante l'elaborazione del pagamento perché la carta di credito fornita è stata rifiutata.
`PAYMENT_OPTION_NOT_VALID`	Si è verificato un errore con il pacchetto/abbonamento utilizzato per il pagamento della prenotazione. Potrebbero non esserci altri utilizzi validi, potrebbero essere scaduti e così via.
`PAYMENT_ERROR`	Si è verificato un errore durante l'elaborazione del pagamento per questa prenotazione. Utilizza questo valore per indicare un errore generico relativo ai pagamenti, solo se l'errore non corrisponde a uno specifico errore di pagamento riportato sopra.
`USER_CANNOT_USE_PAYMENT_OPTION`	L'utente non può utilizzare l'opzione di pagamento indicata (ad es. se l'utente prova a utilizzare per la seconda volta il prezzo di un acquisto).
`BOOKING_ALREADY_CANCELLED`	Una prenotazione che l'utente ha cercato di annullare è già stata annullata.
`BOOKING_NOT_CANCELLABLE`	Una prenotazione che l'utente ha tentato di annullare non può essere annullata.
`OVERLAPPING_RESERVATION`	L'utente ha una prenotazione esistente troppo vicina a questo orario.
`USER_OVER_BOOKING_LIMIT`	Prenotazione non riuscita perché l'utente supera il limite di prenotazioni per utente dell'aggregatore.
`PAYMENT_REQUIRES_3DS1`	Imposta il momento in cui il pagamento viene rifiutato perché hai richiesto un nuovo tentativo della transazione, ma questa volta dopo aver eseguito la verifica o la risposta 3DS1. Tieni presente che lo stato di errore della transazione corrente rimarrà non riuscito. I nuovi tentativi saranno completamente separati. Se questo è il motivo dell'errore, DEVE essere impostato payment_failure.3DS1_parameters. In caso contrario, la causa corrente verrà considerata come PAYMENT_ERROR.

PaymentFailureInformation

Informazioni sugli errori di pagamento.

Campi

Campi
`threeds1_parameters`	`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.

threeds1_parameters

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.

ThreeDS1Parameters

Parametri che richiedono a RwG di eseguire una verifica 3DS1.

I parametri sono impostati secondo la descrizione di EMVCo del protocollo 3DS1.

Campi
`acs_url`	`string` L'URL da cui caricare un modulo da presentare all'utente per l'autenticazione.
`pa_req`	`string` Una richiesta PaymentAuthentication. Da pubblicare nel modulo ACSUrl, se fornito.
`transaction_id`	`string` Un identificatore utilizzato dal provider ACS. Da pubblicare nel modulo ACSUrl, se fornito.
`md_merchant_data`	`string` Dati del commerciante. Da pubblicare nel modulo ACSUrl, se fornito.

BookingStatus

Stato di una prenotazione

Enum
`BOOKING_STATUS_UNSPECIFIED`	Non specificato.
`CONFIRMED`	La prenotazione è stata confermata
`PENDING_MERCHANT_CONFIRMATION`	La prenotazione è in attesa di conferma da parte del commerciante prima che possa passare allo stato CONFERMA (questa operazione NON è attualmente supportata)
`PENDING_CLIENT_CONFIRMATION`	La prenotazione è in attesa di conferma da parte del cliente prima che possa passare allo stato CONFERMA (questa operazione NON è attualmente supportata)
`CANCELED`	La prenotazione è stata annullata per conto dell'utente.
`NO_SHOW`	Il cliente non si è presentato per l'appuntamento
`NO_SHOW_PENALIZED`	Il cliente non si è presentato per l'appuntamento in violazione delle norme sull'annullamento.
`FAILED`	Impossibile completare la prenotazione a causa di un errore di elaborazione.
`DECLINED_BY_MERCHANT`	La prenotazione è stata rifiutata in modo asincrono dal commerciante.

CallMerchant

Messaggio vuoto da utilizzare in supportedPartySizeOption. L'impostazione di questa opzione mostrerà agli utenti un'opzione per chiamare l'attività per una prenotazione.

CancellationPolicy

Norme di annullamento di un servizio.

Campi

Campi
`refund_condition[]`	`RefundCondition` Zero o più condizioni di rimborso applicabili alle norme.

refund_condition[]

RefundCondition

Zero o più condizioni di rimborso applicabili alle norme.

RefundCondition

Definisce una singola condizione di rimborso. È possibile utilizzare più condizioni di rimborso per descrivere i passaggi del rimborso come varie durate prima dell'ora di inizio del servizio.

Campi

Campi
`min_duration_before_start_time`	`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.
`refund_percent`	`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.

min_duration_before_start_time

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.

refund_percent

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.

ClientInformation

Informazioni personali della persona che effettua una prenotazione

Campi
`given_name`	`string` Nome del cliente
`family_name`	`string` Cognome del cliente
`address`	`PostalAddress` Indirizzo del client
`telephone`	`string` Numero di telefono del cliente
`email`	`string` Indirizzo email del client

CreateMerchantRequest

Richiesta di creazione di un Merchant.

Campi

Campi
`parent`	`string` Il nome della risorsa padre per il partner proprietario di questo commerciante, nel formato `partners/{partner_id}`.
`merchant_id`	`string` L'ID commerciante da utilizzare per questo commerciante.
`merchant`	`Merchant` Il commerciante da creare.

parent

string

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

merchant_id

string

L'ID commerciante da utilizzare per questo commerciante.

merchant

Merchant

Il commerciante da creare.

CreateServiceRequest

Richiesta di creazione di un nuovo Service.

Campi

Campi
`parent`	`string` Il nome della risorsa padre per il commerciante proprietario di questo servizio, nel formato `partners/{partner_id}/merchants/{merchant_id}`.
`service_id`	`string` L'ID servizio da utilizzare per questo servizio.
`service`	`Service` Il servizio da creare.

parent

string

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

service_id

string

L'ID servizio da utilizzare per questo servizio.

service

Service

Il servizio da creare.

CreditCardRestrictions

Restrizioni relative ai tipi di carta di credito accettati da questo commerciante.

Campi

Campi
`credit_card_type[]`	`CreditCardType` Un elenco di carte di credito supportate. Le carte di credito vuote non sono supportate.

credit_card_type[]

CreditCardType

Un elenco di carte di credito supportate. Le carte di credito vuote non sono supportate.

CreditCardType

Un tipo di carta di credito.

Enum
`CREDIT_CARD_TYPE_UNSPECIFIED`	Non utilizzato.
`VISA`	Una carta di credito Visa.
`MASTERCARD`	Una carta di credito Mastercard.
`AMERICAN_EXPRESS`	Una carta di credito American Express.
`DISCOVER`	Una carta di credito Discover.
`JCB`	Una carta di credito JCB.

DeleteMerchantRequest

Richiesta di eliminazione di un Merchant.

Campi

Campi
`name`	`string` Il nome della risorsa del commerciante da eliminare. Nel formato partner/{partner_id}/merchants/{merchant_id}

name

string

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

DeleteServiceRequest

Richiesta di eliminazione di un Service.

Campi

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

name

string

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

Deposito

Un deposito che all'utente potrebbe essere addebitato o che potrebbe essere trattenuto sulla sua carta di credito.

Campi

Campi
`deposit`	`Price` Importo del deposito.
`min_advance_cancellation_sec`	`int64` Annullamento minimo anticipato per il deposito.
`deposit_type`	`PriceType` Definisce la modalità di determinazione del deposito in base alla disponibilità.

deposit

Importo del deposito.

min_advance_cancellation_sec

int64

Annullamento minimo anticipato per il deposito.

deposit_type

PriceType

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

DirectMerchantPayment

Informazioni su come l'utente può pagare direttamente al commerciante anziché pagare anticipato per il servizio tramite RwG.

Campi

Campi
`payment_methods[]`	`Text` Agli utenti viene consigliato di pagare solo tramite i metodi di pagamento indicati di seguito.

payment_methods[]

Text

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

DurationRange

Wrapper per un intervallo di durata che può essere limitato o illimitato. È obbligatorio specificare almeno un valore tra min_duration e max_duration.

Campi

Campi
`min_duration`	`Duration` Durata minima.
`max_duration`	`Duration` Durata massima.

min_duration

Durata minima.

max_duration

Durata massima.

ExtendedServiceAvailability

Un elenco della disponibilità e di chi/quando devono essere applicati.

Campi
`merchant_id`	`string` Questo è un campo obbligatorio obbligatorio per specificare a quale commerciante appartengono i messaggi sulla disponibilità riportati di seguito.
`service_id`	`string` Questo è un campo obbligatorio obbligatorio per specificare a quale servizio appartengono i messaggi sulla disponibilità riportati di seguito.
`start_time_restrict`	`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.
`end_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_restrict`	`Duration` L'impostazione della durata limita ulteriormente l'ambito dell'aggiornamento alla sola disponibilità con durata corrispondente.
`resources_restrict`	`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[]`	`Availability` Il nuovo elenco di disponibilità.

FeedStatistics

Statistiche ottenute durante l'elaborazione di un feed caricato.

Campi

new_items

int64

Articoli appena aggiunti da questo feed. Gli articoli possono essere commercianti, servizi o slot di disponibilità, a seconda del tipo di feed.

existing_items

int64

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

deleted_items

int64

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

FeedStatus

Stato di un feed caricato dalla piattaforma dell'aggregatore.

Campi
`name`	`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`	`State` Lo stato di elaborazione di questo feed.
`error_details`	`string` Stringa leggibile che fornisce ulteriori dettagli in caso di errori di elaborazione del feed.
`statistics`	`FeedStatistics` Statistiche specifiche di questo feed.

Stato

Enum per indicare lo stato di elaborazione di un feed.

Enum
`STATE_UNSPECIFIED`	Valore predefinito. Non utilizzato.
`IN_PROGRESS`	Il feed è ancora in fase di elaborazione.
`SUCCESS`	Il feed è stato elaborato.
`FAILURE`	Si è verificato un errore durante l'elaborazione del feed.

FoodOrderingMetadata

Metadati per i link alle azioni di ordinazione di cibo.

Campi
`fee_details[]`	`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.
`advance_order_details`	`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.
Campo unione `fulfillment_duration_options`. Durata del tempo di evasione dell'ordine dalla conferma dell'ordine. Per gli ordini con consegna, il tempo necessario per la consegna del cibo. Per gli ordini con ritiro, tempo di attesa fino al momento in cui il cibo è pronto per il ritiro. `fulfillment_duration_options` può essere solo uno dei seguenti:
`fulfillment_lead_time_duration`	`Duration` Durata fissa. Ad esempio: 30 min.
`fulfillment_lead_time_duration_range`	`DurationRange` Un intervallo di durata. Esempi: * 30-45 min * Più di 30 min * Meno di 50 min

AdvanceOrderDetails

Per assistenza su ordinazione.

Campi

is_supported

bool

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

FeeDetails

Dettagli della commissione.

Campi

type

FeeType

Tipo di tariffa. (obbligatorio)

fee_amount

FeeAmount

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

FeeAmount

Esempi di FeeAmount: * Tariffa fissa: 0 $ (nessuna commissione), 1,5 $ * Intervallo della tariffa fissa: 1,0 $ (minima), 3,0 $ (massima), 5,0-6,0 $ * Percentuale di dimensioni del carrello: 15,5%, 10%-20%, 10% (minimo), 15% (massimo) * Comp25,5% dell'intervallo e percentuale: USD 2,5 (minimo), 25,5% & 4,5 $ (massimo), 10% e USD 1,5-2,5, 10,5%- 20% e 2,5-3,5 $

Campi
`cart_percentage`	`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%
Campo unione `amount_options`. Opzioni per specificare un importo monetario. `amount_options` può essere solo uno dei seguenti:
`amount`	`Money` Importo fisso. Ad esempio 3,5 EUR.
`amount_range`	`MoneyRange` Intervallo di importo. Esempi: * Da 3,5 € a 5,5 € * Almeno 3,5 € * Massimo 5,5 €
`amount_unknown`	`bool` Importo sconosciuto.

FeeType

Tipo di tariffa.

Enum
`FEE_TYPE_UNSPECIFIED`	Tipo di tariffa non specificato.
`DELIVERY`	Per le spese di consegna.
`SERVICE`	Per le commissioni di servizio.

FulfillmentOption

L'opzione di evasione di un link di azione online per l'ordine.

Campi
`fulfillment_type`	`FulfillmentType` Obbligatorio. Il tipo di completamento.
`available_day[]`	`AvailableDay` Obbligatorio. Un elenco dei giorni in cui è disponibile questo metodo di evasione degli ordini (preferibilmente almeno 2).
`fee_details`	`FeeDetails` Obbligatorio. Dettagli della commissione per il metodo di evasione degli ordini.
`minimum_order`	`Price` Obbligatorio. Ordine minimo per il metodo di evasione degli ordini associato al link di azione.

AvailableDay

Disponibilità a livello di giorno.

Campi

fulfillment_date

Date

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

last_ordering_time

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.

FeeDetails

Dettagli della tariffa per il metodo di evasione degli ordini associato al link di azione.

Campi
Campo unione `fee_details`. Modello di commissione per il metodo di evasione degli ordini. `fee_details` può essere solo uno dei seguenti:
`no_fee`	`NoFee` Nessuna commissione per il metodo di evasione degli ordini.
`base_fee`	`MinimumFee` La tariffa base associata al metodo di evasione degli ordini.
`fixed_fee`	`FixedFee` La tariffa fissa associata al metodo di evasione degli ordini.

FixedFee

La tariffa fissa richiesta per il metodo di evasione degli ordini associato al link di azione.

Campi

amount

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

FulfillmentType

Il tipo di completamento associato a un link di azione.

Enum
`FULFILLMENT_TYPE_UNSPECIFIED`	Il tipo di completamento non è specificato.
`FULFILLMENT_TYPE_DELIVERY`	Il tipo di evasione è la consegna.
`FULFILLMENT_TYPE_PICKUP`	Il tipo di evasione degli ordini è Ritiro.

MinimumFee

La tariffa minima richiesta per il metodo di completamento associato al link di azione.

Campi

base_fee_amount

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

NoFee

Non è richiesta alcuna commissione per il metodo di completamento associato al link di azione.

GenericDeleteRecord

Record da eliminare del tipo di feed menzionato nella richiesta di URL.

Campi
`delete_time`	`Timestamp` Obbligatorio. Questo timestamp viene utilizzato per determinare l'ordine in cui un'eliminazione verrà applicata all'inventario.
Campo unione `record_type`. Incapsulare diversi tipi di feed (ndjson, basato su proto e così via). Il partner può fornire un record completo, simile a come viene fornito un record in un feed o nell'API BatchPush. I partner hanno inoltre la possibilità di includere solo i campi essenziali di un record necessari per identificarlo in modo univoco. `record_type` può essere solo uno dei seguenti:
`data_record`	`bytes` Per i feed non basati su protocollo.
`proto_record`	`Any` Per feed basati su proto.

GenericRecord

Record del tipo di feed menzionato nella richiesta di URL.

Campi
`generation_timestamp`	`Timestamp` Obbligatorio. Questo timestamp viene utilizzato per garantire il corretto ordine degli aggiornamenti dell'inventario.
Campo unione `record_type`. Incapsulare diversi tipi di feed (ndjson, basato su proto e così via). `record_type` può essere solo uno dei seguenti:
`data_record`	`bytes` Per i feed non basati su protocollo.
`proto_record`	`Any` Per feed basati su proto.

GeoCoordinates

I dati geografici di una località, tra cui latitudine, longitudine e indirizzo.

Campi
`latitude`	`double` Latitudine in gradi. (facoltativo)
`longitude`	`double` Longitudine in gradi. (facoltativo)
Campo unione `addresses`. Indirizzo di una località, che può essere strutturato o non strutturato. `addresses` può essere solo uno dei seguenti:
`address`	`PostalAddress` Indirizzo postale della località, preferito.
`unstructured_address`	`string` Potresti anche fornire un indirizzo non strutturato come riserva. Ad es. "Vista di montagna con anfiteatro 1600, ca 94043 ca"

GetMerchantStatusRequest

La richiesta per ottenere un MerchantStatus

Campi

name

string

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

GetStatusRequest

La richiesta di recuperare Status per un feed specifico caricato dalla piattaforma dell'aggregatore.

Campi

name

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}

HomeServiceData

È necessario fornire ulteriori informazioni per il verticale dei servizi a domicilio.

Campi

category_type

string

La categoria di alto livello a cui appartiene questo servizio a domicilio. Ad es. idraulico, elettricista ecc.

job_type

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.

IntegrationType

Profondità di integrazione supportata.

Enum
`INTEGRATION_TYPE_UNSPECIFIED`	Il valore predefinito è END_TO_END.
`INTEGRATION_TYPE_END_TO_END`	Completa l'integrazione che consente la prenotazione end-to-end tramite Google.
`INTEGRATION_TYPE_INVENTORY_ONLY`	Il server di prenotazione non deve necessariamente supportare questo servizio. Devono essere inviati solo i dati relativi a commercianti, servizi e, facoltativamente, sulla disponibilità.

InvalidateResourceRequest

Richiesta di invalidare una risorsa.

Campi

resource_id

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.

LineItem

Un singolo articolo in un ordine: la prenotazione di un singolo servizio in un'unica fascia oraria.

Campi
`service_id`	`string` ID del Servizio commerciante.
`start_sec`	`int64` Ora di inizio dello spazio per appuntamenti in secondi rispetto al fuso orario UTC dall'epoca di Unix.
`duration_sec`	`int64` Durata dello spazio per appuntamenti in secondi.
`tickets[]`	`OrderedTickets` Numero di biglietti ordinati per tipo di biglietto.
`price`	`Price` Il prezzo totale (tasse escluse) di questo elemento pubblicitario.
`status`	`BookingStatus` Stato dell'elemento pubblicitario.

OrderedTickets

Numero di biglietti ordinati per tipo di biglietto.

Campi

ticket_id

string

ID di un tipo di ticket.

count

int32

Numero di biglietti ordinati per questo tipo.

ListMerchantStatusesRequest

La richiesta per ottenere un elenco di MerchantStatus

Campi
`parent`	`string` Obbligatorio. L'inserzionista principale, proprietario di questa raccolta dello stato di commerciante. Formato: `partners/{partner_id}/merchants`
`page_size`	`int32` Obbligatorio. Il numero massimo di articoli da restituire. Tieni presente che il server potrebbe ridurre le dimensioni della pagina.
`page_token`	`string` (Facoltativo) Il valore nextPageToken restituito da un precedente ListMerchantStatusResponse, se presente.
`booking_inventory_status_restrict`	`BookingInventoryStatus` (Facoltativo) Limitazione facoltativa per filtrare i risultati in base allo stato dell'inventario di prenotazione.
`waitlist_inventory_status_restrict`	`WaitlistInventoryStatus` (Facoltativo) Limitazione facoltativa per filtrare i risultati in base allo stato dell'inventario della lista d'attesa.
`geo_match_restrict`	`GeoMatchingStatus` (Facoltativo) Limitazione facoltativa per filtrare i risultati in base allo stato della corrispondenza geografica.

BookingInventoryStatus

Stato dell'inventario della prenotazione end-to-end.

Enum
`BOOKING_INVENTORY_STATUS_UNSPECIFIED`	Non specificato.
`NO_VALID_FUTURE_INVENTORY`	Il commerciante non dispone di inventario per la prenotazione nei successivi 30 giorni.
`HAS_VALID_FUTURE_INVENTORY`	Il commerciante ha prenotato l'inventario entro i successivi 30 giorni.

GeoMatchingStatus

Stato della corrispondenza geografica del commerciante.

Enum
`GEO_MATCHING_STATUS_UNSPECIFIED`	Non specificato.
`GEO_UNMATCHED`	Il commerciante non ha una corrispondenza geografica.
`GEO_MATCHED`	Il commerciante ha una corrispondenza geografica.

WaitlistInventoryStatus

Stato dell'inventario della lista d'attesa end-to-end.

Enum
`WAITLIST_INVENTORY_STATUS_UNSPECIFIED`	Non specificato.
`NO_VALID_WAITLIST_SERVICE`	Il commerciante non dispone di un servizio che supporta la lista d'attesa.
`HAS_VALID_WAITLIST_SERVICE`	Il commerciante offre un servizio che supporta la lista d'attesa.

ListMerchantStatusesResponse

La risposta all'elenco MerchantStatus.

Campi

merchant_statuses[]

MerchantStatus

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

next_page_token

string

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

ListStatusRequest

La richiesta di recuperare Status per più feed caricati dalla piattaforma dell'aggregatore.

Campi
`name`	`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`
`page_size`	`int32` Il numero massimo di articoli da restituire.
`page_token`	`string` Il valore next_page_token restituito da una precedente richiesta di elenco, se presente.
`state_restrict`	`State` Limitazione facoltativa per filtrare i risultati per stato del feed.
`time_range_restrict`	`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.

ListStatusResponse

La richiesta di recuperare Status per più feed caricati dalla piattaforma dell'aggregatore.

Campi

status[]

FeedStatus

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

next_page_token

string

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

LocalizedString

Istanza di una stringa in una lingua.

Campi

locale

string

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

value

string

Messaggio nelle impostazioni internazionali precedenti (UTF-8).

Località

Informazioni geografiche su una località.

Campi
`place_id`	`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.
`name`	`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)
`telephone`	`string` Il numero di telefono pubblico della sede, inclusi i prefissi e il paese, ad esempio +14567891234. (facoltativo)
`url`	`string` L'URL del sito web pubblico della sede. (facoltativo)
`geo`	`GeoCoordinates` Le informazioni geografiche della posizione, inclusi latitudine, longitudine e indirizzo. (facoltativo)
`location_type`	`LocationType` Il tipo di località, deve essere specificato se questa località viene fornita per un servizio.
`location_id`	`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)

LocationType

Il tipo di questa posizione.

Enum
`LOCATION_TYPE_UNSPECIFIED`	Tipo di località non specificato.
`VISITED_LOCATION`	La località visitata da questo servizio.
`START_LOCATION`	Il luogo da cui inizia il servizio è anche MEETING_LOCATION.
`END_LOCATION`	La località in cui termina il servizio.

Commerciante

Informazioni su un commerciante che si trova sulla piattaforma dell'aggregatore.

Campi
`name`	`string` Il nome della risorsa del commerciante, che ha il formato `partners/{partner_id}/merchants/{merchant_id}`.
`merchant_name`	`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.
`telephone`	`string` Il numero di telefono pubblico del commerciante, inclusi il paese e i prefissi, ad esempio +14567891234.
`url`	`string` L'URL del sito web pubblico del commerciante.
`geo`	`GeoCoordinates` Le informazioni geografiche del commerciante, inclusi latitudine, longitudine e indirizzo.
`category`	`string` La categoria dell'attività nella piattaforma dell'aggregatore.
`num_bookings_30d (deprecated)`	`int64` Questo elemento è deprecato. Campo obsoleto.
`tax_rate_basis_points (deprecated)`	`uint32` Questo elemento è deprecato. 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.
`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.
`payment_restrictions`	`PaymentRestrictions` Restrizioni relative ai metodi di pagamento accettati da questo commerciante. Partiamo dal presupposto che non esistano limitazioni se questo campo non è impostato.
`payment_option[]`	`PaymentOption` Opzioni di pagamento disponibili per questo commerciante. I servizi di questo commerciante potranno limitare singolarmente le opzioni di pagamento consentite.
`payment_processor_config (deprecated)`	`PaymentProcessorConfig` Questo elemento è deprecato. Configurazione per un elaboratore dei pagamenti tokenizzato, se il commerciante è supportato.
`tokenization_config`	`TokenizationConfig` Configurazione per un elaboratore dei pagamenti tokenizzato, se il commerciante è supportato.
`terms`	`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.
`brand_id`	`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.
`matching_hints`	`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)
`service_attribute[]`	`ServiceAttribute` Definizioni di tutti gli attributi dei servizi utilizzati per descrivere i Servizi per questo Commerciante. (facoltativo)
`action_link[]`	`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
`waitlist_advisement`	`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.

MerchantMatchingHints

Suggerimenti utilizzati per aiutare Google ad abbinare un commerciante a un luogo su Google Maps.

Campi

place_id

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.

MerchantStatus

Stato di un commerciante nella piattaforma Prenota con Google.

Campi
`name`	`string` Il nome della risorsa di stato del commerciante, che ha il formato `partners/{partner_id}/merchants/{merchant_id}/status`
`merchant_name`	`string` Nome del commerciante fornito dai partner.
`input_geo_info`	`GeoCoordinates` I partner hanno fornito le informazioni geografiche del commerciante.
`processing_status`	`ProcessingStatus` Stato di elaborazione del commerciante.
`booking_status`	`BookingStatus` Stato relativo all'integrazione della prenotazione end-to-end.
`waitlist_status`	`WaitlistStatus` Stato relativo all'integrazione della lista d'attesa.
`geo_match`	`PlaceInfo` Luogo geografico corrispondente di questo commerciante. Vuoto se il commerciante non ha corrispondenze per i dati geografici.
`local_services_match`	`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.
`direct_urls[]`	`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.

BookingStatus

Stato relativo all'integrazione della prenotazione end-to-end.

Campi

has_valid_future_inventory

bool

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

DirectUrl

URL che mostra il commerciante.

Campi

type

UrlType

Tipo di questo URL.

url

string

URL che potrebbe mostrare questo commerciante.

UrlType

Tipo di URL visualizzato.

Enum
`URL_TYPE_UNSPECIFIED`	Non specificato.
`BOOKING`	URL di prenotazione end-to-end.
`WAITLIST`	URL end-to-end della lista d'attesa.
`LOCAL_SERVICES`	URL di Servizi locali di Google.

LocalServicesMatchInfo

Le informazioni sui Servizi locali di Google corrispondono (impostate solo per i commercianti di Servizi locali).

Campi

matched_providers[]

MatchedProvider

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

MatchedProvider

Fornitore di Servizi locali.

Campi

customer_id

int64

ID cliente esterno di Servizi locali di Google.

categories[]

string

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

PlaceInfo

Informazioni su un luogo corrispondente.

Campi

name

string

Il nome del luogo.

formatted_address

string

Indirizzo formattato nella lingua locale.

place_id

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.

ProcessingStatus

Stato di elaborazione del commerciante.

Enum
`PROCESSING_STATUS_UNSPECIFIED`	Stato non specificato.
`IN_PROGRESS`	Il commerciante è stato ricevuto da Madden, ma è ancora in fase di elaborazione. Per i commercianti con questo stato non verranno completati altri stati.
`COMPLETED`	Sono stati calcolati altri stati del commerciante.

WaitlistStatus

Stato relativo all'integrazione della lista d'attesa.

Campi

has_valid_waitlist_service

bool

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

MoneyRange

Wrapper per un intervallo di importo monetario che potrebbe essere limitato o illimitato. È obbligatorio specificare almeno un valore tra min_amount e max_amount.

Campi

min_amount

Money

Importo minimo.

max_amount

Money

Importo massimo.

NoShowFee

Commissione che può essere addebitata a un utente se ha effettuato una prenotazione ma non si presenta.

Campi

fee

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

fee_type

PriceType

Definisce come viene determinata la tariffa dalla disponibilità.

Ordine

Un ordine per appuntamenti di servizio con un commerciante.

Campi
`name`	`string` Nome risorsa dell'ordine: `partners/{partner ID}/orders/{order ID}`
`client_information`	`ClientInformation` Informazioni personali del cliente che effettua l'ordine.
`payment_information`	`PaymentInformation` Informazioni sulle transazioni di pagamento relative all'ordine.
`merchant_id`	`string` ID del commerciante a cui appartengono tutti i servizi in questo ordine.
`item[]`	`LineItem` Elementi pubblicitari in questo ordine.

OrderOnlineMetadata

Metadati per il link di azione online relativo a un ordine.

Campi

fulfillment_option[]

FulfillmentOption

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

PaymentInformation

Dettagli sul pagamento relativi a una prenotazione

Campi

prepayment_status

PrepaymentStatus

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

payment_transaction_id

string

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

PaymentOption

Un'opzione di pagamento, che può essere utilizzata per pagare i servizi forniti da un commerciante. Le opzioni di pagamento possono essere condivise tra più commercianti (ad es. commercianti appartenenti alla stessa catena).

Campi
`payment_option_id`	`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.
`name`	`string` Il nome dell'opzione di pagamento. Può essere visibile all'utente.
`description`	`string` Una descrizione dell'opzione di pagamento. Può essere visibile all'utente.
`price`	`Price` Il prezzo dell'opzione di pagamento.
`tax_rate`	`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.
`payment_option_type`	`PaymentOptionType` Il tipo di questa opzione di pagamento. Uso singolo per i drop-in, multiuso per i pacchetti e illimitato per gli abbonamenti.
`session_count`	`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.
`purchase_interval`	`TimeRange` L'opzione di pagamento può essere acquistata entro questo intervallo di tempo.
`valid_interval`	`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.
`valid_duration`	`Duration` Durata della validità dell'opzione di pagamento (ad es. abbonamento di 30 giorni).
`activation_type`	`ActivationType` Definisce il modo in cui viene determinata la data di inizio validità per questa opzione di pagamento.
`user_restriction`	`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.

ActivationType

Definisce come viene determinata la data di inizio della validità.

Enum
`ACTIVATION_TYPE_UNSPECIFIED`	Non utilizzato.
`ACTIVATION_ON_PURCHASE`	La validità inizia al momento dell'acquisto.
`ACTIVATION_ON_FIRST_USE`	La validità inizia quando l'opzione di pagamento viene utilizzata per la prima volta.

PaymentOptionType

Un tipo di opzione di pagamento.

Enum
`PAYMENT_OPTION_TYPE_UNSPECIFIED`	Non utilizzato.
`PAYMENT_OPTION_SINGLE_USE`	L'opzione di pagamento può essere utilizzata una sola volta.
`PAYMENT_OPTION_MULTI_USE`	L'opzione di pagamento può essere utilizzata se il conteggio delle sessioni > 0.
`PAYMENT_OPTION_UNLIMITED`	L'opzione di pagamento può essere utilizzata nell'intervallo di tempo valido: il conteggio delle sessioni non è applicabile.

PaymentProcessorConfig

Una configurazione per l'elaboratore dei pagamenti, definita per ogni commerciante.

Campi

processor

Processor

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

public_key

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

version

string

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

Processore

Definisce un partner specifico elaboratore dei pagamenti.

Enum
`PROCESSOR_UNSPECIFIED`	Non utilizzata
`PROCESSOR_STRIPE`	Una configurazione per i pagamenti con Stripe.
`PROCESSOR_BRAINTREE`	Una configurazione per i pagamenti con Braintree.

PaymentRestrictions

Restrizioni relative ai metodi di pagamento accettati da questo commerciante.

Campi

credit_card_restrictions

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.

PerOrderFee

Commissioni che devono essere pagate una volta per ogni ordine, indipendentemente dal numero di biglietti.

Campi

delivery_fee

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

processing_fee

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

PerTicketFee

Commissioni che devono essere pagate per ogni biglietto acquistato dall'utente.

Campi

service_charge

È previsto un costo aggiuntivo per un servizio.

facility_fee

Una commissione da versare alla sede/strutture.

taxes

Tasse per biglietto.

PostalAddress

L'indirizzo di un cliente o di un'attività commerciale.

Campi
`address_country`	`string` Il paese, specificato mediante il codice paese ISO 3166-1 alpha-2, ad esempio "US" (obbligatorio)
`address_locality`	`string` Località, ad es. "Milano". (obbligatorio)
`address_region`	`string` La regione, ad esempio "CA". Questo campo è obbligatorio solo nei paesi in cui la regione fa comunemente parte dell'indirizzo. (facoltativo)
`postal_code`	`string` Il codice postale, ad esempio "94043". (obbligatorio)
`street_address`	`string` La via, ad esempio "1600 Amphitheatre Pkwy". (obbligatorio)

PrepaymentStatus

Stato del pagamento anticipato di una prenotazione.

Enum
`PREPAYMENT_STATUS_UNSPECIFIED`	Non specificato, il valore predefinito è PREPAYMENT_NOT_PROVIDED.
`PREPAYMENT_PROVIDED`	La tariffa per la prenotazione è stata pagata in anticipo.
`PREPAYMENT_NOT_PROVIDED`	La commissione per la prenotazione non è stata pagata in anticipo.
`PREPAYMENT_REFUNDED`	In precedenza la commissione era di PREPAYMENT_PROVIDED, ma ora è stata rimborsata.

Prezzo

Il prezzo di un servizio o una commissione.

Campi
`price_micros`	`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).
`currency_code`	`string` La valuta del prezzo definita nella norma ISO 4217.
`pricing_option_tag`	`string` Una stringa facoltativa e opaca che identifica l'opzione di prezzo associata al prezzo esteso.

PriceInterpretation

Descrive come un prezzo deve essere interpretato e mostrato all'utente.

Enum
`PRICE_INTERPRETATION_UNSPECIFIED`	Interpretazione del prezzo non specificata. Il valore predefinito è EXACT_AMOUNT.
`EXACT_AMOUNT`	Quando il prezzo deve essere interpretato come un valore specifico. Esempi: 20 $ per una lezione di yoga; 15 $ per un taglio di capelli per bambini
`STARTS_AT`	Quando il prezzo di un servizio è variabile, ma un prezzo minimo è noto e mostrato ai consumatori. I consumatori potrebbero fare scelte che aumentano il prezzo. Tieni presente che qualsiasi servizio che utilizza questa Interpretazione del prezzo deve utilizzare PrepaymentType NOT_SUPPORTED. Esempi: 30 $ per la toelettatura di cani, ma ulteriori opzioni per i consumatori possono aumentare il prezzo.
`NOT_DISPLAYED`	Quando il prezzo di un servizio è variabile e non vengono mostrate informazioni sul prezzo ai consumatori in anticipo. Tieni presente che qualsiasi servizio che utilizza questa interpretazione del prezzo deve utilizzare PrepaymentType NOT_SUPPORTED e il campo Price deve essere vuoto. Esempi: consulenza per un servizio a domicilio

PriceType

Definisce come viene determinato un prezzo totale a partire da una disponibilità.

Enum

FIXED_RATE_DEFAULT

Il prezzo è per un importo fisso. Questo è il valore predefinito se il campo non è impostato.

Esempi: deposito di 50 $ per prenotare un tavolo; 20 $ di quota di non partecipazione per una lezione di yoga

PER_PERSON

Il prezzo specificato è a persona e il prezzo totale viene calcolato in base al numero di persone specificato in Risorse nel formato price_micros * party_size. Il prezzo PER_PERSONA deve essere accompagnato dal numero di persone nelle risorse di disponibilità. In caso contrario, viene utilizzata una dimensione del numero di persone.

Esempi: 10 $ ciascuno per i biglietti di un museo

QuantitativeValue

Wrapper per un valore numerico che può essere un intervallo o un valore fisso. QuantitativeValue esempi: * Valore singolare: value: 10.5 * Intervallo limitato: value_range {min_value: 5.5, max_value 10.5} * Limite inferiore: value_range {min_value: 5.5} * Limite superiore: value_range {max_value: 10.5}

Campi

Campo unione value_options. (obbligatorio) value_options può essere solo uno dei seguenti:

value

double

Un valore singolare. Ad esempio: 5,6

value_range

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

RangeValue

Intervallo di valori tale che min_value < max_value. Richiede almeno uno dei seguenti valori: min_value e max_value.

Campi

min_value

double

Valore minimo.

max_value

double

Valore massimo.

Classificazione

Definisce la classificazione per un'entità.

Campi

value

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.

number_of_ratings

uint64

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

RelatedMedia

Foto relative a questo servizio. Google eseguirà la scansione di questi contenuti multimediali per assicurarsi che vengano visualizzati correttamente agli utenti finali. (facoltativo)

Campi
`url`	`string` URL di questa fonte multimediale. Google eseguirà la scansione dei contenuti multimediali ospitati a questo URL.
`type`	`MediaType` Tipo di questa fonte multimediale.
`localized_caption`	`Text` Didascalia dei contenuti multimediali che supportano i18n. È supportato solo il testo normale. Verranno rimossi tutti i componenti HTML. (facoltativo)
`attribution`	`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)
`caption (deprecated)`	`string` Questo elemento è deprecato. Deprecato, preferibile usare localized_caption.

Attribuzione

Informazioni sull'attribuzione per questi contenuti multimediali.

Campi

localized_text

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

text
(deprecated)

string

Deprecato, preferibile usare localized_text.

MediaType

Enum per indicare il tipo di questa origine multimediale. Sono supportate solo le foto. Contatta il team di Prenota con Google se è necessario supportare altri contenuti multimediali oltre alle foto.

Enum
`TYPE_UNSPECIFIED`	Non utilizzato.
`PHOTO`	Indica che l'elemento multimediale fornito dall'URL è una foto.

ReplaceServiceAvailabilityRequest

Richiesta di sostituzione della disponibilità di Service.

Campi

service_availability

ServiceAvailability

La disponibilità del servizio utilizzata per sostituire quelle esistenti.

RequireCreditCard

Definisce se è necessaria una carta di credito per prenotare un appuntamento.

Enum
`REQUIRE_CREDIT_CARD_UNSPECIFIED`	Il requisito della carta di credito non è esplicitamente specificato e il comportamento è identico a quello specificato per CONDIZIONALE.
`REQUIRE_CREDIT_CARD_CONDITIONAL`	Google richiederà una carta di credito per la prenotazione se si verifica una delle seguenti condizioni: * la disponibilità ha un prezzo e prepayment_type è REQUIRED * il no_show_fee è impostato * il campo del deposito è impostato.
`REQUIRE_CREDIT_CARD_ALWAYS`	Per prenotare questa disponibilità è sempre richiesta una carta di credito, indipendentemente dagli altri valori dei campi.

Risorse

Una risorsa viene utilizzata per distinguere gli slot di disponibilità l'uno dall'altro quando diversi membri del personale o sale fanno parte del servizio. Più slot per lo stesso servizio e lo stesso intervallo di tempo possono coesistere quando hanno risorse diverse.

Campi
`staff_id`	`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.
`staff_name`	`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.
`room_id`	`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.
`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.
`party_size`	`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.

SchedulingRules

Le regole di pianificazione di un servizio.

Campi
`min_advance_online_canceling`	`int64` Il preavviso minimo in secondi necessario per annullare un appuntamento prenotato online. (facoltativo)
`late_cancellation_fee (deprecated)`	`Price` Questo elemento è deprecato. La commissione per l'annullamento entro il periodo minimo di preavviso.
`noshow_fee (deprecated)`	`Price` Questo elemento è deprecato. La commissione per il mancato arrivo senza cancellazione.
`admission_policy`	`AdmissionPolicy` Le norme di ammissione che si applicano a questo servizio. Se non viene configurato, il valore predefinito è TIME_STRICT. (facoltativo)
`cancellation_policy`	`CancellationPolicy` Criterio di annullamento delle regole di pianificazione. (obbligatorio per le Cose da fare)
Campo unione `min_booking_buffer`. La durata (in secondi) da quando può essere effettuata l'ultima prenotazione all'inizio o alla fine dello slot di disponibilità. Se "min_advance_booking" l'ora dell'ultima prenotazione viene calcolata come segue: (<slot start time> - "min_advance_booking"). Se "min_booking_buffer_before_end_time" l'ora dell'ultima prenotazione viene calcolata come segue: (<slot end time> - "min_booking_buffer_before_end_time"). Tieni presente che il valore di "min_booking_buffer_before_end_time" deve essere positivo se impostato. Se non vengono impostati entrambi, lo spazio può essere prenotato fino all'ora di inizio dello slot. Se sono impostati entrambi i campi, verrà selezionato un solo valore mentre l'altro verrà ignorato. Non possiamo prevedere in modo affidabile quale valore viene scelto. Esempi: Un taglio di capelli da prenotare almeno un'ora prima dell'ora di inizio. 'scheduling_rules{ min_advance_booking: 3600 ...}` Un museo in cui è possibile acquistare l'ultimo biglietto 30 minuti prima della chiusura: 'scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}" Un biglietto del cinema che deve essere acquistato prima dell'ora di inizio. 'scheduling_rules{ ...}' (Lascia vuoto questo campo) (facoltativo) `min_booking_buffer` può essere solo uno dei seguenti:
`min_advance_booking`	`int64` La durata (in secondi) da quando può essere effettuata l'ultima prenotazione a quando inizia lo slot di disponibilità.
`min_booking_buffer_before_end_time`	`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.

AdmissionPolicy

Le norme di ammissione di questo servizio.

Enum
`ADMISSION_POLICY_UNSPECIFIED`	Non utilizzato.
`TIME_STRICT`	I clienti devono essere presenti all'ora di inizio dello slot di disponibilità e il servizio dovrebbe terminare all'ora di fine dello slot. Esempi di casi d'uso di TIME_STRICT: * un tour che inizia alle 09:00 e richiede che tutti i partecipanti arrivino all'ora di inizio e tornino intorno alle 12:00. * Una prenotazione di taglio capelli alle 15:00 di sabato che durerà circa 30 minuti. * Una lezione di fitness dalle 18:00 alle 20:00.
`TIME_FLEXIBLE`	Per utilizzare questa prenotazione, i clienti possono arrivare in qualsiasi momento tra l'ora di inizio e l'ora di fine dello slot di disponibilità. Esempi di casi d'uso di TIME_FLEXIBLE: * biglietto per un museo che può essere utilizzato in qualsiasi momento dalla data di acquisto. * Un ingresso pomeridiano a un parco divertimenti utilizzabile dalle 12:00 alle 21:00.
`TIMED_ENTRY_WITH_FLEXIBLE_DURATION`	I clienti devono arrivare al commerciante all'ora di inizio della fascia di disponibilità, ma possono partire in qualsiasi momento. Ad esempio, nello scenario di ingresso al museo, un biglietto di ingresso con orario prestabilito per le 10:00 richiede che l'utente si trovi al museo alle 10:00. L'ora di inizio degli slot di disponibilità per questo servizio rappresenta l'ora di ingresso designata. L'ora di fine, tuttavia, viene utilizzata esclusivamente come chiave per identificare la fascia di disponibilità per la prenotazione.

Servizio

Informazioni su un servizio fornito dal commerciante, ad esempio taglio di capelli.

Campi
`name`	`string` Il nome della risorsa di servizio, nel formato `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}`.
`service_name`	`string` Il nome del servizio, ad esempio "Taglio di capelli da uomo". Deprecato, utilizza invece localized_service_name.
`localized_service_name`	`Text` Il nome del servizio, ad esempio "Taglio di capelli da uomo". Possibilmente in diverse lingue.
`description`	`string` La descrizione del servizio visibile all'utente. Deprecato, usa localized_description al suo posto.
`localized_description`	`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. <br> 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`	`Price` Il prezzo del servizio.
`price_interpretation`	`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.
`rules`	`SchedulingRules` Regole per prenotare/annullare un appuntamento.
`prepayment_type`	`PrepaymentType` Indica se un pagamento anticipato è obbligatorio, facoltativo o non supportato.
`prepayment_terms`	`PrepaymentTerms` Termini relativi al completamento del pagamento anticipato.
`form[] (deprecated)`	`ServiceIntakeForm` Questo elemento è deprecato. Deprecato. Utilizza intake_form e per_ticket_intake_form.
`intake_form`	`ServiceIntakeForm` Un modulo per richiedere ulteriori informazioni all'utente quando prenota questo servizio. (facoltativo)
`per_ticket_intake_form`	`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)
`tax_rate`	`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.
`payment_option_id[]`	`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`	`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)
`no_show_fee`	`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)
`require_credit_card`	`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)
`action_link[]`	`ActionLink` Un link all'azione relativo a questo servizio. Se esiste un link all'azione, è necessario impostare il tipo (vedi di seguito) nel servizio.
`type`	`ServiceType` Il tipo predefinito di questo servizio. (facoltativo)
`ticket_type[]`	`TicketType` Tipi di biglietti che possono essere prenotati/acquistati per questo servizio, se i biglietti sono supportati. (facoltativo)
`related_media[]`	`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)
`service_attribute_value_id[]`	`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)
`waitlist_rules`	`WaitlistRules` Regole per iscriversi alla lista d'attesa.
`ticketing_vertical_specific_data`	`TicketingVerticalSpecificData` Informazioni aggiuntive specifiche per il verticale della vendita di biglietti per eventi. (facoltativo)
`integration_type`	`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.
`per_order_fee`	`PerOrderFee` Tariffe a livello di ordine per l'acquisto di questo servizio. (facoltativo)
`tours_and_activities_content`	`ToursAndActivitiesContent` Campi dei contenuti specifici di Tour e Attività.
`location[]`	`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`	`Rating` Valutazione degli utenti per questo servizio come metrica aggregata in tutte le recensioni.
`home_service_data`	`HomeServiceData` Informazioni aggiuntive specifiche per il verticale dei servizi a domicilio. (facoltativo)
`virtual_session`	`VirtualSession` (Facoltativo) Informazioni sulla sessione virtuale. È obbligatorio per abilitare i servizi virtuali.
`direct_merchant_payment`	`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.

PrepaymentTerms

Informazioni specifiche su quando è stato completato il pagamento anticipato.

Campi

charge_timing

ChargeTiming

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

charge_time_before_start_time_sec

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.

ChargeTiming

Enum per specificare quando verrà eseguito l'addebito in relazione al momento dell'acquisto.

Enum
`CHARGE_TIMING_UNSPECIFIED`	Non utilizzato.
`CHARGE_NOW`	L'importo verrà addebitato immediatamente al cliente.
`CHARGE_LATER`	L'addebito al cliente verrà effettuato in un secondo momento.

PrepaymentType

Enum per indicare il tipo di pagamento anticipato.

Enum
`PREPAYMENT_TYPE_UNSPECIFIED`	Per impostazione predefinita, supponiamo che il pagamento anticipato sia NOT_SUPPORTED.
`REQUIRED`	L'utente deve pagare questo servizio al momento della prenotazione.
`OPTIONAL`	L'utente può scegliere di pagare in anticipo questo servizio al momento della prenotazione o in un secondo momento, ma non è obbligatorio per la prenotazione.
`NOT_SUPPORTED`	Il pagamento anticipato non è supportato per questo servizio.

ServiceType

Tipi di servizi predefiniti.

Enum
`SERVICE_TYPE_UNSPECIFIED`	Non utilizzato.
`SERVICE_TYPE_DINING_RESERVATION`	Prenotazione di pasti.
`SERVICE_TYPE_FOOD_ORDERING`	Ordinazione di cibo a domicilio, da asporto o su entrambe le opzioni.
`SERVICE_TYPE_FOOD_DELIVERY`	Consegna di cibo a domicilio.
`SERVICE_TYPE_FOOD_TAKEOUT`	Cibo da asporto.
`SERVICE_TYPE_EVENT_TICKET`	Biglietto per un evento.
`SERVICE_TYPE_TRIP_TOUR`	Tour di viaggio.
`SERVICE_TYPE_APPOINTMENT`	Servizio che fornisce appuntamenti o corsi. Consigliati per (1) salute e fitness, (2) servizi di bellezza e benessere e (3) consulenze e valutazioni finanziarie. Consulta i tipi di servizi supportati: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
`SERVICE_TYPE_ONLINE_APPOINTMENT`	Servizio che fornisce un appuntamento online per un corso o una sessione che sarà completamente virtuale. Deve essere impostato se abiliti le prenotazioni di servizi virtuali.
`SERVICE_TYPE_SHOPPING`	Servizio che consente agli utenti di fare acquisti presso il commerciante in questione. Può essere la consegna a domicilio o il ritiro.

ServiceAttribute

Gli attributi dei servizi sono categorie definite dai partner che descrivono i Servizi di un Commerciante. Ad esempio, una banca può definire un "Tipo di conto bancario" attributo di servizio con possibili valori di "Personale" e "Attività", mentre un parrucchiere può definire un "Tipo di servizio" attributo di servizio con possibili valori di "Taglio di capelli", "Colore" e "Stile".

Campi

attribute_id

string

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

attribute_name

string

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

value[]

Value

Tutti i valori possibili per questo attributo di servizio.

Valore

Rappresenta un valore possibile per un particolare attributo di servizio.

Campi

value_id

string

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

value_name

string

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

ServiceAttributeValueId

Identifica un particolare valore di un attributo di servizio da applicare a un servizio.

Campi

attribute_id

string

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

value_id

string

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

ServiceAvailability

Un elenco della disponibilità e di chi/quando devono essere applicati.

Campi
`name`	`string` Il nome della risorsa del servizio a cui applicarlo. Nel formato `partners/{partner_id}/merchants/{merchant_id}/services/{service_id}`
`start_time_restrict`	`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.
`end_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_restrict`	`Duration` L'impostazione della durata limita ulteriormente l'ambito dell'aggiornamento alla sola disponibilità con durata corrispondente.
`resources_restrict`	`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[]`	`Availability` Il nuovo elenco di disponibilità.

ServiceIntakeForm

Definisce un modulo di accettazione che personalizza il servizio fornito da un commerciante.

Campi

field[]

ServiceIntakeFormField

Campi che verranno mostrati all'utente.

first_time_customers
(deprecated)

bool

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

returning_customers
(deprecated)

bool

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

ServiceIntakeFormField

Definisce un campo incluso in un ServiceIntakeForm.

Campi
`id`	`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)
`type`	`FieldType` Il tipo di questo campo.
`label`	`string` Il testo mostrato all'utente per questo campo. Deprecato, usa `localized_label`.
`localized_label`	`Text` Il testo mostrato all'utente per questo campo. Il campo può essere specificato in più impostazioni internazionali. (obbligatorio)
`value[]`	`string` Impostalo solo se il tipo di campo è LOCATION_SEARCH. Utilizza "location_id" nella "località" per specificare il valore della località.
`choice_text[]`	`Text` Impostalo solo se il tipo di campo è MULTIPLE_CHOICE, CHECKBOXES o DROPDOWN. Utilizzato per enumerare le scelte possibili.
`is_required`	`bool` Indica se un utente richiede una risposta a questo campo.
`allow_custom_answer`	`bool` Indica se è consentito un valore personalizzato in aggiunta alle risposte predefinite. Ciò è applicabile solo quando il tipo di campo è LOCATION_SEARCH. (facoltativo)
`additional_option[]`	`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)
`ticket_type_restrict[]`	`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.
`hint`	`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)

FieldType

Enum per indicare il tipo di campo.

Enum
`FIELD_TYPE_UNSPECIFIED`	I campi di tipo non specificato o sconosciuto verranno ignorati.
`SHORT_ANSWER`	Un campo di immissione di una riga per il testo.
`PARAGRAPH`	Un campo di immissione su più righe per il testo.
`MULTIPLE_CHOICE`	Un insieme di pulsanti di opzione che richiede una sola scelta tra più opzioni.
`CHECKBOXES`	Uno o più elementi enumerati con caselle di controllo.
`DROPDOWN`	Una selezione da un menu a discesa.
`BOOLEAN`	Un pulsante Sì/No.
`LOCATION_SEARCH`	Una casella di ricerca che supporta la ricerca di una località corrispondente inserita dall'utente nell'elenco delle località fornito.

TaxRate

Un'aliquota fiscale applicata quando addebiti un servizio all'utente, che può essere impostata a livello di commerciante o di servizio.

Campi

micro_percent

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.

Termini

Un insieme di regole e linee guida che vengono mostrate all'utente per effettuare una prenotazione tramite Prenota con Google.

Campi

url

string

Facoltativamente, l'URL dei Termini e condizioni.

text

string

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

localized_text

Text

Il testo localizzato da mostrare all'utente.

Testo

Payload di testo potenzialmente localizzato. Alcuni campi di testo potrebbero includere contenuti sottoposti a markup.

Campi

value

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.

localized_value[]

LocalizedString

Valori di testo per ogni lingua. (Facoltativo)

TicketType

TicketType viene utilizzato per differenziare i biglietti con prezzi e/o disponibilità diversi a causa di tipi di utenti diversi, attributi di servizio diversi o opzioni/componenti aggiuntivi differenti.

Il biglietto è l'unità minima prenotabile per un servizio, ad esempio un luogo per un'escursione di rafting, un ingresso a un museo, un noleggio di due kayak per un'intera giornata.

Campi
`ticket_type_id`	`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.
`short_description`	`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.
`localized_short_description`	`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`	`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.
`per_ticket_fee`	`PerTicketFee` Costi aggiuntivi per l'acquisto di questo biglietto. (facoltativo)
`option_description`	`string` Descrizione di qualsiasi opzione aggiuntiva rappresentata da questo tipo di ticket, se presente. Deprecato, utilizza invece localized_option_description.
`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: "child" } localized_option_description { value: "english" } } - { ticket_type_id: "ticket_type_4" localized_short_description { value: "child" } 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."

TicketingVerticalSpecificData

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

Campi
`event_category`	`EventCategory` La categoria dell'evento. Impostato solo quando l'evento rientra in una delle categorie predefinite. (facoltativo)
`event_url`	`string` L'URL dell'evento sul sito web del partner. (facoltativo)
`entity[]`	`Entity` Un elenco di entità correlate all'evento. (facoltativo)
`event_attendance_mode`	`AttendanceMode` Obbligatorio. Il tipo di partecipazione all'evento.
`event_virtual_location_url[]`	`string` (Facoltativo) URL in cui è possibile guardare l'evento.
`event_organizer`	`Text` (Facoltativo) Organizzatore che ospita l'evento.
`event_organizer_url`	`string` (Facoltativo) URL dell'organizzatore che ospita l'evento.
`event_organizer_type`	`OrganizerType` (Facoltativo) Il tipo di organizzatore.
`event_source_url[]`	`string` Obbligatorio. URL delle pagine in cui sono disponibili le informazioni o le descrizioni degli eventi.
`event_state`	`EventState` (Facoltativo) Stato dell'evento.

AttendanceMode

Il tipo di partecipazione all'evento.

Enum
`ATTENDANCE_MODE_UNSPECIFIED`	Non specificato.
`ONLINE`	Per eventi virtuali.
`PHYSICAL`	Per eventi fisici.
`PHYSICAL_ONLINE_MIXED`	Per eventi fisici e virtuali.

Entità

Rappresenta un'entità correlata all'evento.

Campi
`id`	`string` Identificatore univoco dell'entità nel database del partner. (facoltativo)
`name`	`string` Nome dell'entità. (obbligatorio)
`url`	`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)
`entity_type`	`EntityType` Il tipo di entità. (facoltativo)
`entity_role`	`EntityRole` Il ruolo dell'entità nell'evento. (facoltativo)
`public_identification_data`	`PublicIdentificationData` Riferimenti pubblici dell'entità. (facoltativo)

EntityRole

Il ruolo dell'entità nell'evento.

Enum
`ENTITY_ROLE_UNSPECIFIED`	Non specificato.
`ENTITY_ROLE_HEADLINER`	L'entità rappresenta un protagonista o un performer principale dell'evento.
`ENTITY_ROLE_SUPPORTER`	L'entità rappresenta un artista di supporto all'evento.
`ENTITY_ROLE_HOME_TEAM`	L'entità rappresenta la squadra di casa all'evento (sportivo).
`ENTITY_ROLE_AWAY_TEAM`	L'entità rappresenta la squadra di ricognizione all'evento (sportivo).

EntityType

Il tipo di entità. Nota: questa funzione non è destinata a essere un'ontologia universale.

Enum
`ENTITY_TYPE_UNSPECIFIED`	Non specificato. Non utilizzare.
`ENTITY_TYPE_PERFORMER`	L'entità rappresenta l'artista o il gruppo che si esibisce a un concerto o uno spettacolo. Applicabile solo quando la categoria dell'evento è CONCERTO o TEMA.
`ENTITY_TYPE_PLAYER`	L'entità rappresenta la squadra o il giocatore dell'evento. Applicabile solo quando la categoria evento è SPORT.
`ENTITY_TYPE_CONCERT_TOUR`	L'entità rappresenta il tour a cui appartiene questo evento. Applicabile solo quando la categoria dell'evento è CONCERT.
`ENTITY_TYPE_SPORTS_SERIES`	L'entità rappresenta un torneo sportivo a cui appartiene questo evento. Applicabile solo quando la categoria evento è SPORT.
`ENTITY_TYPE_PLAY`	L'entità rappresenta il tipo di opera eseguita nell'evento (ad es. musicale, commedia, balletto e così via). Applicabile solo quando la categoria evento è THEATRE.

EventCategory

Un sottoinsieme di categorie di eventi per cui personalizziamo l'esperienza del prodotto. Nota: questa funzionalità non è destinata a essere un'ontologia universale di eventi.

Enum
`EVENT_CATEGORY_UNSPECIFIED`	Non specificato. Non utilizzare.
`EVENT_CATEGORY_CONCERT`	Concerti.
`EVENT_CATEGORY_SPORTS`	Eventi sportivi.
`EVENT_CATEGORY_THEATRE`	Eventi teatrali.
`EVENT_CATEGORY_EXHIBITS`	Mostre.
`EVENT_CATEGORY_WORKSHOPS_AND_CLASSES`	Workshop e corsi.

EventState

Stato dell'evento.

Enum
`EVENT_STATE_UNSPECIFIED`	Non specificato.
`SCHEDULED`	L'evento è pianificato.
`RESCHEDULED`	L'evento viene riprogrammato.
`CANCELLED`	L'evento è annullato.
`POSTPONED`	L'evento è stato posticipato.

OrganizerType

Il tipo di organizzatore.

Enum
`ORGANIZER_TYPE_UNSPECIFIED`	Non specificato.
`PERSON`	Per l'organizzatore che è una persona.
`ORGANIZATION`	Per gli organizzatori che fanno parte di un'organizzazione.

PublicIdentificationData

Identificatori, pagine web o altre fonti pubbliche che fanno riferimento a un'entità.

Campi

relevant_url[]

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)

musicbrainz_id

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)

TimeRange

Un intervallo di tempo aperto, ad esempio [start_time, end_time).

Campi

start_time

Il limite inferiore dell'intervallo di tempo.

end_time