REST Resource: inventory.partners.merchants

Risorsa: commerciante

Informazioni su un commerciante presente 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)
    }
  ],
  "reservationLinkoutTemplate": [
    {
      object (LinkoutTemplate)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}
Campi
name

string

Il nome risorsa del commerciante, nel formato partners/{partner_id}/merchants/{merchantId}.
merchantName

string

merchantName, telephone, url e geo 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 il prefisso internazionale e il prefisso, ad esempio +14567891234.
url

string

L'URL del sito web pubblico del commerciante.
geo

object (GeoCoordinates)

Le informazioni geografiche del commerciante, tra cui 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 punto percentuale). 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 da o già comprensivo delle imposte applicabili. Le tasse 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à valutaria più piccola (ad esempio, le frazioni di un centesimo) verranno arrotondate utilizzando l'arrotondamento al numero pari più vicino. Le imposte verranno mostrate all'utente come voce separata.

Questo campo è deprecato. Utilizza taxRate.
taxRate
(deprecated)

object (TaxRate)

L'aliquota fiscale del commerciante. Se presente, questo campo sostituisce il campo taxRateBasisPoints ritirato. Un messaggio vuoto (ad es. taxRate { }) reimposterà l'aliquota fiscale applicata su zero. Deprecato perché i pagamenti end-to-end non sono più supportati.
paymentRestrictions
(deprecated)

object (PaymentRestrictions)

Limitazioni ai metodi di pagamento accettati da questo commerciante. Se questo campo non è impostato, presumiamo che non esistano limitazioni. Deprecato perché i pagamenti end-to-end non sono più supportati.
paymentOption[]
(deprecated)

object (PaymentOption)

Opzioni di pagamento disponibili per questo commerciante. I servizi di questo commerciante potranno limitare individualmente le opzioni di pagamento che consentono. Deprecato perché i pagamenti end-to-end non sono più supportati.
paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

Configurazione per un elaboratore dei pagamenti con token, se il commerciante lo supporta.
tokenizationConfig
(deprecated)

object (TokenizationConfig)

Configurazione per un elaboratore dei pagamenti con token, se il commerciante lo supporta. Deprecato perché i pagamenti end-to-end non sono più supportati.
terms

object (Terms)

I Termini e condizioni specifici del commerciante visualizzati dall'utente quando viene prenotato un servizio 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 per visualizzare 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

Ha più brand configurati?

  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 deve impostare questo campo. Se un partner vuole utilizzare questo campo, deve prima contattarci per configurare brand separati, incluso il brand 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 deve impostare questo campo, in quanto Google abbinerà i commercianti ai luoghi su Google Maps utilizzando le informazioni fornite sopra. (facoltativo)
serviceAttribute[]

object (ServiceAttribute)

Definizioni di tutti gli attributi di servizio utilizzati per descrivere i Servizi per questo Commerciante. (facoltativo)
reservationLinkoutTemplate[]

object (LinkoutTemplate)

Facoltativo. Il modello di link esterno che specifica in che modo Google deve generare l'URL del partner per prenotare un tavolo sulla sua piattaforma.

Tieni presente che al momento verrà utilizzato solo il primo se ne vengono forniti più di uno.

Il modello di URI supporta i campi che verranno compilati in base alle selezioni di prenotazione dell'utente. Tutti i campi obbligatori sono necessari per creare correttamente un URL per prenotare: * (obbligatorio) partySize, int: il numero di persone per cui l'utente richiede una prenotazione. * (obbligatorio) selected_date_time, data e ora ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601): l'ora per cui l'utente richiede una prenotazione. * (facoltativo) merchantId, stringa: l'ID del commerciante con cui l'utente richiede una prenotazione, non necessario se il modello include già un identificativo commerciante. * (facoltativo) roomId, stringa: l'ID della camera per cui l'utente sta richiedendo una prenotazione.
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 dell'avviso devono essere limitati a 100 byte di lunghezza.
economicOperator

object (EconomicOperator)

Facoltativo. Informazioni sull'operatore economico associate a questo commerciante specifico necessarie per la conformità legale. (facoltativo)

PaymentRestrictions

Limitazioni ai metodi di pagamento accettati da questo commerciante.

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

object (CreditCardRestrictions)

Limitazioni alle carte di credito accettate da questo commerciante. Se questo campo non è impostato, presupponiamo che tutte le carte di credito siano accettate. Tieni presente che l'elenco delle carte supportate da CreditCardType aumenterà nel tempo, il che significa che se lasci questo campo vuoto, la configurazione sarà soggetta a modifiche future.

CreditCardRestrictions

Limitazioni ai tipi di carte di credito accettati da questo commerciante.

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

