- Risorsa: servizio
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition
- PrepaymentType
- PrepaymentTerms
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType
- 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, nel formato |
serviceName |
Il nome del servizio, ad esempio "Taglio di capelli da uomo". Deprecato, usa localizedServiceName. |
localizedServiceName |
Il nome del servizio, ad esempio "Taglio di capelli da uomo". Possibilmente in diverse lingue. |
description |
La descrizione del servizio visibile all'utente. Deprecato, usa localizedDescription. |
localizedDescription |
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> Tag paragrafo: <p> Elenca i tag: <ul>, <ol>, <li> Tag Division: <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 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 |
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 per richiedere ulteriori informazioni all'utente quando prenota questo servizio. (facoltativo) |
perTicketIntakeForm |
Un modulo per richiedere ulteriori informazioni all'utente quando prenota questo servizio. Questo modulo deve essere compilato una volta per ogni biglietto che l'utente prenota. (facoltativo) |
taxRate |
L'aliquota fiscale del servizio. Se presente, questo campo sostituisce qualsiasi TaxRate impostata a livello di commerciante. Un messaggio vuoto (ad esempio, TaxRate { }) reimposterà l'aliquota fiscale applicata su zero. |
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 la modalità di addebito di un deposito all'utente. Sostituisce il deposito per il servizio, se specificato. L'impostazione di un messaggio Deposito vuoto comporta la rimozione dell'eventuale deposito a livello di servizio. (facoltativo) |
noShowFee |
Definisce una tariffa per il mancato arrivo che potrebbe essere addebitata all'utente. Sostituisce la tariffa per il mancato arrivo, se specificata. L'impostazione di un messaggio NoShowFee vuoto comporta la rimozione di eventuali commissioni per il mancato arrivo a livello di servizio. (facoltativo) |
requireCreditCard |
Indica se l'utente deve fornire una carta di credito per poter prenotare questo servizio. Questo campo può essere sostituito a livello di disponibilità. (facoltativo) |
actionLink[] |
Un link all'azione relativo a questo servizio. Se esiste un link all'azione, è necessario impostare il tipo (vedi di seguito) nel servizio. |
type |
Il tipo predefinito di questo servizio. (facoltativo) |
ticketType[] |
Tipi di biglietti che possono essere prenotati/acquistati per questo servizio, se i biglietti sono supportati. (facoltativo) |
relatedMedia[] |
Foto relative a questo servizio. Google eseguirà la scansione e l'archiviazione dei contenuti multimediali per garantire che vengano mostrati agli utenti finali nel modo più efficiente. (facoltativo) |
serviceAttributeValueId[] |
(Facoltativo) Valori degli attributi del servizio che si applicano a questo servizio. Ogni Servizio può avere zero o più valori per ogni attributo di servizio definito nel Commerciante corrispondente. (facoltativo) |
waitlistRules |
Regole per iscriversi alla lista d'attesa. |
ticketingVerticalSpecificData |
Informazioni aggiuntive specifiche per il verticale della vendita di biglietti per eventi. (facoltativo) |
integrationType |
Livello di integrazione supportato per questo servizio. (Facoltativo) Non pertinente per i partner con l'integrazione iniziale. L'opzione end-to-end sarà sempre disattivata per questi partner. |
perOrderFee |
Tariffe a livello di ordine per l'acquisto di questo servizio. (facoltativo) |
toursAndActivitiesContent |
Campi dei contenuti specifici di Tour e Attività. |
location[] |
Località correlate a questo servizio. NOTE IMPORTANTI. Se ci sono più località visitate correlate a questo servizio o se la località START_LOCATION è diversa da VISITED_LOCATION, è necessario specificare START_LOCATION. Esempio: un tour guidato in bicicletta che visita tre punti di partenza. È necessario specificare la sede di partenza. - Un tour in autobus presso la hall dell'hotel, per poi dirigersi verso il luogo visitato. È necessario specificare la sede della riunione. |
rating |
Valutazione degli utenti per questo servizio come metrica aggregata in tutte le recensioni. |
homeServiceData |
Informazioni aggiuntive specifiche per il verticale dei servizi a domicilio. (facoltativo) |
virtualSession |
(Facoltativo) Informazioni sulla sessione virtuale. È obbligatorio per abilitare i servizi virtuali. |
directMerchantPayment |
(Facoltativo) Ulteriori informazioni che devono essere aggiunte se il servizio richiede all'utente di pagare direttamente al commerciante. NOTA IMPORTANTE: RwG non è coinvolta in questa transazione. È obbligatorio se è definita virtualSession e il servizio non è senza costi o se prepaymentType NON è impostato su REQUIRED. |
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 |
SchedulingRules
Le regole di pianificazione di 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 commissione per l'annullamento entro il periodo minimo di preavviso. |
noshowFee |
La commissione per il mancato arrivo senza cancellazione. |
admissionPolicy |
Le norme di ammissione che si applicano a questo servizio. Se non viene configurato, il valore predefinito è TIME_STRICT. (facoltativo) |
cancellationPolicy |
Criterio di annullamento delle regole di pianificazione. (obbligatorio per le Cose da fare) |
Campo unione 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:
|
|
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 fino a quando termina lo slot di disponibilità. Se questo campo è impostato, "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 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. |
CancellationPolicy
Norme di 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 per descrivere i passaggi del rimborso come varie durate prima dell'ora di inizio del servizio.
Rappresentazione JSON |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
Campi | |
---|---|
minDurationBeforeStartTime |
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 Durata in secondi con un massimo di nove cifre frazionarie e 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, 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. |
PrepaymentTerms
Informazioni specifiche su quando è stato completato il pagamento anticipato.
Rappresentazione JSON |
---|
{
"chargeTiming": enum ( |
Campi | |
---|---|
chargeTiming |
Quando viene eseguito l'addebito in base al momento dell'acquisto. |
chargeTimeBeforeStartTimeSec |
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. |
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 impostato su true, questo modulo verrà mostrato ai nuovi clienti. Deprecato. Questa funzionalità non è supportata per i moduli di accettazione. |
returningCustomers |
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.
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 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 |
Il tipo di questo campo. |
label |
Il testo mostrato all'utente per questo campo. Deprecato, usa |
localizedLabel |
Il testo mostrato all'utente per questo campo. Il campo può essere specificato in più impostazioni internazionali. (obbligatorio) |
value[] |
Impostalo solo se il tipo di campo è LOCATION_SEARCH. Utilizza "locationId" nella "località" per specificare il valore della località. |
choiceText[] |
Impostalo solo se il tipo di campo è MULTIPLE_CHOICE, CHECKBOXES o DROPDOWN. Utilizzato per enumerare le scelte possibili. |
isRequired |
Indica se un utente richiede una risposta a questo campo. |
allowCustomAnswer |
Indica se è consentito un valore personalizzato in aggiunta alle risposte predefinite. Ciò è applicabile solo quando il tipo di campo è LOCATION_SEARCH. (facoltativo) |
additionalOption[] |
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) |
ticketTypeRestrict[] |
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 |
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. |
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. |
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.
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 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, utilizza invece localizedShortDescription. |
localizedShortDescription |
Una breve descrizione di questo TicketType con supporto i18n. Può essere visibile all'utente, ad esempio "adult", "bambino", "veteran", "Row J" e così via. Obbligatorio, ogni tipo di biglietto deve avere una descrizione per essere visibile all'utente. È possibile fornire valori separati per ogni lingua. |
price |
Il prezzo di un biglietto singolo di questo tipo, al netto di eventuali imposte. Ai biglietti del Servizio si applica l'aliquota fiscale del servizio. |
perTicketFee |
Costi aggiuntivi per l'acquisto di questo biglietto. (facoltativo) |
optionDescription |
Descrizione di qualsiasi opzione aggiuntiva rappresentata da questo tipo di ticket, se presente. Deprecato, usa localizedOptionDescription. |
localizedOptionDescription |
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: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } Esempio 2: noleggio di kayak per più ore con l'aggiunta opzionale di una borsa asciutta; la descrizione breve potrebbe essere "3 ore" e l'opzioneDescription potrebbe essere "con sacchetto asciutto" o "senza sacchetto asciutto": - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "spanish" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "english" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "spanish" } 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 optionsDescription 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 |
PerTicketFee
Commissioni che devono essere pagate per ogni biglietto acquistato dall'utente.
Rappresentazione JSON |
---|
{ "serviceCharge": { object ( |
Campi | |
---|---|
serviceCharge |
È previsto un costo aggiuntivo per un servizio. |
facilityFee |
Una commissione da versare alla sede/strutture. |
taxes |
Tasse per biglietto. |
RelatedMedia
Foto relative a questo servizio. Google eseguirà la scansione di questi contenuti multimediali per assicurarsi che vengano visualizzati correttamente agli 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. Verranno rimossi tutti i componenti HTML. (facoltativo) |
attribution |
Informazioni sull'attribuzione sulla fonte dei contenuti multimediali. Tieni presente che, se l'attribuzione deve essere visualizzata insieme ai media per citare il fotografo o l'agenzia, è necessario impostare questo campo. (facoltativo) |
caption |
Deprecato, preferisci usare localizedCaption. |
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. |
Attribuzione
Informazioni sull'attribuzione per questi contenuti multimediali.
Rappresentazione JSON |
---|
{
"localizedText": {
object ( |
Campi | |
---|---|
localizedText |
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 |
Deprecato, preferisci usare 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 come definito in Merchant.service_attribute, ad esempio "service-type". |
valueId |
ID del valore di questo attributo, ad es. "taglio di capelli". Deve corrispondere a un 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 offre la funzionalità della lista d'attesa, questa informazione non deve essere compilata. |
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 offre la funzionalità della lista d'attesa, questa informazione non deve essere compilata. |
supportsAdditionalRequest |
Se impostato su 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 le opzioni per gruppi maggiori di maxPartySize. Lascia vuoto se non è necessario fornire opzioni alternative per l'iscrizione a una lista d'attesa per parti più numerose. |
UnsupportedPartySizeOption
Opzioni per le parti fuori dal raggio d'azione.
Rappresentazione JSON |
---|
{
"callMerchant": {
object ( |
Campi | |
---|---|
callMerchant |
Le dimensioni del gruppo che non rientrano nell'intervallo possono chiamare l'attività. All'utente verrà mostrato un messaggio predefinito. Testo di esempio da visualizzare: "Per i partecipanti di dimensioni superiori a {waitlistRules.max_party_size}, chiama il ristorante al numero {phone}". CallMerchant deve essere impostato, ma il campo 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[] |
(Facoltativo) URL in cui è possibile guardare l'evento. |
eventOrganizer |
(Facoltativo) Organizzatore che ospita l'evento. |
eventOrganizerUrl |
(Facoltativo) URL dell'organizzatore che ospita l'evento. |
eventOrganizerType |
(Facoltativo) Il tipo di organizzatore. |
eventSourceUrl[] |
Obbligatorio. URL delle pagine in cui sono disponibili le informazioni o le descrizioni degli eventi. |
eventState |
(Facoltativo) Stato dell'evento. |
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. |
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 relativa all'entità, se presente; per altri URL pubblici dell'entità, usa relevantUrl in publicIdentificationData. (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: 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. |
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). |
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 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) |
musicbrainzId |
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) |
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 l'organizzatore che è una persona. |
ORGANIZATION |
Per gli organizzatori che fanno parte di un'organizzazione. |
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. |
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à. |
PerOrderFee
Commissioni che devono essere pagate una volta per ogni ordine, indipendentemente dal numero di biglietti.
Rappresentazione JSON |
---|
{ "deliveryFee": { object ( |
Campi | |
---|---|
deliveryFee |
Una tariffa che può variare in base al metodo di consegna. |
processingFee |
Una commissione per l'elaborazione del metodo di pagamento dell'utente. |
ToursAndActivitiesContent
Campi dei contenuti specifici di Tour e Attività. Ogni elemento nel campo ripetuto deve essere indipendente per consentire una visualizzazione separata (ad es. sotto forma di elenco puntato).
L'inserimento di ToursAndActivitiesContent è fortemente consigliato per i tour e le attività, ma non è strettamente obbligatorio. Tutti i campi supportano sia testo normale che testo simile all'HTML per la formattazione di base. Tag di formattazione simili a HTML supportati:
Tag a frase:
, , , : sono supportati solo i tre tag menzionati in precedenza.
può essere utilizzato per spezzare le righe dei 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 menzionati sopra, perché i contenuti all'interno di tag non supportati verranno rimossi e potrebbero causare un'esperienza utente indesiderata.
Rappresentazione JSON |
---|
{ "highlights": [ { object ( |
Campi | |
---|---|
highlights[] |
L'elenco di elementi in evidenza visibile all'utente. |
inclusions[] |
L'elenco di inclusioni visibile all'utente. |
exclusions[] |
L'elenco di esclusioni visibile all'utente. |
mustKnow[] |
L'elenco di note importanti visibile all'utente; utilizzalo per dettagli come i limiti di età o altre condizioni che rendono questo servizio non adatto. |
Località
Informazioni geografiche su 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 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 |
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 |
Il numero di telefono pubblico della sede, inclusi i prefissi e il paese, ad esempio +14567891234. (facoltativo) |
url |
L'URL del sito web pubblico della sede. (facoltativo) |
geo |
Le informazioni geografiche della posizione, inclusi latitudine, longitudine e indirizzo. (facoltativo) |
locationType |
Il tipo di località, deve essere specificato se questa località viene fornita per un servizio. |
locationId |
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. |
Classificazione
Definisce la classificazione per un'entità.
Rappresentazione JSON |
---|
{ "value": number, "numberOfRatings": string } |
Campi | |
---|---|
value |
Valore della valutazione media (obbligatorio quando 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 valutazioni utilizzate per il calcolo del valore (obbligatorio). |
HomeServiceData
È necessario fornire ulteriori informazioni per il verticale dei 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 es. unclog_drain e install_faucet sono i tipi di prestazione nella categoria idraulici. |
VirtualSession
Informazioni sulla sessione virtuale/online. Ad es. Corso di yoga online, lezione di cucina virtuale ecc.
Rappresentazione JSON |
---|
{ "sessionInstructions": { object ( |
Campi | |
---|---|
sessionInstructions |
Istruzioni su come è configurato questo corso virtuale. Se il partner non include l'URL del video nella prenotazione, questo testo dovrà indicare il momento in cui l'URL del video verrà condiviso con l'utente. Ad es. "L'URL Zoom verrà inviato per posta 30 minuti prima della lezione". (Consigliato) |
sessionRequirements |
Requisiti per la sessione virtuale specificata. Ad es. tappetino per lo yoga, utensili da cucina e così via (consigliato) |
virtualPlatformInfo |
Informazioni sulla piattaforma virtuale utilizzata in questa sessione. (necessario 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 è impostata su ALTRO. (Obbligatorio se la piattaforma è impostata su ALTRO) |
Piattaforma
Enum per indicare la piattaforma virtuale che verrà utilizzata dal commerciante.
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
Non utilizzato. |
FLEXIBLE |
Il commerciante ha un approccio flessibile alla piattaforma video che usa. |
GOOGLE_HANGOUTS |
prodotto Google Hangouts. |
GOOGLE_MEET |
Prodotto Google Meet. |
ZOOM |
Comunicazioni video 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 anticipato per il servizio tramite RwG.
Rappresentazione JSON |
---|
{
"paymentMethods": [
{
object ( |
Campi | |
---|---|
paymentMethods[] |
Agli utenti viene consigliato 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 Service esistente di un commerciante gestito dall'aggregatore specificato. |
|
Aggiorna un valore Service esistente di un commerciante gestito dall'aggregatore specificato e lo restituisce. |