REST Resource: inventory.partners.merchants.services

Risorsa: Service

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

Rappresentazione JSON 
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  },
  "uriTemplate": {
    object (UriTemplate)
  }
}
Campi
name

string

Il nome della risorsa di servizio, nel formato partners/{partner_id}/merchants/{merchantId}/services/{serviceId}.
serviceName

string

Il nome del servizio, ad esempio "Taglio di capelli uomo". Deprecato, utilizza localizedServiceName.
localizedServiceName

object (Text)

Il nome del servizio, ad esempio "Taglio di capelli uomo". Possibilmente in più impostazioni internazionali.
description

string

La descrizione del servizio visibile all'utente. Deprecato, utilizza localizedDescription.
localizedDescription

object (Text)

La descrizione del servizio visibile all'utente.

Questo campo supporta sia la formattazione in testo normale sia quella simile a HTML. A differenza delle sezioni di testo normale, qui è possibile creare layout personalizzati utilizzando intestazioni, paragrafi, elenchi e alcuni tag di frasi. Leggi attentamente le seguenti istruzioni e note per assicurarti di creare la migliore esperienza utente.

Tag di formattazione simili a HTML supportati:

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

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

Tag elenco: <ul>, <ol>, <li>
Il tag <ul> può essere utilizzato con il tag <li> per visualizzare elenchi non ordinati, mentre il tag <ol> può essere utilizzato con <li> per visualizzare elenchi ordinati. È un buon modo per visualizzare elenchi di controllo, orari o qualsiasi altro elenco adatto ai tuoi casi d'uso.
Esempio: per mostrare un elenco di funzionalità di una crociera:
<ol>
<li>Meravigliosa vista sull'oceano e possibilità di giocare con la fauna selvatica.</li>
<li>Servizi e organizzazione del viaggio progettati con cura.</li>
<li>Prezzo più basso garantito.</li>
</ol>
Tieni presente che verranno convertiti solo i tag <li> bambini sotto <ul> o <ol>. Tutti gli altri elementi secondari verranno eliminati. Inoltre, tutti i tag, gli attributi e gli stili interni verranno ignorati; conserviamo solo i contenuti di testo puro.

Tag di divisione: <div>
Tutti i tag interni supportati del tag <div> verranno analizzati in base alle regole indicate sopra, il che implica che il tag <div> stesso non comporta alcun raggruppamento o rientro. Inoltre, tutti gli stili e gli attributi interni verranno ignorati.

Tag di frasi: <br>, <strong>, <em>:
Sono supportati solo i tre tag menzionati sopra. <br> può essere utilizzato per interrompere le righe nei paragrafi, mentre <strong>/<em> può essere utilizzato per evidenziare il testo importante. Tutti gli altri tag di frasi verranno ignorati.

Tag non supportati:

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

Note importanti:

  • Cerca di non utilizzare altri tag, ad eccezione di quelli supportati menzionati sopra, perché i contenuti all'interno dei tag non supportati verranno rimossi e potrebbero comportare un'esperienza utente indesiderata.
  • Cerca di evitare strutture nidificate complesse, ad esempio più di tre diversi livelli di intestazione o elenchi nidificati. Mantenere la struttura piatta, semplice e diretta contribuisce a creare una migliore esperienza utente.
  • 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

object (Price)

Il prezzo del servizio.
priceInterpretation

enum (PriceInterpretation)

Descrive come il prezzo viene interpretato e visualizzato dall'utente. Può essere utilizzato da qualsiasi verticale, ad eccezione di Ristoranti e Cose da fare, per configurare la visualizzazione del prezzo del servizio.
rules

object (SchedulingRules)

Regole per prenotare/annullare un appuntamento.
prepaymentType

enum (PrepaymentType)

Se è richiesto, facoltativo o non supportato un pagamento anticipato.
prepaymentTerms

object (PrepaymentTerms)

Termini relativi al completamento del pagamento anticipato.
form[]
(deprecated)

object (ServiceIntakeForm)

Deprecato. Utilizza intakeForm e perTicketIntakeForm.
intakeForm

object (ServiceIntakeForm)

Un modulo che richiede all'utente informazioni aggiuntive al momento della prenotazione del servizio. (facoltativo)
perTicketIntakeForm

object (ServiceIntakeForm)

