REST Resource: inventory.partners.merchants

Risorsa: commerciante

Informazioni su un commerciante che si trova sulla piattaforma dell'aggregatore.

Rappresentazione JSON 
{
  "name": string,
  "merchantName": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "category": string,
  "numBookings30d": string,
  "taxRateBasisPoints": integer,
  "taxRate": {
    object (TaxRate)
  },
  "paymentRestrictions": {
    object (PaymentRestrictions)
  },
  "paymentOption": [
    {
      object (PaymentOption)
    }
  ],
  "paymentProcessorConfig": {
    object (PaymentProcessorConfig)
  },
  "tokenizationConfig": {
    object (TokenizationConfig)
  },
  "terms": {
    object (Terms)
  },
  "brandId": string,
  "matchingHints": {
    object (MerchantMatchingHints)
  },
  "serviceAttribute": [
    {
      object (ServiceAttribute)
    }
  ],
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  }
}
Campi
name

string

Il nome della risorsa del commerciante, che ha il formato partners/{partner_id}/merchants/{merchantId}.
merchantName

string

Nome commerciante, telefono, URL e dati geografici vengono utilizzati per consentire la corrispondenza dell'inventario dei partner con i commercianti già presenti su Google Maps. Queste informazioni non verranno visualizzate.

Il nome del commerciante.
telephone

string

Il numero di telefono pubblico del commerciante, inclusi il paese e i prefissi, ad esempio +14567891234.
url

string

L'URL del sito web pubblico del commerciante.
geo

object (GeoCoordinates)

Le informazioni geografiche del commerciante, inclusi latitudine, longitudine e indirizzo.
category

string

La categoria dell'attività nella piattaforma dell'aggregatore.
numBookings30d
(deprecated)

string (int64 format)

Campo obsoleto.
taxRateBasisPoints
(deprecated)

integer (uint32 format)

L'aliquota fiscale del commerciante in punti base (un centesimo di un 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 corrisponde al prezzo esatto specificato da Service.price. Si presume che il prezzo del servizio sia esente dalle tasse applicabili o già comprensivo di tasse. Le imposte non verranno mostrate all'utente come voce separata.

Se questo campo è 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ù vicino. Le imposte verranno mostrate all'utente come voce separata.

Questo campo è obsoleto. Usa il valore TaxRate.
taxRate

object (TaxRate)

L'aliquota fiscale del commerciante. Se presente, questo campo sostituisce il campo TaxRateBasisPoints obsoleto. Un messaggio vuoto (ad esempio, TaxRate { }) reimposterà l'aliquota fiscale applicata su zero.
paymentRestrictions

object (PaymentRestrictions)

Restrizioni relative ai metodi di pagamento accettati da questo commerciante. Partiamo dal presupposto che non esistano limitazioni se questo campo non è impostato.
paymentOption[]

object (PaymentOption)

Opzioni di pagamento disponibili per questo commerciante. I servizi di questo commerciante potranno limitare singolarmente le opzioni di pagamento consentite.
paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

Configurazione per un elaboratore dei pagamenti tokenizzato, se il commerciante è supportato.
tokenizationConfig

object (TokenizationConfig)

Configurazione per un elaboratore dei pagamenti tokenizzato, se il commerciante è supportato.
terms

object (Terms)

I Termini e condizioni del commerciante specifico 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

string

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 nome, logo, Termini di servizio e 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 stati configurati più brand?

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

Nota importante: la maggior parte dei partner non ha bisogno di impostare questo campo. Se un partner vuole utilizzare questo campo, deve contattarci prima per configurare brand separati, incluso quello predefinito.
matchingHints

object (MerchantMatchingHints)

Suggerimenti per aiutare Google ad abbinare un commerciante a un luogo su Google Maps. Nota: la maggior parte dei partner non è necessario impostare questo campo, perché Google assocerà i commercianti ai luoghi su Google Maps utilizzando le informazioni fornite sopra. (facoltativo)
serviceAttribute[]

object (ServiceAttribute)

