REST Resource: inventory.partners.merchants

Ressource: Merchant

Informationen zu einem Händler, der sich auf der Plattform des Aggregators befindet

JSON-Darstellung 
{
  "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)
  }
}
Felder
name

string

Der Name der Händlerressource im Format partners/{partner_id}/merchants/{merchantId}.
merchantName

string

"merchantName", "telephone", "url" und "geo" werden verwendet, um Partnerinventar mit Händlern abzugleichen, die bereits in Google Maps vorhanden sind. Diese Informationen werden nicht angezeigt.

Der Name des Händlers.
telephone

string

Die öffentliche Telefonnummer des Händlers, einschließlich der Landesvorwahl und der Vorwahl, z.B. +14567891234.
url

string

Die URL der öffentlichen Website des Händlers.
geo

object (GeoCoordinates)

Die geografischen Informationen des Händlers, einschließlich Breitengrad, Längengrad und Adresse.
category

string

Die Kategorie des Unternehmens auf der Plattform des Aggregators.
numBookings30d
(deprecated)

string (int64 format)

Dieses Feld wurde eingestellt.
taxRateBasisPoints
(deprecated)

integer (uint32 format)

Der Steuersatz des Händlers in Basispunkten (ein Hundertstel Prozent). Beträgt der Steuersatz beispielsweise 7,5 %, muss das Feld auf 750 gesetzt werden.

Ist das Feld nicht konfiguriert oder auf 0 gesetzt, entspricht der Gesamtpreis, der einem Nutzer für eine von diesem Händler angebotene Dienstleistung berechnet wird, genau dem in "Service.price" angegebenen Preis. Es wird dann davon ausgegangen, dass der Preis der Dienstleistung von den anwendbaren Steuern befreit ist oder diese bereits darin enthalten sind. Steuern werden dem Nutzer nicht als separate Position angezeigt.

Wenn dieses Feld auf einen Wert ungleich null gesetzt ist, setzt sich der Gesamtpreis, der einem Nutzer für eine von diesem Händler angebotene Dienstleistung berechnet wird, aus dem Preis der Dienstleistung und der Steuer zusammen, die anhand des hier angegebenen Steuersatzes berechnet wird. Brüche der kleinsten Währungseinheit (z. B. Brüche eines Cents) werden auf die nächste Ganzzahl (z. B. den nächsten Cent) gerundet. Steuern werden dem Nutzer als separate Position angezeigt.

Dieses Feld wurde eingestellt. Bitte verwende stattdessen "taxRate".
taxRate

object (TaxRate)

Der Steuersatz des Händlers. Falls vorhanden, überschreibt dieses Feld das eingestellte Feld "taxRateBasisPoints". Bei einer leeren Nachricht (z. B. "taxRate { }") wird der angewendete Steuersatz auf null zurückgesetzt.
paymentRestrictions

object (PaymentRestrictions)

Einschränkungen für die von diesem Händler akzeptierten Zahlungsmethoden. Ist dieses Feld nicht festgelegt, wird davon ausgegangen, dass es keine Einschränkungen gibt.
paymentOption[]

object (PaymentOption)

Die Zahlungsoptionen, die für diesen Händler verfügbar sind. Die zulässigen Zahlungsoptionen für die einzelnen Dienstleistungen des Händlers können individuell eingeschränkt werden.
paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

Konfiguration für einen Abwickler tokenisierter Zahlungen, sofern der Händler das unterstützt
tokenizationConfig

object (TokenizationConfig)

Konfiguration für einen Abwickler tokenisierter Zahlungen, sofern der Händler das unterstützt
terms

object (Terms)

Die spezifischen Nutzungsbedingungen des Händlers, die der Nutzer sieht, wenn er eine Dienstleistung über "Mit Google reservieren" bucht. Die Nutzungsbedingungen des Aggregators werden dem Nutzer immer angezeigt. Sie dürfen hier nicht angegeben werden.
brandId

string

Ein nicht transparenter String, mit dem die Marke angegeben wird, die Nutzer sehen, wenn die Partner angezeigt werden. In diesem Feld können Partner mit mehreren kundenseitigen Marken Händler für alle Marken im selben Feed angeben.

Eine Marke besteht aus kundenseitigen Eigenschaften wie Name, Logo, Nutzungsbedingungen und Datenschutzerklärung.