Un modulo che richiede all'utente informazioni aggiuntive al momento della prenotazione del servizio. Questo modulo deve essere compilato una volta per ogni biglietto prenotato dall'utente. (facoltativo)
taxRate

object (TaxRate)

L'aliquota fiscale del servizio. Se presente, questo campo sostituisce qualsiasi taxRate impostato a livello di commerciante. Un messaggio vuoto (ad es. taxRate { }) reimposterà l'aliquota fiscale applicata su zero.
paymentOptionId[]

string

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

object (Deposit)

Definisce le modalità di addebito di un deposito all'utente. Esegue l'override del deposito del servizio, se specificato. Se imposti questo valore su un messaggio di deposito vuoto, viene rimosso qualsiasi deposito a livello di servizio. (facoltativo)
noShowFee

object (NoShowFee)

Definisce una tariffa per mancata presentazione che potrebbe essere addebitata all'utente. Esegue l'override della commissione per mancata presentazione al servizio, se specificata. Se imposti questo valore su un messaggio NoShowFee vuoto, viene rimossa qualsiasi tariffa per mancata presentazione a livello di servizio. (facoltativo)
requireCreditCard

enum (RequireCreditCard)

Indica se l'utente deve fornire una carta di credito per prenotare questo servizio. È possibile eseguire l'override di questo campo a livello di disponibilità. (facoltativo)
type

enum (ServiceType)

Il tipo predefinito di questo servizio. (facoltativo)
ticketType[]

object (TicketType)

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

object (RelatedMedia)

Foto correlate a questo servizio. Google eseguirà la scansione e memorizzerà i contenuti multimediali per assicurarsi che vengano visualizzati dagli utenti finali nel modo più efficiente. (facoltativo)
serviceAttributeValueId[]

object (ServiceAttributeValueId)

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

object (WaitlistRules)

Regole per l'iscrizione alla lista d'attesa.
ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

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

enum (IntegrationType)

Livello di integrazione supportato per questo servizio. (facoltativo) Irrilevante per i partner con l'integrazione iniziale. La crittografia end-to-end sarà sempre disattivata per questi partner.
perOrderFee

object (PerOrderFee)

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

object (ToursAndActivitiesContent)

Campi dei contenuti specifici per tour e attività.
location[]

object (Location)

Località correlate a questo servizio. NOTE IMPORTANTI: se sono presenti più località visitate correlate a questo servizio o se START_LOCATION è diverso da VISITED_LOCATION, è necessario specificare START_LOCATION. Esempio: - Un tour guidato in bicicletta che visita tre sedi, la sede di partenza deve essere specificata. Un tour in autobus con ritrovo nella hall di un hotel e poi partenza per la sede visitata. È necessario specificare il luogo della riunione.
rating

object (Rating)

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

object (HomeServiceData)

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

object (VirtualSession)

Facoltativo. Informazioni sulla sessione virtuale. È necessario per attivare i servizi virtuali.
directMerchantPayment

object (DirectMerchantPayment)

Facoltativo. Informazioni aggiuntive da aggiungere se il servizio richiede all'utente di pagare direttamente al commerciante. NOTA IMPORTANTE: RwG non sarà coinvolta in questa transazione. È obbligatorio se virtualSession è definito e il servizio non è senza costi o se prepaymentType NON è impostato su REQUIRED.
uriTemplate

object (UriTemplate)

Facoltativo. Un modello facoltativo che specifica come Google deve generare gli URL per il sito esterno.

PriceInterpretation

Descrive come un prezzo deve essere interpretato e visualizzato dall'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 possono fare scelte che aumentano il prezzo.

Tieni presente che qualsiasi servizio che utilizza questa PriceInterpretation deve utilizzare PrepaymentType NOT_SUPPORTED.

Esempi: 30 $ per la toelettatura del cane, ma le scelte aggiuntive del consumatore potrebbero aumentare il prezzo
NOT_DISPLAYED

Quando il prezzo di un servizio è variabile e non vengono visualizzate in anticipo informazioni sui prezzi per i consumatori.