Definizioni di tutti gli attributi dei servizi utilizzati per descrivere i Servizi per questo Commerciante. (facoltativo)
waitlistAdvisement

object (Advisement)

(Facoltativo) Consigli generali di un commerciante specifico per un utente che si iscrive a una lista d'attesa tramite Prenota con Google. I singoli campi di testo nel consiglio devono essere limitati a 100 byte di lunghezza.

PaymentRestrictions

Restrizioni relative ai metodi di pagamento accettati da questo commerciante.

Rappresentazione JSON 
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
Campi
creditCardRestrictions

object (CreditCardRestrictions)

Restrizioni relative alle carte di credito accettate da questo commerciante. Supponiamo che tutte le carte di credito siano accettate se questo campo non è impostato. Tieni presente che l'elenco di carte supportate da CreditCardType aumenterà nel tempo, il che significa che lasciare vuoto questo campo soggetto a modifiche future.

CreditCardRestrictions

Restrizioni relative ai tipi di carta di credito accettati da questo commerciante.

Rappresentazione JSON 
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
Campi
creditCardType[]

enum (CreditCardType)

Un elenco di carte di credito supportate. Le carte di credito vuote 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 (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}
Campi
paymentOptionId

string

Questo ID viene utilizzato per identificare l'opzione di pagamento.

Questo ID è globale per l'intero aggregatore e il riutilizzo di un valore per più commercianti consente a un utente di pagare con l'opzione di pagamento corrispondente per tutti i commercianti in questione.

Quando viene riutilizzato un documento di identità per più commercianti, l'aggiornamento del valore di un'opzione di pagamento per un commerciante comporta anche l'aggiornamento di qualsiasi altra opzione di pagamento con lo stesso ID, per un altro commerciante. Di conseguenza, una best practice consiste nel fare in modo che tutte le opzioni di pagamento condividano lo stesso ID e vengano sempre aggiornate con valori identici, per evitare qualsiasi rischio di comportamenti ministi.
name

string

Il nome dell'opzione di pagamento. Può essere visibile all'utente.
description

string

Una descrizione dell'opzione di pagamento. Può essere visibile all'utente.
price

object (Price)

Il prezzo dell'opzione di pagamento.
taxRate

object (TaxRate)

L'aliquota fiscale per questa opzione di pagamento. Se presente, questo campo sostituisce il campo TaxRate presente nel Commerciante o nel Servizio. Un messaggio vuoto (ad esempio, TaxRate { }) reimposterà l'aliquota fiscale applicata su zero.
paymentOptionType

enum (PaymentOptionType)

Il tipo di questa opzione di pagamento. Uso singolo per i drop-in, multiuso per i pacchetti e illimitato per gli abbonamenti.
sessionCount

string (int64 format)

Il numero di sessioni per cui può essere utilizzata questa opzione di pagamento. Valido solo per più sessioni / pacchetti, dove il valore deve essere > 1.
purchaseInterval

object (TimeRange)

L'opzione di pagamento può essere acquistata entro questo intervallo di tempo.
validInterval

object (TimeRange)

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

string (Duration format)

Durata della validità dell'opzione di pagamento (ad es. abbonamento di 30 giorni).

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
activationType

enum (ActivationType)

Definisce il modo in cui viene determinata la data di inizio validità per questa opzione di pagamento.
userRestriction

object (UserPurchaseRestriction)

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 conteggio delle 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à inizia 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 all'acquisto di un'opzione di pagamento.

Rappresentazione JSON 
{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}
Campi
newToMerchant

boolean

Un'opzione di pagamento che può essere acquistata solo dagli utenti che non hanno mai effettuato acquisti presso lo stesso commerciante.
newToPaymentOption

boolean

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 l'elaboratore dei pagamenti, definita per ogni commerciante.

Rappresentazione JSON 
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
Campi
processor

enum (Processor)

Definisce il partner elaboratore dei pagamenti a cui si applica questa configurazione.
publicKey

string

Il codice utilizzato per identificare il commerciante presso l'elaboratore dei pagamenti.

