REST Resource: inventory.partners.merchants.services

Risorsa: servizio

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, che ha il formato partners/{partner_id}/merchants/{merchantId}/services/{serviceId}.
serviceName

string

Il nome del servizio, ad esempio "Taglio uomo". È deprecato. Utilizza localizedServiceName.
localizedServiceName

object (Text)

Il nome del servizio, ad esempio "Taglio uomo". Possibilmente in più lingue.
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 la formattazione sia in testo normale sia in HTML. A differenza delle sezioni di testo normale, qui è possibile creare layout personalizzati utilizzando intestazioni, paragrafi, elenchi e alcuni tag di frase. Leggi attentamente le istruzioni e le note che seguono per 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> mostrerà il testo in linea come l'intestazione più importante della sezione. Tieni presente che eventuali tag HTML, stili o attributi interni verranno ignorati. Ad esempio, <h1 style=".."> verrà trattato come <h1>. Verrà conservato solo il testo puro.

Tag paragrafo: <p>
Il tag paragrafo può essere utilizzato per mettere in evidenza un'introduzione o dei contenuti dettagliati. Eventuali tag, stili o attributi interni verranno ignorati, con alcune eccezioni: <br>, <strong> ed <em>. Per ulteriori dettagli, consulta la sezione relativa al tag 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. Si tratta di un buon modo per visualizzare elenchi di controllo, programmi o altri elenchi adatti ai tuoi casi d'uso.
Esempio: per mostrare un elenco di funzionalità di una crociera:
<ol>
<li>Splendida vista sull'oceano e possibilità di interagire con la fauna selvatica.</li>
<li>Organizzazione e servizi di viaggio accuratamente progettati.</li>
<li>Prezzo più basso garantito.</li>
</ol>
Tieni presente che verranno convertiti solo gli elementi <li> secondari all'interno di tag <ul> o <ol>. Tutti gli altri elementi secondari verranno ignorati. Inoltre, tutti i tag, gli attributi e gli stili interni verranno ignorati; vengono conservati solo i contenuti di testo puro.

Tag di divisione: <div>
Tutti i tag interni supportati del tag <div> verranno analizzati con le regole indicate sopra. Ciò implica che il tag <div> stesso non indica alcun raggruppamento o rientro. Inoltre, eventuali attributi e stili interni verranno ignorati.

Tag di frase: <br>, <strong>, <em>:
Sono supportati solo i tre tag sopra menzionati. <br> può essere utilizzato per inserire interruzioni di riga nei paragrafi e <strong>/<em> per evidenziare il testo importante. Eventuali altri tag di frase verranno ignorati.

Tag non supportati:

  • I tag <html>, <header> e <body> non sono consentiti.
  • Tutti gli altri tag non menzionati sopra non sono supportati (ad es. <table>, <td> ...).
    Tutti gli URL, gli anchor e i link verranno rimossi e non verranno mai visualizzati agli utenti finali. Se vuoi utilizzare le foto per creare un'esperienza utente completa, 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 sopra indicati, perché i contenuti all'interno dei tag non supportati verranno rimossi e potrebbero portare a un'esperienza utente indesiderata.
  • Prova a evitare strutture nidificate profonde, come più di tre diversi livelli di intestazione o elenchi nidificati. Mantieni la struttura piatta, semplice e lineare per creare un'esperienza utente migliore.
  • Se i layout attualmente supportati non sono sufficienti per i tuoi casi d'uso, contatta il team di Prenota con Google.
  • La dimensione massima consigliata è di 32.000 caratteri.
price

object (Price)

Il prezzo del servizio.
priceInterpretation

enum (PriceInterpretation)

Descrive in che modo 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

object (SchedulingRules)

Regole per prenotare/annullare un appuntamento.
prepaymentType

enum (PrepaymentType)

Indica se il pagamento anticipato è obbligatorio, facoltativo o non supportato.
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 ulteriori informazioni al momento della prenotazione di questo servizio. (facoltativo)
perTicketIntakeForm

object (ServiceIntakeForm)

Un modulo che richiede all'utente ulteriori informazioni al momento della prenotazione di questo servizio. Questo modulo deve essere compilato una volta per ogni biglietto che l'utente sta prenotando. (facoltativo)
taxRate