Tieni presente che qualsiasi servizio che utilizza questo PriceInterpretation deve utilizzare PrepaymentType NOT_SUPPORTED e 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 (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
Campi
minAdvanceOnlineCanceling

string (int64 format)

Il preavviso minimo in secondi richiesto per annullare un appuntamento prenotato online. (facoltativo)
lateCancellationFee
(deprecated)

object (Price)

La commissione per l'annullamento entro il periodo di preavviso minimo.
noshowFee
(deprecated)

object (Price)

Tariffa per mancato arrivo senza annullamento.
admissionPolicy

enum (AdmissionPolicy)

La policy di ammissione che si applica a questo servizio. Se non viene impostato, il valore predefinito è TIME_STRICT. (facoltativo)
cancellationPolicy

object (CancellationPolicy)

Norme di annullamento delle regole di pianificazione. (obbligatorio per le cose da fare)

Campo unione min_booking_buffer. La durata (in secondi) da quando è possibile effettuare l'ultima prenotazione a quando inizia o termina lo slot di disponibilità.

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'ultimo orario prenotabile viene calcolato 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 non sono impostati, lo slot è prenotabile fino all'ora di inizio dello slot. Se entrambi i campi sono impostati, verrà scelto un solo valore e l'altro verrà ignorato. Non è possibile prevedere con certezza quale valore verrà scelto.

Esempi:

  • Un taglio di capelli che deve essere prenotato almeno un'ora prima dell'orario di inizio. 'scheduling_rules{ min_advance_booking: 3600 ...}`

  • Un museo in cui l'ultimo biglietto può essere acquistato 30 minuti prima della chiusura: "scheduling_rules{ min_booking_buffer_before_end_time: 1800 ...}"

  • Un biglietto del cinema che deve essere acquistato prima dell'inizio dello spettacolo. 'scheduling_rules{ ...}' (lascia vuoto questo campo) (facoltativo) min_booking_buffer può essere solo uno dei seguenti tipi:
minAdvanceBooking

string (int64 format)

La durata (in secondi) da quando è possibile effettuare l'ultima prenotazione a quando inizia lo slot di disponibilità.
minBookingBufferBeforeEndTime

string (int64 format)

La durata (in secondi) dall'ultima prenotazione che può essere effettuata alla fine dello 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

La policy di ammissione di questo servizio.

Enum
ADMISSION_POLICY_UNSPECIFIED Non utilizzata.
TIME_STRICT I clienti devono essere presenti all'ora di inizio della fascia di disponibilità e il servizio dovrebbe terminare all'ora di fine della fascia. Esempi di casi d'uso di TIME_STRICT: * Un tour che inizia alle 9:00 e richiede a tutti i partecipanti di arrivare all'ora di inizio e di tornare intorno alle 12:00. * Una prenotazione per un taglio di capelli alle 15:00 di sabato che durerà circa 30 minuti. Una lezione di fitness dalle 18:00 alle 20:00.
TIME_FLEXIBLE

I clienti possono arrivare in qualsiasi momento tra l'inizio e la fine della fascia di disponibilità per utilizzare questa prenotazione.

Esempi di casi d'uso di TIME_FLEXIBLE: * Un biglietto del museo che può essere utilizzato in qualsiasi momento della 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 presso il commerciante all'ora di inizio della fascia di disponibilità, ma possono andare via quando vogliono.

Ad esempio, nello scenario di ingresso al museo, un biglietto di ingresso a orario 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 lo slot di disponibilità per la prenotazione.

CancellationPolicy

Norme di annullamento per un servizio.

Rappresentazione JSON 
{
  "refundCondition": [
    {
      object (RefundCondition)
    }
  ]
}
Campi
refundCondition[]

object (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 di rimborso" come varie durate prima dell'ora di inizio del servizio.

Rappresentazione JSON 
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
Campi
minDurationBeforeStartTime

string (Duration format)

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

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
refundPercent

integer (uint32 format)

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

PrepaymentType

Enumerazione per indicare il tipo di pagamento anticipato.

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

PrepaymentTerms

Informazioni specifiche sul completamento del pagamento anticipato.

Rappresentazione JSON 
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
Campi
chargeTiming

enum (ChargeTiming)

Quando verrà effettuato l'addebito rispetto al momento dell'acquisto.
chargeTimeBeforeStartTimeSec

string (int64 format)

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

ChargeTiming

Enumerazione per specificare quando verrà effettuato l'addebito rispetto al momento dell'acquisto.

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

ServiceIntakeForm

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

Rappresentazione JSON 
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
Campi
field[]

object (ServiceIntakeFormField)

I campi che verranno mostrati all'utente.
firstTimeCustomers
(deprecated)

boolean

Se è vero, questo modulo verrà mostrato ai clienti che acquistano per la prima volta. Deprecato. Questa funzionalità non è supportata per i moduli di acquisizione.
returningCustomers
(deprecated)

boolean

Se vero, questo modulo verrà mostrato ai clienti abituali. Deprecato. Questa funzionalità non è supportata per i moduli di acquisizione.

ServiceIntakeFormField

Definisce un campo incluso in un ServiceIntakeForm.

Rappresentazione JSON 
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
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 modulo corrispondente e deve essere univoco sia a livello di servizio sia per i moduli di acquisizione dei ticket. (obbligatorio)
type

enum (FieldType)

Il tipo di questo campo.
label

string

Il testo mostrato all'utente per questo campo. Deprecato, utilizza invece localizedLabel.
localizedLabel

object (Text)

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

string

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

object (Text)

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

boolean

Indica se un utente deve rispondere a questo campo.
allowCustomAnswer

boolean

Indica se è consentito un valore personalizzato oltre alle risposte predefinite. Questo è applicabile solo quando il tipo di campo è LOCATION_SEARCH. (facoltativo)
additionalOption[]

object (Text)

Opzioni aggiuntive fornite in aggiunta ai valori forniti. Applicabile solo quando il tipo di campo è LOCATION_SEARCH. Ad esempio, oltre all'elenco delle località fornite, un'altra opzione disponibile può essere "Contatterò il fornitore in un secondo momento". (facoltativo)
ticketTypeRestrict[]

string

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

object (Text)

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

FieldType

Enumerazione 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 multilinea per il testo.
MULTIPLE_CHOICE Un insieme di pulsanti di opzione che richiede una scelta tra molte opzioni.
CHECKBOXES Uno o più elementi numerati con caselle di controllo.
DROPDOWN Una selezione da un menu a discesa.
BOOLEAN Un pulsante Sì/No.

ServiceType

Tipi di servizi predefiniti.

Enum
SERVICE_TYPE_UNSPECIFIED Non utilizzata.
SERVICE_TYPE_DINING_RESERVATION Prenotazione per ristorante.
SERVICE_TYPE_FOOD_ORDERING Ordinazione di cibo, che può essere con consegna a domicilio, da 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. Consigliato per (1) servizi di salute e fitness, (2) servizi di spa e bellezza e (3) servizi di consulenza e valutazione finanziaria. Consulta i tipi di servizio supportati: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_ONLINE_APPOINTMENT Servizio che fornisce appuntamenti online per un corso o una sessione che sarà completamente virtuale. Deve essere impostato se si abilitano le prenotazioni di servizi virtuali.
SERVICE_TYPE_SHOPPING Servizio che consente agli utenti di fare acquisti dal commerciante specificato. Può essere una consegna o un ritiro.

TicketType

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

Un biglietto è l'unità prenotabile minima per un servizio, ad esempio un posto in un'escursione di rafting, un ingresso a un museo, il noleggio di un kayak doppio per un giorno intero.

Rappresentazione JSON 
{
  "ticketTypeId": string,
  "shortDescription": string,
  "localizedShortDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "priceDisplayType": enum (PriceDisplayType),
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  },
  "inventoryType": enum (InventoryType)
}
Campi
ticketTypeId

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

string

Una breve descrizione di questo tipo di biglietto.

Può essere visibile all'utente, ad esempio "adulto", "bambino", "veterano", "fila J" e così via. Obbligatorio, ogni tipo di biglietto deve avere una descrizione visibile all'utente. Deprecato, utilizza localizedShortDescription.
localizedShortDescription

object (Text)

Una breve descrizione di questo TicketType con supporto i18n.

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

object (Price)

Il prezzo di un singolo biglietto di questo tipo, tasse escluse. L'aliquota fiscale del servizio viene applicata ai relativi biglietti.
perTicketFee

object (PerTicketFee)

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

enum (PriceDisplayType)

Facoltativo. Tipo di visualizzazione del prezzo predeterminato di un singolo biglietto di questo tipo.
optionDescription

string

Descrizione di eventuali opzioni aggiuntive rappresentate da questo tipo di biglietto. Deprecato, utilizza localizedOptionDescription.
localizedOptionDescription

object (Text)

Descrizione di eventuali opzioni aggiuntive rappresentate da questo tipo di biglietto. È possibile fornire valori separati per ogni impostazione locale.

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

Esempio 1: un biglietto d'ingresso con diversi tipi "adulto", "bambino" e la lingua come opzione aggiuntiva. L'elenco TicketType previsto sarebbe: - { ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adulto" } localizedOptionDescription { value: "inglese" } } - { ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adulto" } localizedOptionDescription { value: "spagnolo" } } - { ticketTypeId: "ticket_type_3" localizedShortDescription { value: "bambino" } localizedOptionDescription { value: "inglese" } } - { ticketTypeId: "ticket_type_4" localizedShortDescription { value: "bambino" } localizedOptionDescription { value: "spagnolo" } }