Per Stripe, visita la pagina: https://stripe.com/docs/dashboard#api-keys Per Braintree, visita la pagina: https://articles.braintreepayments.com/control-panel/important-gateway-credentials
version

string

Il numero di versione dell'API inviato all'elaboratore dei pagamenti insieme alle richieste di pagamento.

Processore

Definisce un partner specifico elaboratore dei pagamenti.

Enum
PROCESSOR_UNSPECIFIED Non utilizzata
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, definita per ogni singolo commerciante.

Rappresentazione JSON 
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
Campi
tokenizationParameter

map (key: string, value: string)

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 saperne di più, consulta la documentazione di Google Pay.

Esempio di Braintree: tokenizationParameter { chiave: "gateway" value: "braintree" } tokenizationParameter { chiave: "braintree:apiVersion" valore: "v1" } tokenizationParameter { chiave: "braintree:sdkVersion" valore: "2.30.0" } tokenizationParameter { chiave: "braintree:merchantId" value: "abcdef" } tokenizationParameter { chiave: "braintree:clientKey" valore: "production_xxx_yyy" }

Esempio di Stripe: tokenizationParameter { chiave: "gateway" value: "striscia" } tokenizationParameter { chiave: "stripe:version" valore: "2018-02-28" } tokenizationParameter { chiave: "stripe:publishableKey" valore: "pk_1234" }

Esempio di Adyen: tokenizationParameter { chiave: "gateway" value: "adyen" } tokenizationParameter { chiave: "gatewayMerchantId" value: "yourId" }

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
billingInformationFormat

enum (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

Indirizzo di fatturazione da richiedere all'utente e da includere nel token. I valori 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, indirizzo, località, regione, codice paese e codice postale.

Termini

Un insieme di regole e linee guida che vengono mostrate all'utente per effettuare una prenotazione tramite Prenota con Google.

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

string

Facoltativamente, l'URL dei Termini e condizioni.
text

string

Il testo da mostrare all'utente. Utilizza localizedText di seguito per le nuove integrazioni.
localizedText

object (Text)

Il testo localizzato da mostrare all'utente.

MerchantMatchingHints

Suggerimenti utilizzati per aiutare Google ad abbinare un commerciante a un luogo su Google Maps.

Rappresentazione JSON 
{
  "placeId": 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, consulta la pagina https://developers.google.com/places/web-service/place-id.

ServiceAttribute

Gli attributi dei servizi sono categorie definite dai partner che descrivono i Servizi di un Commerciante. Ad esempio, una banca può definire un "Tipo di conto bancario" attributo di servizio con possibili valori di "Personale" e "Attività", mentre un parrucchiere può definire un "Tipo di servizio" attributo di servizio con possibili valori di "Taglio di capelli", "Colore" e "Stile".

Rappresentazione JSON 
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
Campi
attributeId

string

Un identificatore che identifica in modo univoco questo attributo di servizio tra gli altri per lo stesso commerciante, ad esempio "account-type".
attributeName

string

Un nome visibile all'utente per questo attributo, ad esempio "Tipo di account".
value[]

object (Value)

Tutti i valori possibili per questo attributo di servizio.

Valore

Rappresenta un valore possibile per un particolare attributo di servizio.

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

string

Un identificatore che identifica in modo univoco questo valore tra gli altri per l'attributo di servizio, ad esempio "personale".
valueName

string

Un nome visibile all'utente per il valore, ad esempio "Personale".

Consulenza

Avvisi che vengono mostrati all'utente quando prenota tramite Prenota con Google.

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

object (Text)

Messaggio personalizzato da mostrare all'utente prenotando tramite Prenota con Google.

Metodi

create

 Crea un nuovo Merchant gestito dall'aggregatore specificato e lo restituisce.

delete

 Elimina un Merchant esistente gestito dall'aggregatore specificato.

getStatus

 Ottieni MerchantStatus di Merchant.

patch

 Aggiorna un Merchant esistente gestito dall'aggregatore specificato e lo restituisce.