REST Resource: inventory.partners.merchants

{
  "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)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}

string

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

string

merchantName, telephone, url e geo vengono utilizzati per supportare la corrispondenza dell'inventario del partner con i commercianti già presenti su Google Maps. Queste informazioni non verranno visualizzate.

Il nome del commerciante.

string

Il numero di telefono pubblico del commerciante, inclusi i codici paese e di area, ad esempio +14567891234.

string

L'URL del sito web pubblico del commerciante.

object (GeoCoordinates)

Le informazioni geografiche del commerciante, tra cui latitudine, longitudine e indirizzo.

string

La categoria dell'attività nella piattaforma dell'aggregatore.

string (int64 format)

Campo obsoleto.

integer (uint32 format)

L'aliquota fiscale del commerciante in punti base (un centesimo di un 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 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 valutata 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 al numero pari più vicino. Le imposte verranno mostrate all'utente come voce separata.

Questo campo è deprecato. Utilizza taxRate.

object (TaxRate)

L'aliquota fiscale del commerciante. Se presente, questo campo sostituisce il campo taxRateBasisPoints ritirato. Un messaggio vuoto (ad es. taxRate { }) reimposta l'aliquota fiscale applicata su zero.

object (PaymentRestrictions)

Limitazioni relative ai metodi di pagamento accettati da questo commerciante. Se questo campo non è impostato, si presume che non esistano restrizioni.

object (PaymentOption)

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

object (PaymentProcessorConfig)

Configurazione per un elaboratore dei pagamenti con token, se il commerciante lo supporta.

object (TokenizationConfig)

Configurazione per un elaboratore dei pagamenti con token, se il commerciante lo supporta.

object (Terms)

I Termini e condizioni del commerciante specifico mostrati all'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.

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 i commercianti per tutti i brand nello 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 esiste 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 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 quello predefinito.

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 assocerà i commercianti ai luoghi su Google Maps utilizzando le informazioni fornite sopra. (facoltativo)

object (ServiceAttribute)

Definizioni di eventuali attributi dei servizi utilizzati per descrivere i servizi per questo commerciante. (facoltativo)

object (ActionLink)

Facoltativo. Un URL azione con lingua associata, elenco di paesi soggetti a limitazioni, tipo e piattaforma facoltativa che indica su quale piattaforma deve essere eseguita questa azione.

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 nell'avviso devono avere una lunghezza massima di 100 byte.

object (EconomicOperator)

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

{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}

object (CreditCardRestrictions)

Limitazioni relative alle carte di credito accettate da questo commerciante. Se questo campo non è impostato, si presume 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 vuoto questo campo, la configurazione sarà soggetta a modifiche future.

{
  "creditCardType": [
    enum (CreditCardType)
  ]
}

enum (CreditCardType)

Un elenco di carte di credito supportate. Se non sono presenti, non sono supportate carte di credito.

{
  "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)
  }
}

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 tutti i commercianti.

Quando riutilizzi un ID per accedere a più commercianti, l'aggiornamento di un valore per un'opzione di pagamento per un commerciante aggiorna anche qualsiasi altra opzione di pagamento con lo stesso ID per un altro commerciante. Pertanto, è buona norma che tutte le opzioni di pagamento condividano lo stesso ID e vengano sempre aggiornate con valori identici per evitare qualsiasi possibilità di comportamento fraudolento.

string

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

string

Una descrizione dell'opzione di pagamento. Questo può essere visibile all'utente.

object (Price)

Il prezzo dell'opzione di pagamento.

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 { }) reimposta l'aliquota fiscale applicata su zero.

enum (PaymentOptionType)

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

string (int64 format)

Il numero di sessioni per le quali è possibile utilizzare questa opzione di pagamento. Valido solo per pacchetti / sessioni multiple, in cui il valore deve essere > 1.

object (TimeRange)

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

object (TimeRange)

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

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

enum (ActivationType)

Definisce in che modo viene determinata la data di inizio della validità per questa opzione di pagamento.

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 impostato, tutti gli utenti sono idonei.

{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}

boolean

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

boolean

Un'opzione di pagamento che può essere acquistata solo dagli utenti che non hanno mai acquistato la stessa opzione di pagamento.

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

enum (Processor)

Definisce il partner di elaborazione dei pagamenti a cui si applica questa configurazione.

string

La chiave utilizzata per identificare questo commerciante con 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

string

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

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

map (key: string, value: string)

Una configurazione di tokenizzazione avrà in genere un parametro tokenizationParameter la cui chiave è "gateway" e il cui valore è il nome dell'elaboratore.

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 di 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" }.

enum (BillingInformationFormat)

Includi nel token di pagamento i dati di fatturazione dell'utente inseriti in Google Pay con il suo flusso di pagamento (vedi sopra). Lasciare vuoto il campo equivale a specificare MIN.

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

string

Facoltativamente, l'URL dei Termini e condizioni.

string

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

object (Text)

Il testo localizzato da mostrare all'utente.

{
  "placeId": string
}

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.

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

string

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

string

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

object (Value)

Tutti i valori possibili per questo attributo del servizio.

{
  "valueId": string,
  "valueName": string
}

string

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

string

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

{
  "text": {
    object (Text)
  }
}

object (Text)

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

{
  "text": {
    object (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 degli ordini o qualsiasi altra persona fisica o giuridica soggetta a obblighi relativi alla produzione di prodotti, alla loro messa a disposizione o alla loro messa in servizio. Rappresentazione in stringa libera di economicOperator. Queste informazioni possono essere formattate utilizzando " " e "\n".