object (TaxRate)

L'aliquota fiscale del servizio. Se presente, questo campo sostituisce qualsiasi aliquota fiscale impostata a livello di commerciante. Un messaggio vuoto (ad es. taxRate { }) reimposta 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 in che modo un deposito può essere addebitato all'utente. Sostituisce il deposito per il servizio, se specificato. Se imposti 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. Sostituisce la tariffa per mancata presentazione al servizio, se specificata. Se imposti 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. Questo campo può essere ignorato 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 supportati. (facoltativo)
relatedMedia[]

object (RelatedMedia)

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

object (ServiceAttributeValueId)

(Facoltativo) Valori degli attributi del servizio che si applicano a questo servizio. Ogni servizio può avere zero o più valori per ogni attributo del 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 di vendita di biglietti per eventi. (facoltativo)
integrationType

enum (IntegrationType)

Il livello di integrazione supportato per questo servizio. (Facoltativo) Non pertinente per i partner con l'integrazione iniziale. La modalità 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)

Sedi 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 in bici guidato che visita tre sedi. È necessario specificare la sede di partenza. - Un tour in autobus che parte dalla hall di un hotel e si dirige verso la sede visitata. È necessario specificare la sede della riunione.
rating

object (Rating)

La valutazione degli utenti per questo servizio come metrica aggregata per 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 in che modo Google deve generare gli URL dei siti esterni.

PriceInterpretation

Descrive in che modo 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 un corso 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 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 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 mostrate informazioni sui prezzi ai consumatori in anticipo.

Tieni presente che qualsiasi servizio che utilizza questa interpretazione del prezzo deve utilizzare PrepaymentType NOT_SUPPORTED e il prezzo 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 necessario per annullare un appuntamento prenotato online. (facoltativo)
lateCancellationFee
(deprecated)

object (Price)

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

object (Price)

La tariffa per il mancato arrivo senza annullamento.
admissionPolicy

enum (AdmissionPolicy)

I criteri di ammissione che si applicano 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 Cose da fare)

Campo unione min_booking_buffer. La durata (in secondi) dal momento in cui è possibile effettuare l'ultima prenotazione a quello di inizio o di fine della fascia oraria di disponibilità.