Esempio 2: un noleggio di kayak di più ore con l'opzione aggiuntiva di una borsa impermeabile. La descrizione breve potrebbe essere "3 ore" e la descrizione dell'opzione potrebbe essere "con borsa impermeabile" o "senza borsa impermeabile": - { 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 un tipo di biglietto all'interno del servizio, ci aspettiamo che lo sia anche per tutti gli altri tipi di biglietto (è possibile utilizzare una optionDescription predefinita). Ad esempio, [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] non è un elenco valido.

Sono supportati solo due tag di formattazione HTML: e
. Sono pensate per specificare opzioni con un titolo e una descrizione dettagliata, ad esempio: "Posti premium
Questa opzione offre posti nei palchi privati, tra cui sedili completamente imbottiti, TV private e servizio di ristorazione al posto. Questi posti offrono una vista pittoresca del campo."
inventoryType

enum (InventoryType)

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

PerTicketFee

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

Rappresentazione JSON 
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
Campi
serviceCharge

object (Price)

Un addebito aggiuntivo valutato per un servizio.
facilityFee

object (Price)

Una commissione che viene versata alla sede/struttura.
taxes

object (Price)

Tasse per biglietto.

PriceDisplayType

Indica il formato del prezzo visualizzato sulla pagina di destinazione.

Questo campo viene ignorato per l'inventario non link-out.

Questo campo consente alle piattaforme Google di mostrare lo stesso formato di prezzo utilizzato dalla pagina di destinazione del servizio. I formati di prezzo coerenti migliorano il tasso di conversione e riducono la confusione.

Enum
PRICE_DISPLAY_TYPE_UNSPECIFIED Il tipo di display del prezzo non è specificato. Google determinerà quale formato mostrare.
PRICE_DISPLAY_TYPE_BASE Il prezzo mostrato sulla pagina di destinazione è il prezzo base.
PRICE_DISPLAY_TYPE_ALL_IN Il prezzo mostrato nella pagina di destinazione include tutte le commissioni e le tasse.

InventoryType

Tipo di inventario predeterminato di un singolo biglietto di questo tipo.

Enum
INVENTORY_TYPE_UNSPECIFIED Il tipo di inventario non è specificato.
INVENTORY_TYPE_PRIMARY Inventario principale.
INVENTORY_TYPE_VERIFIED_RESALE Inventario di rivendita verificato.
INVENTORY_TYPE_RESALE Inventario per la rivendita.
INVENTORY_TYPE_AGGREGATOR Inventario dell'aggregatore. Aggregatore (ad es. www.bandsintown.com) indica che il partner fornisce informazioni su eventi e biglietti. ma i biglietti non vengono venduti direttamente dal partner. Il venditore effettivo dei biglietti può essere primario, di rivendita verificata o di rivendita. Ora distinguiamo solo il tipo di inventario del partner di primo livello e ignoriamo il tipo di inventario effettivo del venditore di biglietti all'interno di un aggregatore.

RelatedMedia

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

Rappresentazione JSON 
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
Campi
url

string

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

enum (MediaType)

Il tipo di questa fonte multimediale.
localizedCaption

object (Text)

Sottotitolo del media che supporta l'internazionalizzazione, è supportato solo il testo normale. Tutti i componenti HTML verranno rimossi. (facoltativo)
attribution

object (Attribution)

Informazioni sull'attribuzione relative alla fonte dei contenuti multimediali. Tieni presente che se l'attribuzione è necessaria per la visualizzazione con i contenuti multimediali per dare credito al fotografo o all'agenzia, questo campo deve essere impostato. (facoltativo)
caption
(deprecated)

string

Deprecato, preferisci utilizzare localizedCaption.

MediaType

Enumerazione per indicare il tipo di questa origine media. 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 utilizzata.
PHOTO Indica che i contenuti multimediali forniti dall'URL sono una foto.

Attribuzione

Informazioni sull'attribuzione per questo contenuto multimediale.

Rappresentazione JSON 
{
  "localizedText": {
    object (Text)
  },
  "text": string
}
Campi
localizedText

object (Text)

Il testo per attribuire il merito al fotografo o all'agenzia che supporta l'internazionalizzazione. Questo testo verrà visualizzato insieme ai contenuti multimediali di origine. Tieni presente che per questo campo è supportato solo il testo normale e tutti i componenti HTML verranno rimossi (l'attribuzione basata su link ipertestuale non è supportata).
text
(deprecated)

string

Deprecato, preferisci utilizzare localizedText.

ServiceAttributeValueId

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

Rappresentazione JSON 
{
  "attributeId": string,
  "valueId": string
}
Campi
attributeId

string

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

string

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

WaitlistRules

Regole relative all'iscrizione alla lista d'attesa.

Rappresentazione JSON 
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
Campi
minPartySize

integer

Obbligatorio. Deve essere un numero intero positivo per i servizi che forniscono la funzionalità di lista d'attesa. Se il servizio o il commerciante non fornisce la funzionalità di lista d'attesa, questo campo non deve essere compilato.
maxPartySize

integer

Obbligatorio. Deve essere un numero intero positivo per i servizi che forniscono la funzionalità di lista d'attesa. Se il servizio o il commerciante non fornisce la funzionalità di lista d'attesa, questo campo non deve essere compilato.
supportsAdditionalRequest

boolean

Se è true, l'utente potrà inviare una richiesta di testo aggiuntiva in formato libero quando si unisce alla lista di attesa per questo servizio.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

Imposta le opzioni per le feste più grandi del valore maxPartySize impostato. Lascia vuoto se ai gruppi più grandi non devono essere offerte opzioni alternative per l'iscrizione a una lista d'attesa.

UnsupportedPartySizeOption

Opzioni per le parti che non rientrano nell'intervallo.

Rappresentazione JSON 
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
Campi
Campo unione kind. Opzioni disponibili per le parti fuori dal raggio d'azione. kind può essere solo uno dei seguenti tipi:
callMerchant

object (CallMerchant)

I gruppi di persone che non rientrano nell'intervallo possono chiamare l'attività. All'utente verrà mostrato un messaggio predefinito. Testo di esempio da visualizzare: "Per gruppi di più di {waitlistRules.max_party_size} persone, chiama il ristorante al numero {phone}." CallMerchant deve essere impostato, ma sarà vuoto.

CallMerchant

Questo tipo non contiene campi.

Messaggio vuoto da utilizzare in UnsupportedPartySizeOption. Se lo imposti, gli utenti visualizzeranno un'opzione per chiamare l'attività per effettuare una prenotazione.

TicketingVerticalSpecificData

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

Rappresentazione JSON 
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState),
  "brandName": {
    object (Text)
  },
  "eventCreator": {
    object (EventCreator)
  }
}
Campi
eventCategory