Wenn es nur eine kundenseitige Partnermarke gibt, muss das Feld nicht festgelegt werden und kann ignoriert werden.

Wenn der Partner…

nicht mehrere kundenseitige Marken hat? --> Ignoriere das Feld.

mehrere Marken konfiguriert hat?

  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

Achtung: Die meisten Partner müssen dieses Feld nicht festlegen. Soll es verwendet werden, muss sich der Partner mit uns in Verbindung setzen, um separate Marken zu konfigurieren, einschließlich der Standardmarke.
matchingHints

object (MerchantMatchingHints)

Tipps für die Zuordnung eines Händlers zu einem Ort auf Google Maps. Hinweis: Die meisten Partner müssen dieses Feld nicht festlegen. Google ordnet die Händler anhand der Angaben oben Orten auf Google Maps zu. (optional)
serviceAttribute[]

object (ServiceAttribute)

Definitionen für Attribute, mit denen die Dienstleistungen dieses Händlers beschrieben werden (optional)
waitlistAdvisement

object (Advisement)

Optional. Allgemeine Ratschläge eines bestimmten Händlers für Nutzer, die sich über „Mit Google reservieren“ auf eine Warteliste setzen lassen. Einzelne Textfelder in den Hinweisen sollten auf 100 Byte beschränkt sein.

PaymentRestrictions

Einschränkungen für die von diesem Händler akzeptierten Zahlungsmethoden.

JSON-Darstellung 
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
Felder
creditCardRestrictions

object (CreditCardRestrictions)

Einschränkungen für die von diesem Händler akzeptierten Kreditkarten. Wenn dieses Feld nicht festgelegt ist, wird davon ausgegangen, dass alle Kreditkarten zulässig sind. Hinweis: Die Liste der Karten, die von "CreditCardType" unterstützt werden, wird im Laufe der Zeit erweitert. Wenn du das Feld leer lässt, werden also in Zukunft Änderungen erforderlich.

CreditCardRestrictions

Einschränkungen für die von diesem Händler akzeptierten Kreditkartentypen

JSON-Darstellung 
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
Felder
creditCardType[]

enum (CreditCardType)

Eine Liste der unterstützten Kreditkarten. Ist das Feld leer, werden keine Kreditkarten unterstützt.

CreditCardType

Ein Kreditkartentyp

Optionen
CREDIT_CARD_TYPE_UNSPECIFIED Nicht verwendet
VISA Visa-Kreditkarte
MASTERCARD Mastercard-Kreditkarte
AMERICAN_EXPRESS American Express-Kreditkarte
DISCOVER Discover-Kreditkarte
JCB JCB-Kreditkarte

PaymentOption

Eine Zahlungsoption, die zum Bezahlen von Dienstleistungen eines Händlers verwendet werden kann. Zahlungsoptionen können für mehrere Händler verwendet werden (z. B. Händler derselben Kette).

JSON-Darstellung 
{
  "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)
  }
}
Felder
paymentOptionId

string

Mit dieser ID wird die Zahlungsoption ermittelt.

Die ID gilt für den gesamten Aggregator. Wenn du einen Wert für mehrere Händler verwendest, können Nutzer mit der entsprechenden Zahlungsoption für Dienstleistungen all dieser Händler bezahlen.

Wird ein Wert für eine Zahlungsoption unter einem Händler aktualisiert, werden auch alle anderen Zahlungsoptionen mit derselben ID unter anderen Händlern aktualisiert. Daher sollten alle Zahlungsoptionen mit derselben ID immer auf identische Werte aktualisiert werden.
name

string

Der Name der Zahlungsoption. Er kann für den Nutzer sichtbar sein.
description

string

Eine Beschreibung der Zahlungsoption. Sie kann für den Nutzer sichtbar sein.
price

object (Price)

Der Preis der Zahlungsoption.
taxRate

object (TaxRate)

Der Steuersatz für diese Zahlungsoption. Falls vorhanden, überschreibt dieses Feld das Feld "taxRate" für den Händler oder die Dienstleistung. Bei einer leeren Nachricht (z. B. "taxRate { }") wird der angewendete Steuersatz auf null zurückgesetzt.
paymentOptionType

enum (PaymentOptionType)

