- Risorsa: commerciante
- PaymentRestrictions
- CreditCardRestrictions
- CreditCardType
- PaymentOption
- PaymentOptionType
- ActivationType
- UserPurchaseRestriction
- PaymentProcessorConfig
- Processore
- TokenizationConfig
- BillingInformationFormat
- Termini
- MerchantMatchingHints
- ServiceAttribute
- Valore
- Consulenza
- Metodi
Risorsa: commerciante
Informazioni su un commerciante sulla piattaforma dell'aggregatore.
Rappresentazione JSON |
---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
Campi | |
---|---|
name |
Il nome della risorsa del commerciante, che ha il formato |
merchantName |
Il nome commerciante, il numero di telefono, l'URL e la posizione geografica vengono utilizzati per supportare la corrispondenza dell'inventario dei partner con i commercianti già presenti su Google Maps. Queste informazioni non verranno visualizzate. Il nome del commerciante. |
telephone |
Il numero di telefono pubblico del commerciante, inclusi i prefissi paese e le zone, ad esempio +14567891234. |
url |
L'URL del sito web pubblico del commerciante. |
geo |
I dati geografici del commerciante, inclusi latitudine, longitudine e indirizzo. |
category |
La categoria dell'attività nella piattaforma dell'aggregatore. |
numBookings30d |
Campo obsoleto. |
taxRateBasisPoints |
Aliquota fiscale del commerciante in punti base (centesimo di uno percento). Ad esempio, se l'aliquota fiscale è del 7,5%, questo campo deve essere impostato su 750. Se questo campo non viene impostato o viene impostato su 0, il prezzo totale addebitato a un utente per qualsiasi servizio fornito da questo commerciante è il prezzo esatto specificato da Service.price. Si presume che il prezzo del servizio sia esente o già comprensivo di imposte applicabili. Le tasse non verranno mostrate all'utente come voci separate. Se questo campo viene impostato su un valore diverso da zero, il prezzo totale addebitato a un utente per qualsiasi servizio fornito da questo commerciante includerà il prezzo del servizio più l'imposta calcolata utilizzando l'aliquota fiscale fornita qui. Le frazioni dell'unità di valuta più piccola (ad esempio le frazioni di un centesimo) verranno arrotondate utilizzando l'arrotondamento pari più prossimo. Le tasse verranno mostrate all'utente come voce separata. Questo campo è obsoleto. Utilizza taxRate. |
taxRate |
L'aliquota fiscale del commerciante. Se presente, questo campo sostituisce il campo taxRateBasisPoints obsoleto. Se visualizzi un messaggio vuoto (ad es. taxRate { }), l'aliquota fiscale applicata viene azzerata. |
paymentRestrictions |
Limitazioni relative ai metodi di pagamento accettati da questo commerciante. Se questo campo non viene impostato, non esistono limitazioni. |
paymentOption[] |
Opzioni di pagamento disponibili per questo commerciante. I servizi di questo commerciante potranno limitare singolarmente le opzioni di pagamento consentite. |
paymentProcessorConfig |
Configurazione per un elaboratore dei pagamenti tokenizzato, se il commerciante supporta questo servizio. |
tokenizationConfig |
Configurazione per un elaboratore dei pagamenti tokenizzato, se il commerciante supporta questo servizio. |
terms |
I Termini e condizioni del commerciante specifici mostrati all'utente quando un servizio viene prenotato tramite Prenota con Google. Oltre a questi, i Termini e condizioni del partner aggregatore vengono sempre mostrati all'utente e non devono essere forniti qui. |
brandId |
Una stringa opaca che identifica il brand rivolto ai consumatori da utilizzare quando viene visualizzata l'attribuzione del partner. Questo campo consente ai partner con più brand rivolti ai consumatori di fornire commercianti per tutti i brand all'interno dello stesso feed. Un brand è costituito da proprietà rivolte ai consumatori, come il nome, il logo, i Termini di servizio e le Norme sulla privacy. Se è presente un solo brand partner rivolto ai consumatori, questo campo non deve essere impostato e può essere ignorato. Se il partner... Non ha più brand rivolti ai consumatori? --> Ignora questo campo Sono configurati più brand?
Nota: per la maggior parte dei partner non è necessario impostare questo campo. Se un partner vuole utilizzare questo campo, deve prima contattarci per configurare brand separati, incluso quello predefinito. |
matchingHints |
Suggerimenti per aiutare Google ad associare un commerciante a un luogo su Google Maps. Nota: la maggior parte dei partner non deve impostare questo campo, poiché Google abbinerà i commercianti ai luoghi su Google Maps utilizzando le informazioni fornite sopra. (facoltativo) |
serviceAttribute[] |
Definizioni degli attributi dei servizi utilizzati per descrivere i Servizi per questo Commerciante. (facoltativo) |
actionLink[] |
Campo facoltativo. Un URL di azione con lingua associata, un elenco di paesi con limitazioni, il tipo e la piattaforma facoltativa che indichi la piattaforma su cui eseguire questa azione. |
waitlistAdvisement |
Campo facoltativo. Consigli generali di un commerciante specifico in merito a un utente che si iscrive a una lista d'attesa tramite Prenota con Google. I singoli campi di testo nel consiglio devono avere una lunghezza massima di 100 byte. |
PaymentRestrictions
Limitazioni relative ai metodi di pagamento accettati da questo commerciante.
Rappresentazione JSON |
---|
{
"creditCardRestrictions": {
object ( |
Campi | |
---|---|
creditCardRestrictions |
Limitazioni relative alle carte di credito accettate da questo commerciante. Se questo campo non è impostato, si presuppone che vengano accettate tutte le carte di credito. Tieni presente che l'elenco di carte supportate da CreditCardType aumenterà nel tempo, il che significa che lasciare questo campo vuoto sottopone una configurazione a modifiche future. |
CreditCardRestrictions
Limitazioni relative ai tipi di carta di credito accettati da questo commerciante.
Rappresentazione JSON |
---|
{
"creditCardType": [
enum ( |
Campi | |
---|---|
creditCardType[] |
Un elenco delle carte di credito supportate. Se il campo è vuoto, le carte di credito non sono supportate. |
CreditCardType
Un tipo di carta di credito.
Enum | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
Non utilizzato. |
VISA |
Una carta di credito Visa. |
MASTERCARD |
Una carta di credito Mastercard. |
AMERICAN_EXPRESS |
Una carta di credito American Express. |
DISCOVER |
Una carta di credito Discover. |
JCB |
Una carta di credito JCB. |
PaymentOption
Un'opzione di pagamento, che può essere utilizzata per pagare i servizi forniti da un commerciante. Le opzioni di pagamento possono essere condivise tra più commercianti (ad es. commercianti appartenenti alla stessa catena).
Rappresentazione JSON |
---|
{ "paymentOptionId": string, "name": string, "description": string, "price": { object ( |
Campi | |
---|---|
paymentOptionId |
Questo ID viene utilizzato per identificare questa opzione di pagamento. Questo ID è globale per l'intero aggregatore e il riutilizzo di un valore per più commercianti consentirà a un utente di pagare con l'opzione di pagamento corrispondente per tutti i commercianti in questione. Quando riutilizzi un ID a favore di più commercianti, l'aggiornamento di un valore per un'opzione di pagamento per un commerciante comporterà anche l'aggiornamento di qualsiasi altra opzione di pagamento con lo stesso ID, ma per un commerciante diverso. Di conseguenza, ti consigliamo di fare in modo che tutte le opzioni di pagamento che condividono lo stesso ID siano sempre aggiornate a valori identici, per evitare qualsiasi possibilità di comportamenti scorretti. |
name |
Il nome dell'opzione di pagamento. Può essere visibile all'utente. |
description |
Una descrizione dell'opzione di pagamento. Può essere visibile all'utente. |
price |
Il prezzo dell'opzione di pagamento. |
taxRate |
L'aliquota fiscale per questa opzione di pagamento. Se presente, questo campo sostituisce il campo taxRate (aliquota fiscale) presente nel commerciante o nel servizio. Se visualizzi un messaggio vuoto (ad es. taxRate { }), l'aliquota fiscale applicata viene azzerata. |
paymentOptionType |
Il tipo di questa opzione di pagamento. Monouso per i pacchetti, multiuso per i pacchetti e illimitato per gli abbonamenti. |
sessionCount |
Il numero di sessioni per cui può essere utilizzata questa opzione di pagamento. Valido solo per più sessioni / pacchetti, dove il valore deve essere maggiore di 1. |
purchaseInterval |
L'opzione di pagamento può essere acquistata entro questo intervallo. |
validInterval |
L'opzione di pagamento può essere utilizzata entro questo intervallo di tempo (ad es. prezzo speciale per gennaio 2017). Se presente, sostituisce validDuration e activationType. |
validDuration |
Durata della validità dell'opzione di pagamento (ad es. 30 giorni di abbonamento). Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
activationType |
Definisce come viene determinata la data di inizio della validità di questa opzione di pagamento. |
userRestriction |
Limita gli utenti idonei all'acquisto di questa opzione di pagamento. Può essere utilizzato per limitare un'opzione di pagamento promozionale a un sottoinsieme di utenti. Se non viene configurato, tutti gli utenti sono idonei. |
PaymentOptionType
Un tipo di opzione di pagamento.
Enum | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
Non utilizzato. |
PAYMENT_OPTION_SINGLE_USE |
L'opzione di pagamento può essere utilizzata una sola volta. |
PAYMENT_OPTION_MULTI_USE |
L'opzione di pagamento può essere utilizzata se il numero di sessioni è > 0. |
PAYMENT_OPTION_UNLIMITED |
L'opzione di pagamento può essere utilizzata nell'intervallo di tempo valido: il conteggio delle sessioni non è applicabile. |
ActivationType
Definisce come viene determinata la data di inizio della validità.
Enum | |
---|---|
ACTIVATION_TYPE_UNSPECIFIED |
Non utilizzato. |
ACTIVATION_ON_PURCHASE |
La validità decorre al momento dell'acquisto. |
ACTIVATION_ON_FIRST_USE |
La validità inizia quando l'opzione di pagamento viene utilizzata per la prima volta. |
UserPurchaseRestriction
Limita gli utenti idonei ad acquistare un'opzione di pagamento.
Rappresentazione JSON |
---|
{ "newToMerchant": boolean, "newToPaymentOption": boolean } |
Campi | |
---|---|
newToMerchant |
Un'opzione di pagamento che può essere acquistata solo dagli utenti che non hanno mai effettuato acquisti dallo stesso commerciante. |
newToPaymentOption |
Un'opzione di pagamento che può essere acquistata solo dagli utenti che non hanno mai acquistato la stessa opzione di pagamento in precedenza. |
PaymentProcessorConfig
Una configurazione per un elaboratore dei pagamenti, impostata per il commerciante.
Rappresentazione JSON |
---|
{
"processor": enum ( |
Campi | |
---|---|
processor |
Definisce il partner elaboratore dei pagamenti a cui si applica questa configurazione. |
publicKey |
La chiave utilizzata per identificare questo commerciante presso l'elaboratore dei pagamenti. Per Stripe, consulta: https://stripe.com/docs/dashboard#api-keys Per Braintree, consulta: https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version |
Il numero di versione dell'API inviato all'elaboratore dei pagamenti insieme alle richieste di pagamento. |
Processore
Definisce uno specifico elaboratore dei pagamenti partner.
Enum | |
---|---|
PROCESSOR_UNSPECIFIED |
Non utilizzato |
PROCESSOR_STRIPE |
Una configurazione per i pagamenti con Stripe. |
PROCESSOR_BRAINTREE |
Una configurazione per i pagamenti con Braintree. |
TokenizationConfig
Una configurazione per la tokenizzazione dell'elaboratore dei pagamenti, impostata in base al singolo commerciante.
Rappresentazione JSON |
---|
{
"tokenizationParameter": {
string: string,
...
},
"billingInformationFormat": enum ( |
Campi | |
---|---|
tokenizationParameter |
Una configurazione di tokenizzazione ha in genere un parametro tokenizationParameter la cui chiave è "gateway" e il cui valore è il nome del processore. Gli altri parametri dipendono dal processore. Per ulteriori informazioni, consulta la documentazione di Google Pay. Esempio di Braintree: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantKey3" value: "abcrainKeytree" token: "abcrainKeytree" Esempio di Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" } Esempio Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" } Un oggetto contenente un elenco di |
billingInformationFormat |
Includi nel token di pagamento i dati di fatturazione dell'utente inseriti in Google Pay con la forma di pagamento (vedi sopra). Lasciare vuoto il campo equivale a specificare MIN. |
BillingInformationFormat
L'indirizzo di fatturazione da richiedere all'utente da includere nel token. I valori di enum corrispondono ai parametri nell'API Google Pay (consulta la pagina https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).
Enum | |
---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
Non specificato. Il valore predefinito è MIN. |
MIN |
nome, codice paese e codice postale (impostazione predefinita di Google Pay). |
FULL |
nome, via, località, regione, codice paese e codice postale. |
Termini
Un insieme di regole e linee guida che viene mostrato all'utente per effettuare una prenotazione tramite Prenota con Google.
Rappresentazione JSON |
---|
{
"url": string,
"text": string,
"localizedText": {
object ( |
Campi | |
---|---|
url |
Facoltativamente, l'URL dei Termini e condizioni. |
text |
Il testo da mostrare all'utente. Utilizza localizedText di seguito per nuove integrazioni. |
localizedText |
Il testo localizzato da mostrare all'utente. |
MerchantMatchingHints
Suggerimenti utilizzati per aiutare Google ad associare un commerciante a un luogo su Google Maps.
Rappresentazione JSON |
---|
{ "placeId": string } |
Campi | |
---|---|
placeId |
L'ID luogo di un luogo nel database di Google Places e su Google Maps. Per ulteriori informazioni sugli ID luogo, visita la pagina all'indirizzo https://developers.google.com/places/web-service/place-id. |
ServiceAttribute
Gli attributi dei servizi sono categorie definite dal partner che descrivono i Servizi per un Commerciante. Ad esempio, una banca potrebbe definire un attributo di servizio "Tipo di conto bancario" con i possibili valori "Personale" e "Azienda", mentre un parrucchiere potrebbe definire un attributo di servizio "Tipo di servizio" con i possibili valori di "Taglio", "Colore" e "Stile".
Rappresentazione JSON |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
Campi | |
---|---|
attributeId |
Un identificatore che identifica in modo univoco questo attributo di servizio tra gli altri per lo stesso commerciante, ad esempio "account-type". |
attributeName |
Un nome visibile all'utente per questo attributo, ad esempio "Tipo account". |
value[] |
Tutti i valori possibili per questo attributo di servizio. |
Valore
Rappresenta un possibile valore per un particolare attributo del servizio.
Rappresentazione JSON |
---|
{ "valueId": string, "valueName": string } |
Campi | |
---|---|
valueId |
Un identificatore che identifica in modo univoco questo valore tra gli altri per questo attributo del servizio, ad esempio "personale". |
valueName |
Un nome visibile all'utente per il valore, ad esempio "Personale". |
Consulenza
Consigli mostrati all'utente al momento della prenotazione tramite Prenota con Google.
Rappresentazione JSON |
---|
{
"text": {
object ( |
Campi | |
---|---|
text |
Messaggio personalizzato da mostrare all'utente al momento della prenotazione tramite Prenota con Google. |
Metodi |
|
---|---|
|
Crea un nuovo Merchant gestito dall'aggregatore specificato e lo restituisce. |
|
Elimina un elemento Merchant esistente gestito dall'aggregatore specificato. |
|
Ottieni il MerchantStatus di un Merchant . |
|
Aggiorna un elemento Merchant esistente gestito dall'aggregatore specificato e lo restituisce. |