enum (EventCategory)

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

string

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

object (Entity)

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

enum (AttendanceMode)

Obbligatorio. Il tipo di partecipazione all'evento.
eventVirtualLocationUrl[]

string

Facoltativo. L'URL in cui è possibile guardare l'evento.
eventOrganizer

object (Text)

Facoltativo. L'organizzatore che ospita l'evento.
eventOrganizerUrl

string

Facoltativo. L'URL dell'organizzatore che ospita l'evento.
eventOrganizerType

enum (OrganizerType)

Facoltativo. Il tipo di organizzatore.
eventSourceUrl[]

string

Obbligatorio. URL delle pagine in cui è possibile trovare le informazioni o le descrizioni dell'evento.
eventState

enum (EventState)

Facoltativo. Stato dell'evento.
brandName

object (Text)

Facoltativo. Il nome del brand localizzato.
eventCreator

object (EventCreator)

Facoltativo. Informazioni sul creatore dell'evento.

EventCategory

Un sottoinsieme di categorie di eventi per le quali personalizziamo l'esperienza con il prodotto. Nota: non è pensata per essere 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 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 (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
Campi
id

string

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

string

Nome dell'entità. (obbligatorio)
url

string

L'URL della pagina web che descrive in modo univoco 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 publicIdentificationData. (facoltativo)
entityType