Der Typ dieser Zahlungsoption. Einmalige Nutzung für Einmalbuchungen, Mehrfachnutzung für Pakete und unbegrenzt für Mitgliedschaften.
sessionCount

string (int64 format)

Die Anzahl der Sitzungen, für die die Zahlungsoption verwendet werden kann. Nur gültig für Mehrfachbuchungen/Pakete, bei denen der Wert größer als 1 sein sollte.
purchaseInterval

object (TimeRange)

Die Zahlungsmethode kann innerhalb dieses Zeitraums erworben werden.
validInterval

object (TimeRange)

Die Zahlungsoption kann innerhalb dieses Zeitraums verwendet werden (z. B. ein Sonderpreis für Januar 2017). Falls vorhanden, werden hierdurch "validDuration" und "activationType" überschrieben.
validDuration

string (Duration format)

Gültigkeitsdauer der Zahlungsoption (z. B. 30-Tage-Mitgliedschaft).

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
activationType

enum (ActivationType)

Legt fest, wie das Startdatum der Gültigkeit für diese Zahlungsoption ermittelt wird.
userRestriction

object (UserPurchaseRestriction)

Beschränkt die zum Kauf dieser Zahlungsoption berechtigten Nutzer. Kann verwendet werden, um eine Zahlungsoption auf eine Untergruppe von Nutzern zu beschränken. Wenn das Feld nicht festgelegt ist, sind alle Nutzer zum Kauf berechtigt.

PaymentOptionType

Art der Zahlungsoption

Enums
PAYMENT_OPTION_TYPE_UNSPECIFIED Nicht verwendet
PAYMENT_OPTION_SINGLE_USE Die Zahlungsoption kann nur einmal verwendet werden.
PAYMENT_OPTION_MULTI_USE Die Zahlungsoption kann verwendet werden, wenn die Anzahl der Sitzungen größer als 0 ist.
PAYMENT_OPTION_UNLIMITED Die Zahlungsoption kann innerhalb des gültigen Zeitraums verwendet werden. Anzahl der Sitzungen wird hier nicht unterstützt.

ActivationType

Definiert, wie das Startdatum der Gültigkeit ermittelt wird.

Enums
ACTIVATION_TYPE_UNSPECIFIED Nicht verwendet
ACTIVATION_ON_PURCHASE Die Gültigkeit beginnt mit dem Kauf.
ACTIVATION_ON_FIRST_USE Die Gültigkeit beginnt, wenn die Zahlungsoption zum ersten Mal verwendet wird.

UserPurchaseRestriction

Beschränkt die zum Kauf einer Zahlungsoption berechtigten Nutzer.

JSON-Darstellung 
{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}
Felder
newToMerchant

boolean

Eine Zahlungsoption, die nur von Nutzern erworben werden kann, die noch nie zuvor bei demselben Händler eingekauft haben.
newToPaymentOption

boolean

Eine Zahlungsoption, die nur von Nutzern erworben werden kann, die noch nie dieselbe Zahlungsoption erworben haben.

PaymentProcessorConfig

Eine Konfiguration für einen Zahlungsabwickler, die pro Händler eingerichtet wird.

JSON-Darstellung 
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
Felder
processor

enum (Processor)

Definiert den Zahlungsabwickler, für den diese Konfiguration gilt.
publicKey

string

Der Schlüssel, mit dem dieser Händler beim Zahlungsabwickler zugeordnet wird.

Informationen zu Stripe: https://stripe.com/docs/dashboard#api-keys Informationen zu Braintree: https://articles.braintreepayments.com/control-panel/important-gateway-credentials
version

string

Die API-Versionsnummer, die zusammen mit den Zahlungsanforderungen an den Zahlungsabwickler gesendet wird.

Processor

Definiert einen bestimmten Zahlungsabwickler

Enums
PROCESSOR_UNSPECIFIED Nicht verwendet
PROCESSOR_STRIPE Konfiguration für Zahlungen über Stripe
PROCESSOR_BRAINTREE Konfiguration für Zahlungen über Braintree

TokenizationConfig

Eine Konfiguration für die Tokenisierung des Zahlungsabwicklers, die pro Händler eingerichtet wird.

JSON-Darstellung 
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
Felder
tokenizationParameter

map (key: string, value: string)

