REST Resource: inventory.partners.merchants

Risorsa: commerciante

Informazioni su un commerciante 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

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

string

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

string

L'URL del sito web pubblico del commerciante.
geo

object (GeoCoordinates)

I dati geografici 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)

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

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

object (PaymentRestrictions)

Limitazioni relative ai metodi di pagamento accettati da questo commerciante. Se questo campo non viene impostato, non esistono limitazioni.
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 supporta questo servizio.
tokenizationConfig

object (TokenizationConfig)

Configurazione per un elaboratore dei pagamenti tokenizzato, se il commerciante supporta questo servizio.
terms

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

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 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?

  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: 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

object (MerchantMatchingHints)

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[]

object (ServiceAttribute)

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

object (Advisement)

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 (CreditCardRestrictions)
  }
}
Campi
creditCardRestrictions

object (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 (CreditCardType)
  ]
}
Campi
creditCardType[]

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

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 (aliquota fiscale) presente nel commerciante o nel servizio. Se visualizzi un messaggio vuoto (ad es. taxRate { }), l'aliquota fiscale applicata viene azzerata.
paymentOptionType

enum (PaymentOptionType)

Il tipo di questa opzione di pagamento. Monouso per i pacchetti, 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 maggiore di 1.
purchaseInterval

object (TimeRange)

L'opzione di pagamento può essere acquistata entro questo intervallo.
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. 30 giorni di abbonamento).

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

enum (ActivationType)

Definisce come viene determinata la data di inizio della validità di 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 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

boolean

Un'opzione di pagamento che può essere acquistata solo dagli utenti che non hanno mai effettuato acquisti dallo 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 un elaboratore dei pagamenti, impostata per il 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

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

string

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

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 (Text)
  }
}
Campi
url

string

Facoltativamente, l'URL dei Termini e condizioni.
text

string

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

object (Text)

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

string

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 (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 account".
value[]

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

string

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

string

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 (Text)
  }
}
Campi
text

object (Text)

Messaggio personalizzato da mostrare all'utente al momento della prenotazione tramite Prenota con Google.

Metodi

create

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

delete

 Elimina un elemento Merchant esistente gestito dall'aggregatore specificato.

getStatus

 Ottieni il MerchantStatus di un Merchant.

patch

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