enum (EntityType)

Il tipo di entità. (facoltativo)
entityRole

enum (EntityRole)

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

object (PublicIdentificationData)

Riferimenti pubblici dell'entità. (facoltativo)

EntityType

Il tipo di entità. Nota: non è pensata per 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 in un concerto o in uno spettacolo. Applicabile solo quando la categoria dell'evento è CONCERTO o TEATRO.
ENTITY_TYPE_PLAYER L'entità rappresenta la squadra sportiva o il giocatore 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 è CONCERTO.
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 spettacolo (ad es. musicale, commedia, balletto e così via) eseguito all'evento. Applicabile solo quando la categoria dell'evento è TEATRO.

EntityRole

Il ruolo dell'entità nell'evento.

Enum
ENTITY_ROLE_UNSPECIFIED Non specificato.
ENTITY_ROLE_HEADLINER L'entità rappresenta un artista principale o un artista di spicco 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 in trasferta 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[]

string

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

string

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 in presenza.
PHYSICAL_ONLINE_MIXED Per eventi sia fisici che virtuali.

OrganizerType

Il tipo di organizzatore.

Enum
ORGANIZER_TYPE_UNSPECIFIED Non specificato.
PERSON Per l'organizzatore che è una persona.
ORGANIZATION Per l'organizzatore che è un'organizzazione.