Se è impostato "min_advance_booking", l'ultima ora prenotabile viene calcolata come (<ora di inizio slot> - "min_advance_booking"). Se è impostato "min_booking_buffer_before_end_time", l'ultima ora prenotabile viene calcolata come (<ora di fine slot> - "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 spazio può essere prenotato fino all'ora di inizio. Se entrambi i campi sono impostati, verrà scelto un solo valore mentre l'altro verrà ignorato. Non possiamo prevedere in modo affidabile quale valore verrà scelto.

Esempi:

  • Un taglio di capelli che deve essere prenotato almeno 1 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'orario di inizio. 'scheduling_rules{ ...}' (lascia vuoto questo campo) (facoltativo) min_booking_buffer può essere solo uno dei seguenti:
minAdvanceBooking

string (int64 format)

La durata (in secondi) dal momento in cui è possibile effettuare l'ultima prenotazione all'inizio dell'intervallo di disponibilità.
minBookingBufferBeforeEndTime

string (int64 format)

La durata (in secondi) dal momento in cui è possibile effettuare l'ultima prenotazione a quello in cui termina lo spazio 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

I criteri di ammissione di questo servizio.

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

I clienti possono arrivare in qualsiasi momento tra l'ora di inizio e quella di fine dell'intervallo di disponibilità per utilizzare questa prenotazione.

Esempi di casi d'uso di TIME_FLEXIBLE: * Un biglietto per un museo che può essere utilizzato in qualsiasi momento nella 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 dal commerciante all'orario di inizio dell'appuntamento, ma possono andarsene quando vogliono.

Ad esempio, nello scenario di ingresso al museo, un biglietto con orario di ingresso alle 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 entrata designata. L'ora di fine, invece, viene utilizzata solo come chiave per identificare lo spazio 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 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 una 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 che può essere rimborsata, 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

Enum per indicare il tipo di pagamento anticipato.

Enum
PREPAYMENT_TYPE_UNSPECIFIED Per impostazione predefinita, assumeremo 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 effettuare la prenotazione.
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à addebitato l'importo rispetto al momento dell'acquisto.
chargeTimeBeforeStartTimeSec

string (int64 format)

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

ChargeTiming

Enum per specificare quando verrà addebitato l'importo rispetto al momento dell'acquisto.

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

ServiceIntakeForm

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

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

object (ServiceIntakeFormField)

Campi che verranno mostrati all'utente.
firstTimeCustomers
(deprecated)

boolean

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

boolean

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

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 corrispondere a quello nella risposta del campo del 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 localizedLabel.
localizedLabel

object (Text)

Il testo mostrato all'utente per questo campo. Il campo può essere fornito in più lingue. (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 elencare le possibili scelte.
isRequired

boolean

Indica se una risposta a questo campo è obbligatoria per un utente.
allowCustomAnswer

boolean

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

object (Text)

Opzioni aggiuntive fornite oltre ai valori forniti. Applicabile solo quando il tipo di campo è LOCATION_SEARCH. Ad esempio, oltre all'elenco di sedi fornito, un'altra opzione disponibile può essere "Contattarò 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 l'insieme di ID tipo di biglietto applicabili. Lascia vuoto il campo se la domanda è sempre applicabile.
hint

object (Text)

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 testo di una riga.
PARAGRAPH Un campo di immissione di testo multilinea.
MULTIPLE_CHOICE Un insieme di pulsanti di opzione che richiedono una scelta tra molte opzioni.
CHECKBOXES Uno o più elementi enumerati 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 utilizzato.
SERVICE_TYPE_DINING_RESERVATION Prenotazione per il ristorante.
SERVICE_TYPE_FOOD_ORDERING Ordinazione di cibo, che può essere con consegna a domicilio o da asporto o entrambi.
SERVICE_TYPE_FOOD_DELIVERY Consegna di cibo.
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) salute e fitness, (2) spa e bellezza e (3) servizi di consulenza 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 completamente virtuale. Deve essere impostato se attivi le prenotazioni di servizi virtuali.
SERVICE_TYPE_SHOPPING Servizio che consente agli utenti di fare acquisti dal commerciante specificato. Può essere consegna o ritiro.

TicketType

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

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

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 richiesta viene utilizzato per distinguere i diversi tipi di richieste dello stesso servizio e deve essere univoco solo all'interno di un servizio.
shortDescription

string

Una breve descrizione di questo tipo di ticket.

Questo può essere visibile all'utente, ad esempio "adulto", "bambino", "veterano", "Riga J" e così via. Obbligatorio: ogni tipo di biglietto deve avere una descrizione per essere visibile all'utente. È deprecato. Utilizza localizedShortDescription.
localizedShortDescription

object (Text)

Una breve descrizione di questo tipo di ticket con supporto i18n.

Questo può essere visibile all'utente, ad esempio "adulto", "bambino", "veterano", "Riga J" e così via. Obbligatorio: ogni tipo di biglietto deve avere una descrizione visibile all'utente. È possibile fornire valori separati per ogni lingua.
price

object (Price)

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

object (PerTicketFee)

Commissioni aggiuntive 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 lingua.

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

