- Risorsa: servizio
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition
- PrepaymentType
- PrepaymentTerms
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType (Tipo di biglietto)
- PerTicketFee
- RelatedMedia
- MediaType
- Attribuzione
- ServiceAttributeValueId
- WaitlistRules
- UnsupportedPartySizeOption
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- Entità
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- IntegrationType
- PerOrderFee
- ToursAndActivitiesContent
- Località
- LocationType
- Valutazione
- HomeServiceData
- VirtualSession
- VirtualPlatformInfo
- Piattaforma
- DirectMerchantPayment
- Metodi
Risorsa: servizio
Informazioni su un servizio fornito dal commerciante, ad esempio taglio di capelli.
Rappresentazione JSON |
---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
Campi | |
---|---|
name |
Il nome della risorsa di servizio, che ha il formato |
serviceName |
Il nome del servizio, ad esempio "Taglio capelli da uomo". Deprecato, utilizza localizedServiceName. |
localizedServiceName |
Il nome del servizio, ad esempio "Taglio capelli da uomo". Probabilmente in più paesi. |
description |
La descrizione del servizio visibile all'utente. Deprecato, utilizza localizedDescription. |
localizedDescription |
La descrizione del servizio visibile all'utente. Questo campo supporta sia la formattazione di testo normale sia la formattazione HTML. A differenza delle sezioni di testo normale, qui puoi creare layout personalizzati utilizzando intestazioni, paragrafi, elenchi e alcuni tag a frase. Leggi attentamente le istruzioni e le note seguenti per assicurarti di creare la migliore esperienza utente. Tag di formattazione simili a HTML supportati: Tag intestazione: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> Tag di paragrafo: <p> Elenca tag: <ul>, <ol>, <li> Tag di divisione: <div> Tag a frase: <br>, <strong>, <em>: Tag non supportati:
Note importanti:
|
price |
Il prezzo del servizio. |
priceInterpretation |
Descrive come il prezzo viene interpretato e mostrato all'utente. Può essere utilizzato da qualsiasi verticale, ad eccezione di Ristoranti e Cose da fare, per configurare la visualizzazione del prezzo del servizio. |
rules |
Regole per prenotare/annullare un appuntamento. |
prepaymentType |
Indica se un pagamento anticipato è obbligatorio, facoltativo o non supportato. |
prepaymentTerms |
Termini relativi al completamento del pagamento anticipato. |
form[] |
Deprecato. Utilizza intakeForm e perTicketIntakeForm. |
intakeForm |
Un modulo che richiede informazioni aggiuntive all'utente quando prenota questo servizio. (facoltativo) |
perTicketIntakeForm |
Un modulo che richiede informazioni aggiuntive all'utente quando prenota questo servizio. Questo modulo deve essere compilato una volta per ogni biglietto prenotato dall'utente. (facoltativo) |
taxRate |
L'aliquota fiscale del servizio. Se presente, questo campo sostituisce qualsiasi aliquota fiscale impostata a livello di commerciante. Se visualizzi un messaggio vuoto (ad es. taxRate { }), l'aliquota fiscale applicata viene azzerata. |
paymentOptionId[] |
Un elenco di ID che fanno riferimento alle opzioni di pagamento utilizzabili per pagare questo servizio. Le opzioni di pagamento effettive sono definite a livello di commerciante e possono anche essere condivise tra più commercianti. |
deposit |
Definisce in che modo un bonifico potrebbe essere addebitato all'utente. Sostituisce il deposito di servizio, se ne è stato specificato uno. Se imposti il messaggio di deposito vuoto, gli eventuali versamenti a livello di servizio verranno rimossi. (facoltativo) |
noShowFee |
Definisce una tariffa per il mancato arrivo che potrebbe essere addebitata all'utente. Sostituisce la commissione di mancato arrivo del servizio, se ne è stata specificata una. L'impostazione di un messaggio NoShowFee vuoto rimuove qualsiasi tariffa per mancato arrivo a livello di servizio. (facoltativo) |
requireCreditCard |
Indica se l'utente deve fornire una carta di credito per prenotare il servizio. Questo campo può essere sostituito a livello di disponibilità. (facoltativo) |
actionLink[] |
Un link di azione relativo a questo servizio. Se esiste il link all'azione, è necessario impostare il tipo (vedi di seguito) nel servizio. |
type |
Il tipo predefinito di questo servizio. (facoltativo) |
ticketType[] |
Tipi di biglietti che possono essere prenotati/acquistati per questo servizio, se supportati. (facoltativo) |
relatedMedia[] |
Foto correlate a questo servizio. Google eseguirà la scansione e archivierà i contenuti multimediali per assicurarsi che vengano mostrati agli utenti finali nel modo più efficiente possibile. (facoltativo) |
serviceAttributeValueId[] |
Valori degli attributi del servizio che si applicano a questo servizio (facoltativo). Ogni Servizio può avere zero o più valori per ciascun attributo di servizio definito nel Commerciante corrispondente. (facoltativo) |
waitlistRules |
Regole per iscriversi alla lista d'attesa. |
ticketingVerticalSpecificData |
Informazioni aggiuntive specifiche per il verticale della vendita di biglietti per eventi. (facoltativo) |
integrationType |
Livello di integrazione supportato per questo servizio. (Facoltativo) Non pertinente per i partner con l'integrazione del comando iniziale. La modalità end-to-end sarà sempre disattivata per questi partner. |
perOrderFee |
Commissioni a livello di ordine per l'acquisto di questo servizio. (facoltativo) |
toursAndActivitiesContent |
Campi di contenuti specifici per i tour e le attività. |
location[] |
Sedi correlate a questo servizio. NOTE IMPORTANTI: se ci sono più località visitate correlate a questo servizio o se la START_LOCATION è diversa da VISITED_LOCATION, è necessario specificare START_LOCATION. Esempio: - Un tour guidato in bicicletta con visita a tre luoghi, il punto di partenza deve essere specificato. - Riunione per un tour in autobus nella hall di un hotel con visita al luogo visitato. Il luogo della riunione deve essere specificato. |
rating |
Valutazione degli utenti per questo servizio come metrica aggregata su tutte le recensioni. |
homeServiceData |
Informazioni aggiuntive specifiche per il verticale di servizi a domicilio. (facoltativo) |
virtualSession |
Campo facoltativo. Informazioni sulla sessione virtuale. È obbligatorio per abilitare i servizi virtuali. |
directMerchantPayment |
Campo facoltativo. Informazioni aggiuntive che devono essere aggiunte se il servizio richiede all'utente di pagare direttamente al commerciante. NOTA IMPORTANTE: RwG non è coinvolto in questa transazione. È obbligatorio se virtualSession è definita e il servizio non è senza costi o prepaymentType NON è impostato su REQUIRED. |
PriceInterpretation
Descrive come un prezzo dovrebbe 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 è noto e mostrato ai consumatori un prezzo minimo. I consumatori possono fare scelte che aumentano il prezzo. Tieni presente che qualsiasi servizio che utilizza questa interpretazione del prezzo deve utilizzare il valore PrepaymentType NOT_SUPPORTED. Esempi: 30 $ per la toelettatura dei cani, ma ulteriori scelte per i consumatori potrebbero aumentare il prezzo |
NOT_DISPLAYED |
Quando il prezzo di un servizio è variabile e le informazioni sui prezzi non vengono mostrate 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: una consulenza per un servizio a domicilio |
SchedulingRules
Le regole di pianificazione per un servizio.
Rappresentazione JSON |
---|
{ "minAdvanceOnlineCanceling": string, "lateCancellationFee": { object ( |
Campi | |
---|---|
minAdvanceOnlineCanceling |
Il preavviso minimo in secondi necessario per annullare un appuntamento prenotato online. (facoltativo) |
lateCancellationFee |
La tariffa per l'annullamento entro il periodo di preavviso minimo. |
noshowFee |
La commissione per mancato arrivo senza annullamento. |
admissionPolicy |
Le norme di ammissione che si applicano a questo servizio. Se non viene configurato, il valore predefinito è TIME_STRICT. (facoltativo) |
cancellationPolicy |
Criterio di annullamento delle regole di pianificazione. (obbligatorio per le Cose da fare) |
Campo di unione Se è impostato "min_advance_booking", l'ultimo orario prenotabile viene calcolato come (<slot start time> - "min_advance_booking"). Se è impostato "min_booking_buffer_before_end_time", l'ultima ora prenotabile viene calcolata come (<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 entrambi i valori non sono impostati, lo slot è prenotabile 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 venga scelto. Esempi:
|
|
minAdvanceBooking |
La durata (in secondi) da quando può essere effettuata l'ultima prenotazione a quando inizia lo slot di disponibilità. |
minBookingBufferBeforeEndTime |
La durata (in secondi) da quando può essere effettuata l'ultima prenotazione a quando termina lo slot di disponibilità. Se questo campo è impostato, il campo "admissionPolicy" deve essere impostato su TIME_FLEXIBLE per indicare che gli utenti possono utilizzare i biglietti acquistati dopo l'inizio degli slot. |
AdmissionPolicy
Le norme per l'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 torni intorno alle 12:00. * Prenotazione di un taglio di capelli alle 15:00 di sabato; richiederà 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 TIME_FLEXIBLE: * un biglietto del museo che può essere utilizzato in qualsiasi momento nella data di acquisto. * Ingresso pomeridiano a un parco divertimenti aperto dalle 12:00 alle 21:00. |
TIMED_ENTRY_WITH_FLEXIBLE_DURATION |
I clienti devono arrivare al commerciante all'ora di inizio dello slot di disponibilità, ma possono partire in qualsiasi momento. Ad esempio, nello scenario di ingresso al museo, un biglietto con orario prestabilito alle 10:00 richiede che l'utente sia 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 lo slot di disponibilità per la prenotazione. |
CancellationPolicy
Norme relative all'annullamento di un servizio.
Rappresentazione JSON |
---|
{
"refundCondition": [
{
object ( |
Campi | |
---|---|
refundCondition[] |
Zero o più condizioni di rimborso applicabili alle norme. |
RefundCondition
Definisce una singola condizione di rimborso. È possibile utilizzare più condizioni di rimborso insieme per descrivere i "passaggi del rimborso" come diverse durate prima dell'ora di inizio del servizio.
Rappresentazione JSON |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
Campi | |
---|---|
minDurationBeforeStartTime |
Durata precedente all'ora di inizio, fino a quando il cliente può ricevere un rimborso per una parte del costo del servizio specificato in Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
refundPercent |
La percentuale rimborsabile, a condizione che la prenotazione del servizio venga annullata almeno |
PrepaymentType
Enum per indicare il tipo di pagamento anticipato.
Enum | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
Per impostazione predefinita, supporremo che il pagamento anticipato NON sia SUPPORTATO. |
REQUIRED |
L'utente deve pagare il 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 è necessario per prenotare. |
NOT_SUPPORTED |
Il pagamento anticipato non è supportato per questo servizio. |
PrepaymentTerms
Informazioni specifiche su quando viene completato il pagamento anticipato.
Rappresentazione JSON |
---|
{
"chargeTiming": enum ( |
Campi | |
---|---|
chargeTiming |
Il momento in cui l'addebito verrà effettuato in relazione al momento dell'acquisto. |
chargeTimeBeforeStartTimeSec |
Tempo, in secondi, prima dell'ora di inizio del servizio in cui il pagamento viene addebitato all'utente. Questo campo deve essere impostato solo quando ChargeTiming è CHARGE_LATER. |
ChargeTiming
Enum per specificare quando verrà effettuato l'addebito in relazione al momento dell'acquisto.
Enum | |
---|---|
CHARGE_TIMING_UNSPECIFIED |
Non utilizzato. |
CHARGE_NOW |
L'addebito al Cliente verrà effettuato immediatamente. |
CHARGE_LATER |
L'importo verrà addebitato al cliente in un secondo momento. |
ServiceIntakeForm
Definisce un modulo di accettazione che personalizza il servizio fornito da un commerciante.
Rappresentazione JSON |
---|
{
"field": [
{
object ( |
Campi | |
---|---|
field[] |
Campi che verranno mostrati all'utente. |
firstTimeCustomers |
Se il valore è true, questo modulo verrà mostrato ai nuovi clienti. Deprecato. Questa funzionalità non è supportata per i moduli di accettazione. |
returningCustomers |
Se il valore è 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.
Rappresentazione JSON |
---|
{ "id": string, "type": enum ( |
Campi | |
---|---|
id |
Una stringa di un partner aggregatore che identifica in modo univoco un campo del modulo. Questo ID deve essere uguale all'ID nella risposta al campo del modulo corrispondente e deve essere univoco in entrambi i moduli del livello di servizio e di accettazione dei ticket. (obbligatorio) |
type |
Il tipo di questo campo. |
label |
Il testo mostrato all'utente per questo campo. Deprecata. Utilizza |
localizedLabel |
Il testo mostrato all'utente per questo campo. Il campo può essere fornito in più impostazioni internazionali. (obbligatorio) |
value[] |
Da impostare solo se il tipo di campo è LOCATION_SEARCH. Utilizza "locationId" nel campo "location" per specificare il valore località. |
choiceText[] |
Impostala solo se il tipo di campo è MULTIPLE_CHOICE, CHECKBOXES o DROPDOWN. Utilizzato per enumerare le possibili scelte. |
isRequired |
Indica se una risposta a questo campo è obbligatoria da parte di un utente. |
allowCustomAnswer |
Indica se è consentito un valore personalizzato in aggiunta alle risposte predefinite. Si applica solo quando il tipo di campo è LOCATION_SEARCH. (facoltativo) |
additionalOption[] |
Opzioni aggiuntive fornite in aggiunta ai valori indicati. Applicabile solo se il tipo di campo è LOCATION_SEARCH. Ad esempio, in aggiunta all'elenco di posizioni fornito, un'altra opzione disponibile potrebbe essere "Contatterò il fornitore in seguito". (facoltativo) |
ticketTypeRestrict[] |
Se questa domanda deve essere visualizzata solo quando l'utente prenota determinati tipi di biglietti, questo campo deve essere impostato come insieme di ID tipi di ticket applicabili. Lascia vuoto il campo se la domanda è sempre applicabile. |
hint |
Il testo del suggerimento per l'input, visualizzato come segnaposto di testo. Questo vale solo se 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 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 supporti il rilevamento di località corrispondenti in base all'input utente dell'elenco di località fornito. |
ServiceType
Tipi di servizi predefiniti.
Enum | |
---|---|
SERVICE_TYPE_UNSPECIFIED |
Non utilizzato. |
SERVICE_TYPE_DINING_RESERVATION |
Prenotazione ristorante. |
SERVICE_TYPE_FOOD_ORDERING |
Ordinazione di cibo, ad esempio consegna di cibo a domicilio, asporto o entrambi. |
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 del viaggio. |
SERVICE_TYPE_APPOINTMENT |
Servizio che offre appuntamenti o corsi. Consigliati per (1) salute e fitness, (2) servizi di bellezza e benessere e (3) servizi di consulenza e valutazione finanziaria. Consulta i tipi di servizi supportati: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview |
SERVICE_TYPE_ONLINE_APPOINTMENT |
Servizio che offre appuntamenti online per una lezione o una sessione completamente virtuali. Deve essere impostato se abiliti le prenotazioni di servizi virtuali. |
SERVICE_TYPE_SHOPPING |
Servizio che consente agli utenti di fare acquisti presso un determinato commerciante. Può trattarsi della consegna o del ritiro. |
TicketType
TicketType viene utilizzato per distinguere i biglietti con prezzi e/o disponibilità diversi a causa dei diversi tipi di utenti, di attributi di servizio diversi o di opzioni/componenti aggiuntivi.
Un biglietto è l'unità minima prenotabile per un servizio, ad esempio un posto in una gita di rafting, un ingresso a un museo, un noleggio di kayak doppio giorno per un'intera giornata.
Rappresentazione JSON |
---|
{ "ticketTypeId": string, "shortDescription": string, "localizedShortDescription": { object ( |
Campi | |
---|---|
ticketTypeId |
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. |
shortDescription |
Una breve descrizione di questo TicketType. Può essere visibile all'utente, ad esempio "adult", "child", "veteran", "Row J" e così via. Obbligatorio, ogni tipo di biglietto deve avere una descrizione per essere visibile all'utente. Deprecato, utilizza localizedShortDescription. |
localizedShortDescription |
Una breve descrizione di questo TicketType con supporto i18n. Può essere visibile all'utente, ad esempio "adult", "child", "veteran", "Row J" e così via. Obbligatorio, ogni tipo di biglietto deve avere una descrizione per essere visibile all'utente. È possibile specificare valori separati per ogni impostazione internazionale. |
price |
Il prezzo di un biglietto singolo di questo tipo, al netto di eventuali tasse. L'aliquota fiscale del servizio viene applicata ai ticket. |
perTicketFee |
Costi aggiuntivi per l'acquisto di questo biglietto. (facoltativo) |
optionDescription |
Descrizione di eventuali opzioni aggiuntive rappresentate da questo tipo di biglietto, se presenti. Deprecato, utilizza localizedOptionDescription. |
localizedOptionDescription |
Descrizione di eventuali opzioni aggiuntive rappresentate da questo tipo di biglietto, se presenti. È possibile specificare valori separati per ogni impostazione internazionale. Opzioni aggiuntive sono utili quando il tipo di biglietto rappresenta più dimensioni. Esempio 1: un biglietto d'ingresso con tipi diversi 'adult', 'child' e lingua come opzione aggiuntiva: 'adult', 'child' e lingua come ulteriore opzione, l'elenco TicketType previsto sarebbe: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" adultDescription localized value Esempio 2: un noleggio di kayak di più ore con un componente aggiuntivo di borsa asciutto facoltativo {localized_bag}, il shortDescription potrebbe essere "3 ore" e l'attributo optionDescription potrebbe essere "con borsa asciutta" o "senza borsa asciutta": - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localizedShortDescription { value: "english" } } localized_ticket"Option_biglietto Facoltativo. Tuttavia, se questo campo è impostato per qualsiasi tipo di ticket all'interno del servizio, è previsto che venga impostato anche questo campo per tutti gli altri tipi di ticket (è possibile utilizzare un valore optionDescription predefinito). Ad esempio, [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] non è un elenco valido. Sono supportati solo due tag di formattazione HTML: e |
PerTicketFee
Commissioni che devono essere pagate per ogni biglietto acquistato dall'utente.
Rappresentazione JSON |
---|
{ "serviceCharge": { object ( |
Campi | |
---|---|
serviceCharge |
È previsto un supplemento per un servizio. |
facilityFee |
Una commissione da versare alla sede/strutture. |
taxes |
Tasse per biglietto. |
RelatedMedia
Foto correlate a questo servizio. Google eseguirà la scansione di questi contenuti multimediali per verificare che vengano visualizzati correttamente per gli utenti finali. (facoltativo)
Rappresentazione JSON |
---|
{ "url": string, "type": enum ( |
Campi | |
---|---|
url |
URL di questa fonte multimediale. Google eseguirà la scansione dei contenuti multimediali ospitati a questo URL. |
type |
Tipo di questa fonte multimediale. |
localizedCaption |
Didascalia dei contenuti multimediali che supportano i18n; è supportato solo il testo normale. Tutti i componenti HTML verranno rimossi. (facoltativo) |
attribution |
Informazioni sull'attribuzione sulla fonte del contenuto multimediale. Tieni presente che se l'attribuzione deve essere mostrata con i media per citare il fotografo o l'agenzia, questo campo deve essere impostato. (facoltativo) |
caption |
Funzionalità ritirata: è preferibile utilizzare localizedCaption. |
MediaType
Enum per indicare il tipo di origine multimediale. Sono supportate solo le foto. Se è necessario supportare altri contenuti multimediali oltre alle foto, contatta il team di Prenota con Google.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Non utilizzato. |
PHOTO |
Indica che il contenuto multimediale fornito dall'URL è una foto. |
Attribuzione
Informazioni sull'attribuzione per questo contenuto multimediale.
Rappresentazione JSON |
---|
{
"localizedText": {
object ( |
Campi | |
---|---|
localizedText |
Il testo da citare al fotografo o all'agenzia che supporta i18n. Questo testo verrà visualizzato insieme al contenuto multimediale di origine. Tieni presente che per questo campo è supportato solo il testo normale; tutti i componenti HTML verranno rimossi (l'attribuzione basata sui link ipertestuali non è supportata). |
text |
Obsoleta, è preferibile utilizzare localizedText. |
ServiceAttributeValueId
Identifica un particolare valore di un attributo di servizio da applicare a un servizio.
Rappresentazione JSON |
---|
{ "attributeId": string, "valueId": string } |
Campi | |
---|---|
attributeId |
ID di un attributo definito in Merchant.service_attribute, ad esempio "service-type". |
valueId |
ID del valore per questo attributo, ad esempio "taglio di capelli". Deve corrispondere a un valore valueId nella definizione dell'attributo di servizio. |
WaitlistRules
Regole relative all'iscrizione alla lista d'attesa.
Rappresentazione JSON |
---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
Campi | |
---|---|
minPartySize |
Obbligatorio. Deve essere un numero intero positivo per i servizi che forniscono funzionalità della lista d'attesa. Se il servizio o il commerciante non fornisce la funzionalità della lista d'attesa, è necessario compilare questo campo. |
maxPartySize |
Obbligatorio. Deve essere un numero intero positivo per i servizi che forniscono funzionalità della lista d'attesa. Se il servizio o il commerciante non fornisce la funzionalità della lista d'attesa, è necessario compilare questo campo. |
supportsAdditionalRequest |
Se il valore è true, l'utente potrà inviare una richiesta di testo aggiuntiva in formato libero quando si iscrive alla lista d'attesa per questo servizio. |
aboveMaxPartySizeOptions[] |
Imposta opzioni per gruppi di dimensioni superiori al valore maxPartySize impostato. Lascia il campo vuoto se non devono essere offerte opzioni alternative per l'iscrizione a una lista d'attesa per gruppi di grandi dimensioni. |
UnsupportedPartySizeOption
Opzioni per i gruppi fuori intervallo.
Rappresentazione JSON |
---|
{
"callMerchant": {
object ( |
Campi | |
---|---|
callMerchant |
Il numero di persone che non rientra nell'intervallo consentito può chiamare l'attività. All'utente verrà mostrato un messaggio predefinito. Testo di esempio da mostrare: "Per gruppi di numero maggiore di {waitlistRules.max_party_size}, chiama il ristorante al numero {phone}." CallMerchant deve essere impostato, ma sarà vuoto. |
CallMerchant
Messaggio vuoto da utilizzare in supportedPartySizeOption; l'impostazione di questa opzione mostrerà agli utenti un'opzione per chiamare l'attività per una prenotazione.
TicketingVerticalSpecificData
Informazioni aggiuntive specifiche per il verticale della vendita di biglietti per eventi.
Rappresentazione JSON |
---|
{ "eventCategory": enum ( |
Campi | |
---|---|
eventCategory |
La categoria dell'evento. Impostato solo quando l'evento rientra in una delle categorie predefinite. (facoltativo) |
eventUrl |
L'URL dell'evento sul sito web del partner. (facoltativo) |
entity[] |
Un elenco di entità correlate all'evento. (facoltativo) |
eventAttendanceMode |
Obbligatorio. Il tipo di partecipazione all'evento. |
eventVirtualLocationUrl[] |
Campo facoltativo. URL in cui è possibile guardare l'evento. |
eventOrganizer |
Campo facoltativo. L'organizzatore che ospita l'evento. |
eventOrganizerUrl |
Campo facoltativo. URL dell'organizzatore che ospita l'evento. |
eventOrganizerType |
Campo facoltativo. Il tipo di organizzatore. |
eventSourceUrl[] |
Obbligatorio. URL delle pagine in cui sono disponibili le informazioni o le descrizioni degli eventi. |
eventState |
Campo facoltativo. Stato dell'evento. |
EventCategory
Un sottoinsieme di categorie di eventi per cui personalizziamo l'esperienza del prodotto. Nota: non è inteso come un'ontologia universale degli eventi.
Enum | |
---|---|
EVENT_CATEGORY_UNSPECIFIED |
Non specificato. Non utilizzare. |
EVENT_CATEGORY_CONCERT |
Concerti. |
EVENT_CATEGORY_SPORTS |
Eventi sportivi. |
EVENT_CATEGORY_THEATRE |
Eventi di teatro. |
EVENT_CATEGORY_EXHIBITS |
Esposizioni. |
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES |
Workshop e corsi. |
Entità
Rappresenta un'entità correlata all'evento.
Rappresentazione JSON |
---|
{ "id": string, "name": string, "url": string, "entityType": enum ( |
Campi | |
---|---|
id |
Identificatore univoco dell'entità nel database del partner. (facoltativo) |
name |
Nome dell'entità. (obbligatorio) |
url |
URL della pagina web che descrive in modo inequivocabile l'entità. Questa è la pagina web sul sito web del partner per l'entità, se presente; per altri URL pubblici dell'entità, utilizza relevantUrl in pubbliciIdentificationData. (facoltativo) |
entityType |
Il tipo di entità. (facoltativo) |
entityRole |
Il ruolo dell'entità nell'evento. (facoltativo) |
publicIdentificationData |
Riferimenti pubblici dell'entità. (facoltativo) |
EntityType
Il tipo di entità. Nota: non è inteso come 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 a uno spettacolo. Applicabile solo quando la categoria dell'evento è CONCERT o THEATRE. |
ENTITY_TYPE_PLAYER |
L'entità rappresenta la squadra o il giocatore sportivo che ha partecipato all'evento. Applicabile solo quando la categoria dell'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 dell'evento è SPORT. |
ENTITY_TYPE_PLAY |
L'entità rappresenta il tipo di opera teatrale (ad es. musicale, commedia, balletto e così via) eseguita nell'evento. Applicabile solo quando la categoria dell'evento è THEATRE. |
EntityRole
Il ruolo dell'entità nell'evento.
Enum | |
---|---|
ENTITY_ROLE_UNSPECIFIED |
Non specificato. |
ENTITY_ROLE_HEADLINER |
L'entità rappresenta un protagonista o un protagonista dell'evento. |
ENTITY_ROLE_SUPPORTER |
L'entità rappresenta un artista non profit all'evento. |
ENTITY_ROLE_HOME_TEAM |
L'entità rappresenta la squadra di casa durante l'evento (sportivo). |
ENTITY_ROLE_AWAY_TEAM |
L'entità rappresenta la squadra di ricognizione nell'evento (sportivo). |
PublicIdentificationData
Identificatori, pagine web o altre fonti pubbliche che fanno riferimento a un'entità.
Rappresentazione JSON |
---|
{ "relevantUrl": [ string ], "musicbrainzId": string } |
Campi | |
---|---|
relevantUrl[] |
URL pubblico di qualsiasi pagina web dedicata solo all'argomento. Potrebbero essere inclusi siti web ufficiali, discogs, 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) |
musicbrainzId |
L'identificatore Musicbrainz di 36 caratteri dell'artista o di altre entità musicali, se applicabile. Consulta la pagina https://musicbrainz.org/doc/MusicBrainz_Identifier. (facoltativo) |
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. |
OrganizerType
Il tipo di organizzatore.
Enum | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED |
Non specificato. |
PERSON |
Per un organizzatore che è una persona. |
ORGANIZATION |
Per un organizzatore che è un'organizzazione. |
EventState
Stato dell'evento.
Enum | |
---|---|
EVENT_STATE_UNSPECIFIED |
Non specificato. |
SCHEDULED |
L'evento è stato programmato. |
RESCHEDULED |
L'evento viene riprogrammato. |
CANCELLED |
L'evento è stato annullato. |
POSTPONED |
L'evento è stato posticipato. |
IntegrationType
Profondità di integrazione supportata.
Enum | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
Il valore predefinito è END_TO_END. |
INTEGRATION_TYPE_END_TO_END |
Integrazione completa che consente la prenotazione end-to-end tramite Google. |
INTEGRATION_TYPE_INVENTORY_ONLY |
Il server di prenotazione non deve supportare questo servizio. Devono essere inviati solo i dati relativi a commercianti, servizi e, facoltativamente, sulla disponibilità. |
PerOrderFee
Tariffe che devono essere pagate una sola volta per ordine, indipendentemente dal numero di biglietti.
Rappresentazione JSON |
---|
{ "deliveryFee": { object ( |
Campi | |
---|---|
deliveryFee |
Una commissione che può variare in base al metodo di consegna. |
processingFee |
Una commissione per l'elaborazione del metodo di pagamento dell'utente. |
ToursAndActivitiesContent
Campi di contenuti specifici per i tour e le attività. Ogni elemento nel campo ripetuto deve essere indipendente per consentire una visualizzazione separata (ad es. come punto elenco).
Il completamento di ToursAndActivitiesContent è vivamente consigliato per tour e attività, ma non è strettamente necessario. Tutti i campi supportano sia testo normale che testo HTML per la formattazione di base. Tag di formattazione simili a HTML supportati:
Tag a frase:
, , , : sono supportati solo i tre tag sopra menzionati. Puoi utilizzare
per interrompere le righe nei paragrafi e // per evidenziare un testo importante. Eventuali altri tag a frase verranno ignorati.
Tutti gli altri tag e stili personalizzati non sono consentiti e verranno rimossi. Tutti gli URL, gli ancoraggi e i link verranno rimossi e non saranno mai mostrati agli utenti finali.
Note importanti: * non duplicare i dati già forniti in highlights
, exclusion
e in altri campi più specifici della descrizione del servizio. * Evita di utilizzare altri tag ad eccezione di quelli supportati indicati sopra, in quanto i contenuti all'interno dei tag non supportati verranno rimossi e potrebbero causare un'esperienza utente indesiderata.
Rappresentazione JSON |
---|
{ "highlights": [ { object ( |
Campi | |
---|---|
highlights[] |
L'elenco di elementi visibili all'utente. |
inclusions[] |
L'elenco di inclusioni visibili agli utenti. |
exclusions[] |
L'elenco di esclusioni visibile agli utenti. |
mustKnow[] |
L'elenco visibile agli utenti delle note importanti. Utilizzalo per dettagli quali limiti di età o altre condizioni che rendono questo servizio non adatto. |
Località
Informazioni geografiche relative a una località.
Rappresentazione JSON |
---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
Campi | |
---|---|
placeId |
L'ID luogo di un luogo nel database di Google Places e su Google Maps. Per ulteriori informazioni sugli ID luogo, visita la pagina all'indirizzo https://developers.google.com/places/web-service/place-id. Se fornito, Google associa la località a questo luogo. |
name |
Il nome, il telefono, l'URL e i dati geografici del luogo vengono utilizzati per facilitare 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 servizio Service.location senza nome non verrà associato a un'entità aziendale, anche se si trova allo stesso indirizzo. (facoltativo) |
telephone |
Il numero di telefono pubblico della sede, inclusi i prefissi paese e zone, ad esempio +14567891234. (facoltativo) |
url |
L'URL del sito web pubblico della sede. (facoltativo) |
geo |
Le informazioni geografiche della località, compresi latitudine, longitudine e indirizzo. (facoltativo) |
locationType |
È necessario specificare il tipo di località se questa posizione viene fornita per un servizio. |
locationId |
Riferimento univoco della località all'interno del servizio. Questo ID può essere utilizzato per fare riferimento a questa posizione in altri campi del servizio. Ad esempio, nel modulo di accettazione personalizzato è possibile utilizzare un insieme di ID località per specificare le opzioni relative al luogo di ritiro. Se impostato, questo ID deve essere univoco all'interno dello stesso servizio. (facoltativo) |
LocationType
Il tipo di questo luogo.
Enum | |
---|---|
LOCATION_TYPE_UNSPECIFIED |
Tipo di località non specificato. |
VISITED_LOCATION |
La località visitata dal servizio. |
START_LOCATION |
La località in cui inizia questo servizio funge anche da MEETING_LOCATION. |
END_LOCATION |
La località in cui termina il servizio. |
Classificazione
Definisce la valutazione per un'entità.
Rappresentazione JSON |
---|
{ "value": number, "numberOfRatings": string } |
Campi | |
---|---|
value |
Valore di valutazione medio (obbligatorio se numberOfRatings > 0). Il valore deve essere compreso nell'intervallo [1, 5] e può essere omesso se e solo se il valore numberOfRatings è zero. |
numberOfRatings |
Numero di classificazioni utilizzate per calcolare il valore (obbligatorio). |
HomeServiceData
È necessario fornire ulteriori informazioni per il verticale di servizi a domicilio.
Rappresentazione JSON |
---|
{ "categoryType": string, "jobType": string } |
Campi | |
---|---|
categoryType |
La categoria di alto livello a cui appartiene questo servizio a domicilio. Ad es. idraulico, elettricista ecc. |
jobType |
Il tipo di prestazione nella categoria a cui appartiene il servizio a domicilio specificato. Ad esempio, unclog_drain e install_faucet sono i tipi di prestazioni nella categoria idraulico. |
VirtualSession
Informazioni sulla sessione virtuale/online. Ad esempio, lezioni di yoga online, lezioni di cucina virtuali e così via.
Rappresentazione JSON |
---|
{ "sessionInstructions": { object ( |
Campi | |
---|---|
sessionInstructions |
Istruzioni su come impostare questo corso virtuale. Se il partner non include l'URL del video nella prenotazione, questo testo deve indicare quando l'URL del video verrà condiviso con l'utente. Ad es. "L'URL di Zoom verrà inviato 30 minuti prima della lezione". (Consigliato) |
sessionRequirements |
Requisiti per la sessione virtuale specificata. Ad es. tappetino da yoga, utensili da cucina e così via (consigliato) |
virtualPlatformInfo |
Informazioni sulla piattaforma virtuale utilizzata in questa sessione. (Obbligatorio per abilitare i servizi virtuali) |
isSessionPrerecorded |
Obbligatorio. Imposta questo valore su true se la sessione virtuale non è in diretta ed è preregistrata. |
VirtualPlatformInfo
Informazioni sulla piattaforma che verrà utilizzata per questa sessione virtuale.
Rappresentazione JSON |
---|
{ "platform": enum ( |
Campi | |
---|---|
platform |
Piattaforma utilizzata per la sessione virtuale. |
otherPlatformName |
Il nome della piattaforma se la piattaforma è impostata su OTHER. (Obbligatorio se la piattaforma è impostata su OTHER) |
Piattaforma
Enum per indicare la piattaforma virtuale che verrà utilizzata dal commerciante.
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
Non utilizzato. |
FLEXIBLE |
Il commerciante può scegliere in modo flessibile la piattaforma video. |
GOOGLE_HANGOUTS |
Prodotto Google Hangouts. |
GOOGLE_MEET |
Google Meet. |
ZOOM |
Videocomunicazione Zoom. |
SKYPE |
Skype. |
YOUTUBE |
Live streaming su YouTube. |
OTHER |
Deve essere impostato se la piattaforma video utilizzata è diversa da quelle menzionate qui. |
DirectMerchantPayment
Informazioni su come l'utente può pagare direttamente al commerciante anziché pagare in anticipo il servizio tramite RwG.
Rappresentazione JSON |
---|
{
"paymentMethods": [
{
object ( |
Campi | |
---|---|
paymentMethods[] |
Consigliamo agli utenti di pagare solo tramite i metodi di pagamento indicati di seguito. |
Metodi |
|
---|---|
|
Crea un nuovo Service di un commerciante gestito dall'aggregatore specificato e lo restituisce. |
|
Elimina un elemento Service esistente di un commerciante gestito dall'aggregatore specificato. |
|
Aggiorna un elemento Service esistente di un commerciante gestito dall'aggregatore specificato e lo restituisce. |