EventState

Stato dell'evento.

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

EventCreator

Informazioni sul creatore dell'evento. Rilevante solo per le piattaforme che includono eventi relativi ai contenuti generati dagli utenti.

Rappresentazione JSON 
{
  "name": string
}
Campi
name

string

Facoltativo. Il nome dell'organizzatore dell'evento. Nessuna limitazione di caratteri.

IntegrationType

Profondità dell'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 di commercianti, servizi e (facoltativamente) disponibilità.

PerOrderFee

Tariffe da pagare una volta per ordine, indipendentemente dal numero di biglietti.

Rappresentazione JSON 
{
  "deliveryFee": {
    object (Price)
  },
  "processingFee": {
    object (Price)
  }
}
Campi
deliveryFee

object (Price)

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

object (Price)

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

ToursAndActivitiesContent

Campi dei contenuti specifici per tour e attività. Ogni elemento nel campo ripetuto deve essere indipendente per consentire il rendering separato (ad es. come punto elenco).

Il completamento di ToursAndActivitiesContent è vivamente consigliato per tour e attività, ma non è strettamente obbligatorio. Tutti i campi supportano sia il testo normale sia il testo simile a HTML per la formattazione di base. Tag di formattazione simili a HTML supportati:

Tag di frasi:
, , , : sono supportati solo i tre tag menzionati sopra.
può essere utilizzato per interrompere le righe nei paragrafi, mentre // può essere utilizzato per evidenziare un testo importante. Tutti gli altri tag di frasi 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 verranno mai mostrati agli utenti finali.

Note importanti: * Non duplicare i dati già forniti in highlights, exclusion e in altri campi più specifici nella descrizione del servizio. * Evita di utilizzare altri tag, ad eccezione di quelli supportati menzionati sopra, perché i contenuti all'interno dei tag non supportati verranno rimossi e potrebbero comportare un'esperienza utente indesiderata.

Rappresentazione JSON 
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
Campi
highlights[]

object (Text)

L'elenco dei momenti salienti visibile agli utenti.
inclusions[]

object (Text)

L'elenco delle inclusioni visibile all'utente.
exclusions[]

object (Text)

L'elenco delle esclusioni visibile agli utenti.
mustKnow[]

object (Text)

L'elenco visibile all'utente di note importanti, da utilizzare per dettagli quali limiti di età o altre condizioni che rendono questo servizio non idoneo.

Località

Informazioni geografiche su una località.

Rappresentazione JSON 
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
Campi
placeId

string

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

string

Il nome, il telefono, l'URL e le coordinate geografiche della sede vengono utilizzati per facilitare la corrispondenza della sede con i luoghi già presenti su Google Maps.

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

string

Il numero di telefono pubblico della sede, inclusi il prefisso internazionale e il prefisso locale, ad es. +14567891234. (facoltativo)
url

string

L'URL del sito web pubblico della località. (facoltativo)
geo

object (GeoCoordinates)

Le informazioni geografiche della posizione, tra cui latitudine, longitudine e indirizzo. (facoltativo)
locationType

enum (LocationType)

Il tipo di posizione deve essere fornito se questa posizione viene fornita per un servizio.
locationId

string