Esempio 1: un biglietto di ingresso con diversi tipi "adulto", "bambino" e la lingua come opzione aggiuntiva, l'elenco TicketType previsto sarà: - { 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: una locazione di kayak per più ore con un componente aggiuntivo facoltativo per la borsa asciutta. La shortDescription potrebbe essere "3 ore" e la optionDescription potrebbe essere "con borsa asciutta" o "senza borsa asciutta": - { 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 per qualsiasi tipo di ticket all'interno del servizio è impostato questo campo, prevediamo che lo sia anche per tutti gli altri tipi di ticket (potrebbe essere utilizzata una descrizione predefinita dell'opzione). 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 destinati a essere utilizzati per specificare le opzioni con un titolo e una descrizione dettagliata, ad esempio: "Posti premium
Questa opzione offre posti nelle tribune private, inclusi sedili completamente imbottiti, TV private e servizio di cibi e bevande a sedere. Questi posti offrono viste pittoresche del campo".
inventoryType

enum (InventoryType)

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

PerTicketFee

Commissioni da pagare per ogni biglietto acquistato dall'utente.

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

object (Price)

Un addebito extra per un servizio.
facilityFee

object (Price)

Una commissione che va alla sede/struttura.
taxes

object (Price)

Imposte per biglietto.

PriceDisplayType

Indica il formato del prezzo visualizzato nella pagina di destinazione.

Questo campo viene ignorato per l'inventario senza link out.

Questo campo consente alle piattaforme Google di mostrare lo stesso formato di prezzo utilizzato nella pagina di destinazione del servizio. Formati dei prezzi coerenti migliorano il tasso di conversione e riducono la confusione.

Enum
PRICE_DISPLAY_TYPE_UNSPECIFIED Il tipo di visualizzazione del prezzo non è specificato. Google determinerà il formato da mostrare.
PRICE_DISPLAY_TYPE_BASE Il prezzo mostrato nella 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.

RelatedMedia

Foto correlate 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 (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 su questo URL.
type

enum (MediaType)

Tipo di questa sorgente multimediale.
localizedCaption

object (Text)

La didascalia dei contenuti multimediali che supportano la localizzazione internazionale, è supportato solo il testo normale. Eventuali componenti HTML verranno rimossi. (facoltativo)
attribution

object (Attribution)

Informazioni sull'attribuzione della fonte dei contenuti multimediali. Tieni presente che se l'attribuzione è obbligatoria per la visualizzazione dei contenuti multimediali al fine di dare il merito al fotografo o all'agenzia, questo campo deve essere impostato. (facoltativo)
caption
(deprecated)

string

È deprecato, preferibilmente utilizza localizedCaption.

MediaType

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

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 (Text)
  },
  "text": string
}
Campi
localizedText

object (Text)

Il testo da assegnare al fotografo o all'agenzia che supporta l'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 ipertestuali non è supportata).
text
(deprecated)

string

È stato ritirato, preferi usare localizedText.

ServiceAttributeValueId

Identifica un determinato valore di un attributo del 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 per questo attributo, ad esempio "taglio di capelli". Deve corrispondere a un valueId 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 iscrive alla lista d'attesa per questo servizio.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

Imposta le opzioni per i gruppi più grandi del valore impostato per maxPartySize. Lascia vuoto se i gruppi più grandi non devono avere opzioni alternative per iscriversi a una lista d'attesa.

UnsupportedPartySizeOption

Opzioni per le parti fuori 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 portata. kind può essere solo uno dei seguenti:
callMerchant

object (CallMerchant)

I gruppi di dimensioni non comprese 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}, 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, verrà visualizzata un'opzione per consentire agli utenti di chiamare l'attività per una prenotazione.

TicketingVerticalSpecificData

Informazioni aggiuntive specifiche per il verticale di 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. Impostato 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. URL in cui è possibile guardare l'evento.
eventOrganizer

object (Text)

Facoltativo. Organizzatore che ospita l'evento.
eventOrganizerUrl

string

Facoltativo. 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 del prodotto. Nota: non si tratta di 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

URL della pagina web che descrive in modo univoco l'entità. Si tratta della 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 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 in un concerto o in uno spettacolo. Applicabile solo se la categoria dell'evento è CONCERT o THEATRE.
ENTITY_TYPE_PLAYER L'entità rappresenta la squadra o il giocatore sportivo presente 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 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 spettacolo (ad es. musical, commedia, balletto e così via) eseguito durante l'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 primo piano all'evento.
ENTITY_ROLE_SUPPORTER L'entità rappresenta un artista di supporto all'evento.
ENTITY_ROLE_HOME_TEAM L'entità rappresenta la squadra di casa dell'evento (sportivo).
ENTITY_ROLE_AWAY_TEAM L'entità rappresenta la squadra in trasferta nell'evento (sportivo).

PublicIdentificationData

Identificatori, pagine web o qualsiasi altra fonte pubblica che fa riferimento a un'entità.

Rappresentazione JSON 
{
  "relevantUrl": [
    string
  ],
  "musicbrainzId": string
}
Campi
relevantUrl[]

string

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

string

L'identificatore MusicBrainz di 36 caratteri dell'artista o di altre entità musicali, se applicabile. Consulta 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. Nome dell'autore 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. È necessario inviare solo i dati su commercianti, servizi e (facoltativamente) disponibilità.