enum (CreditCardType)

Un elenco delle carte di credito supportate. Se è vuoto, non sono supportate carte di credito.

CreditCardType

Un tipo di carta di credito.

Enum
CREDIT_CARD_TYPE_UNSPECIFIED Non utilizzata.
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 in più commercianti consentirà a un utente di pagare con l'opzione di pagamento corrispondente in questi commercianti.

Quando riutilizzi un ID per più commercianti, l'aggiornamento di un valore per un'opzione di pagamento in un commerciante aggiornerà anche qualsiasi altra opzione di pagamento con lo stesso ID in un altro commerciante. Pertanto, è una best practice che tutte le opzioni di pagamento condividano lo stesso ID e vengano sempre aggiornate con valori identici, per evitare qualsiasi possibilità di comportamento indeterministico.
name

string

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

string

Una descrizione dell'opzione di pagamento. Questo 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 es. taxRate { }) reimposterà l'aliquota fiscale applicata su zero.
paymentOptionType

enum (PaymentOptionType)

Il tipo di questa opzione di pagamento. Uso singolo per le visite, uso multiplo per i pacchetti e illimitato per gli abbonamenti.
sessionCount

string (int64 format)

Per quante sessioni può essere utilizzata questa opzione di pagamento. Valido solo per sessioni multiple / pacchetti, dove il valore deve essere > 1.
purchaseInterval

object (TimeRange)

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

object (TimeRange)

L'opzione di pagamento può essere utilizzata in questo intervallo (ad es. prezzo speciale per gennaio 2017). Se presente, esegue l'override di validDuration e activationType.
validDuration

string (Duration format)

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

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à 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 utilizzata.
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 entro il suo 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 utilizzata.
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 da 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 l'hanno mai acquistata prima.

PaymentProcessorConfig

Una configurazione per un elaboratore dei pagamenti, impostata in base al singolo 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 la pagina https://stripe.com/docs/dashboard#api-keys. Per Braintree, consulta 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 per l'elaborazione dei pagamenti.

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 in genere ha un tokenizationParameter la cui chiave è "gateway" e il cui valore è il nome del processore.

Il resto dei parametri dipende 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:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

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 coppie "key": value. 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 il suo metodo di pagamento (vedi sopra). Lasciare vuoto il campo equivale a specificare MIN.

BillingInformationFormat

La quantità di indirizzo di fatturazione da richiedere all'utente e includere nel token. I valori enum corrispondono ai parametri dell'API Google Pay (vedi 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à, provincia, codice paese e codice postale.

Termini

Un insieme di regole e linee guida visualizzate dall'utente per effettuare una prenotazione tramite Prenota con Google.

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

string

(Facoltativo) 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 per un luogo nel database di Google Places e su Google Maps. Per saperne di più sugli ID luogo, visita la pagina https://developers.google.com/places/web-service/place-id.

ServiceAttribute

Gli attributi del servizio sono categorie definite dal partner che descrivono i servizi per un commerciante. Ad esempio, una banca può definire un attributo di servizio "Tipo di conto" con i valori possibili "Personale" e "Aziendale", mentre un parrucchiere può definire un attributo di servizio "Tipo di servizio" con i valori possibili "Taglio di capelli", "Colore" e "Acconciatura".

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 del servizio.

Valore

Rappresenta un valore possibile per un determinato 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 di servizio, ad esempio "personale".
valueName

string

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

LinkoutTemplate

Un modello che specifica in che modo Google deve generare gli URL di un sito partner.

Rappresentazione JSON 
{
  "uriTemplate": string
}
Campi
uriTemplate

string

Il modello di URI deve rispettare il documento RFC 6570, vedi https://datatracker.ietf.org/doc/html/rfc6570. Supporta i modelli di livello 1 e tutti i modelli compositi di livello 4. Ad es. http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

Consulenza

Avvisi visualizzati dall'utente quando prenota tramite Prenota con Google.

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

object (Text)

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

EconomicOperator

Informazioni sull'operatore economico per l'aggregatore.

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

object (Text)

Obbligatorio. Nome, indirizzo, numero di telefono e indirizzo email dell'operatore economico, definito come produttore, rappresentante autorizzato, importatore, distributore, fornitore di servizi di evasione o qualsiasi altra persona fisica o giuridica soggetta a obblighi relativi alla fabbricazione, alla messa a disposizione o alla messa in servizio dei prodotti. Rappresentazione della stringa in formato libero di economicOperator. Queste informazioni possono essere formattate utilizzando " " e "\n".

Metodi

create

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

delete

 Elimina un Merchant esistente gestito dall'aggregatore specificato.

getStatus

 Ottieni il MerchantStatus di un Merchant.

patch

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