Riferimento univoco della posizione 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 acquisizione personalizzato, è possibile utilizzare un insieme di ID località per specificare le opzioni di località di ritiro. Se impostato, questo ID deve essere univoco all'interno dello stesso servizio. (facoltativo)

LocationType

Il tipo di questa località.

Enum
LOCATION_TYPE_UNSPECIFIED Tipo di località non specificato.
VISITED_LOCATION La posizione in cui viene visitato questo servizio.
START_LOCATION La posizione in cui inizia questo servizio funge anche da MEETING_LOCATION.
END_LOCATION La località in cui termina questo servizio.

Classificazione

Definisce la valutazione per un'entità.

Rappresentazione JSON 
{
  "value": number,
  "numberOfRatings": string
}
Campi
value

number

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

string

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

HomeServiceData

Informazioni aggiuntive da fornire per il verticale dei servizi per la casa.

Rappresentazione JSON 
{
  "categoryType": string,
  "jobType": string
}
Campi
categoryType

string

La categoria di livello superiore a cui appartiene questo servizio per la casa. Ad es. idraulico, elettricista ecc.
jobType

string

Il tipo di prestazione nella categoria a cui appartiene il servizio per la casa specificato. Ad esempio, unclog_drain e install_faucet sono i tipi di prestazione nella categoria idraulico.

VirtualSession

Informazioni sulla sessione virtuale/online. Ad esempio, lezione di yoga online, corso di cucina virtuale e così via.

Rappresentazione JSON 
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
Campi
sessionInstructions

object (Text)

Istruzioni su come è configurata questa classe 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 esempio, "L'URL di Zoom verrà inviato 30 minuti prima dell'inizio del corso". (Consigliato)
sessionRequirements

object (Text)

Requisiti per la sessione virtuale specificata. Ad es. tappetino da yoga, utensili da cucina ecc. (consigliato)
virtualPlatformInfo

object (VirtualPlatformInfo)

Informazioni sulla piattaforma virtuale utilizzata in questa sessione. (richiesto per attivare i servizi virtuali)
isSessionPrerecorded

boolean

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 (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
Campi
platform

enum (Platform)

Piattaforma utilizzata per la sessione virtuale.
otherPlatformName

object (Text)

Il nome della piattaforma se è impostata su ALTRO. (Obbligatorio se la piattaforma è impostata su ALTRO)

Piattaforma

Enumerazione per indicare quale piattaforma virtuale verrà utilizzata dal commerciante.

Enum
PLATFORM_UNSPECIFIED Non utilizzata.
FLEXIBLE Il commerciante è flessibile nella scelta della piattaforma video da utilizzare.
GOOGLE_HANGOUTS Prodotto Google Hangouts.
GOOGLE_MEET Prodotto Google Meet.
ZOOM Zoom Video Communications.
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 Prenota con Google.

Rappresentazione JSON 
{
  "paymentMethods": [
    {
      object (Text)
    }
  ]
}
Campi
paymentMethods[]

object (Text)

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

UriTemplate

Un modello che specifica come Google deve generare gli URL per il sito esterno.

Rappresentazione JSON 
{
  "uriTemplate": string
}
Campi
uriTemplate

string

Facoltativo. Il modello di URI deve seguire la RFC6570, vedi https://datatracker.ietf.org/doc/html/rfc6570. Supporta i modelli di livello 2. Questi parametri verranno risolti nei valori specificati nelle rispettive entità.

Parametri disponibili per il link esterno di prenotazione del ristorante: 1) (obbligatorio) {availability_slot_start_seconds} :: compilato dal campo startSec nel feed di disponibilità 2) (obbligatorio) {resources_party_size} :: compilato dal campo partySize nel feed di disponibilità 3) (facoltativo) {availability_slot_duration_seconds} :: compilato dal campo durationSec nel feed di disponibilità 4) (facoltativo) {availability_slot_availability_tag} :: compilato dal campo availabilityTag nel feed di disponibilità

Esempio di utilizzo: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size}

Con: * startSec = 123456 * partySize = 2

https://example.com/book/restaurant?start=123456&num_guests=2

Metodi

create

 Crea un nuovo Service di un commerciante gestito dall'aggregatore specificato e lo restituisce.

delete

 Elimina un Service esistente di un commerciante gestito dall'aggregatore specificato.

patch

 Aggiorna un Service esistente di un commerciante gestito dall'aggregatore specificato e lo restituisce.