Eine Tokenisierungskonfiguration hat in der Regel einen "tokenizationParameter". Sein Schlüssel ist "gateway" und sein Wert der Name des Abwicklers.

Die übrigen Parameter richten sich nach dem Abwickler. Weitere Informationen findest du in der Dokumentation zu Google Pay.

Beispiel für 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" }

Beispiel für Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Beispiel für Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
billingInformationFormat

enum (BillingInformationFormat)

Das Zahlungstoken muss die Zahlungsinformationen des Nutzers enthalten, die in Google Pay mit seinem Zahlungsmittel angegeben wurden (siehe oben). Bleibt das Feld leer, entspricht das der Angabe von MIN.

BillingInformationFormat

Der Teil der Rechnungsadresse, der vom Nutzer angefordert wird und im Token enthalten ist. Die Werte aus Optionen entsprechen Parametern in der Google Pay API (siehe https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters)).

Enums
BILLING_INFORMATION_FORMAT_UNSPECIFIED Nicht angegeben. Die Standardeinstellung ist MIN.
MIN Name, Ländercode und Postleitzahl (Google Pay-Standardeinstellung)
FULL Name, Adresse, Ort, Region, Ländercode und Postleitzahl.

Nutzungsbedingungen

Regeln und Richtlinien, die der Nutzer sieht, wenn er eine Buchung über "Mit Google reservieren" vornehmen möchte.

JSON-Darstellung 
{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}
Felder
url

string

Optional: die URL zu den Nutzungsbedingungen.
text

string

Der Text, den der Nutzer sieht. Für neue Integrationen muss "localizedText" (unten) verwendet werden.
localizedText

object (Text)

Der lokalisierte Text, der dem Nutzer angezeigt wird.

MerchantMatchingHints

Hinweise, damit Google einen Händler einem Ort in Google Maps zuordnen kann.

JSON-Darstellung 
{
  "placeId": string
}
Felder
placeId

string

Die Place ID für einen Ort in der Google Places-Datenbank und auf Google Maps. Weitere Informationen zu Orts-IDs finden Sie unter https://developers.google.com/places/web-service/place-id.

ServiceAttribute

Diese Attribute sind von Partnern definierte Kategorien, die die Dienstleistungen eines Händlers beschreiben. Beispielsweise kann eine Bank ein Dienstleistungsattribut "Kontotyp" mit den möglichen Werten "Privat" und "Geschäftlich" definieren, während ein Friseursalon ein Attribut "Art der Leistung" mit den möglichen Werten "Haarschnitt", "Farbe" oder "Styling" definieren kann.

JSON-Darstellung 
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
Felder
attributeId

string

Eine Kennung, die dieses Dienstleistungsattribut für denselben Händler unter anderen eindeutig identifiziert, z.B. „Kontotyp“.
attributeName

string

Ein für den Nutzer sichtbarer Name für dieses Attribut, z.B. „Kontotyp“.
value[]

object (Value)

Alle möglichen Werte für dieses Dienstleistungsattribut.

Wert

Stellt einen möglichen Wert für ein bestimmtes Dienstleistungsattribut dar.

JSON-Darstellung 
{
  "valueId": string,
  "valueName": string
}
Felder
valueId

string

Eine Kennung, die diesen Wert für dieses Dienstleistungsattribut unter anderen eindeutig identifiziert, z.B. „persönlich“.
valueName

string

Ein für den Nutzer sichtbarer Name für den Wert, z.B. „Persönlich“.

Beratung

Hinweise, die Nutzer sehen, wenn sie über „Mit Google reservieren“ buchen.

JSON-Darstellung 
{
  "text": {
    object (Text)
  }
}
Felder
text

object (Text)

Benutzerdefinierte Nachricht, die dem Nutzer bei der Buchung über „Mit Google reservieren“ angezeigt wird.

Methoden

create

 Erstellt einen neuen Händler (Merchant), der vom angegebenen Aggregator verwaltet wird, und gibt ihn zurück

delete

 Löscht einen vorhandenen Händler (Merchant), der vom angegebenen Aggregator verwaltet wird.

getStatus

 Rufen Sie den MerchantStatus von Merchant ab.

patch

 Aktualisiert einen vorhandenen Händler Merchant, der über den angegebenen Aggregator verwaltet wird, und gibt ihn zurück