PerOrderFee

Commissioni che devono essere pagate 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 del campo ripetuto deve essere indipendente per consentire il rendering separato (ad es. come punto elenco).

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

Tag di frase:
, , , : sono supportati solo i tre tag sopra menzionati.
può essere utilizzato per inserire interruzioni di riga nei paragrafi e // per evidenziare un testo importante. Eventuali altri tag di frase verranno ignorati.

Tutti gli altri tag e stili personalizzati non sono consentiti e verranno rimossi. Eventuali URL, ancore e link verranno rimossi e non verranno mai mostrati agli utenti finali.

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

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

object (Text)

L'elenco di elementi in evidenza visibile agli utenti.
inclusions[]

object (Text)

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

object (Text)

L'elenco di esclusioni visibile all'utente.
mustKnow[]

object (Text)

L'elenco di note importanti visibili agli utenti, da utilizzare per dettagli come limitazioni di età o altre condizioni che rendono questo servizio inadatto.

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 di 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 assocerà la posizione a questo luogo.
name

string

Il nome, il numero di telefono, l'URL e i dati geografici della stazione di ricarica vengono utilizzati per supportare la corrispondenza della stazione di ricarica con i luoghi già presenti su Google Maps.

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

string

Il numero di telefono pubblico della stazione di ricarica, inclusi il codice paese e il prefisso, ad esempio +14567891234. (facoltativo)
url

string

L'URL del sito web pubblico della stazione di ricarica. (facoltativo)
geo

object (GeoCoordinates)

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

enum (LocationType)

Il tipo di località, da fornire se la località è fornita per un servizio.
locationId

string

Riferimento univoco della stazione di ricarica 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 inserimento personalizzato, è possibile utilizzare un insieme di ID posizione 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 località in cui viene eseguito 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 di un'entità.

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

number

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

string

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

HomeServiceData

Informazioni aggiuntive da fornire per il verticale dei servizi a domicilio.

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

string

La categoria di alto livello a cui appartiene questo servizio per la casa. Ad es. idraulico, elettricista e così via.
jobType

string

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

VirtualSession

Informazioni sulla sessione virtuale/online. Ad es. corso 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 viene configurato questo corso virtuale. Se il partner non include l'URL del video con la prenotazione, questo testo deve indicare quando l'URL del video verrà condiviso con l'utente. quali "L'URL di Zoom verrà inviato per posta 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 e così via (consigliato)
virtualPlatformInfo

object (VirtualPlatformInfo)

Informazioni sulla piattaforma virtuale utilizzata in questa sessione. (Obbligatorio 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 la piattaforma è impostata su ALTRO. (Obbligatorio se la piattaforma è impostata su ALTRE)

Piattaforma

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

Enum
PLATFORM_UNSPECIFIED Non utilizzato.
FLEXIBLE Il commerciante ha la possibilità di scegliere la piattaforma video che preferisce.
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 indicate qui.

DirectMerchantPayment

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

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 in che modo Google deve generare gli URL dei siti esterni.

Rappresentazione JSON 
{
  "uriTemplate": string
}
Campi
uriTemplate

string

Facoltativo. Il modello URI deve rispettare il documento RFC 6570, consulta la pagina https://datatracker.ietf.org/doc/html/rfc6570. Supporta i modelli di Livello 2. Questi parametri verranno risolti nei valori specificati nelle rispettive entità.

5 parametri disponibili per il linkout di prenotazione di un tavolo: 1) (obbligatorio) {availability_slot_start_seconds} :: compilato dal campo startSec nel feed di disponibilità 2) (obbligatorio) {availability_slot_duration_seconds} :: compilato dal campo durationSec nel feed di disponibilità 3) (facoltativo) {resources_party_size} :: compilato dal campo partySize nel feed di disponibilità 4) (facoltativo) {availability_availability_tag} :: compilato dal campo availabilityTag nel feed di disponibilità 5) (facoltativo) {resources_room_id} :: compilato dal campo roomId nel feed di disponibilità

Esempio di utilizzo: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} * startSec = 123456 * partySize = 2 https://example.com/book/restaurant?start=123456&num_guests=2

Metodi

create

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

delete

 Consente di eliminare 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.