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

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

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.

string

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

string

Die URL der öffentlichen Website des Händlers.

object (GeoCoordinates)

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

string

Die Kategorie des Unternehmens auf der Plattform des Aggregators.

string (int64 format)

Dieses Feld wurde eingestellt.

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

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.

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.

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.

object (PaymentProcessorConfig)

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

object (TokenizationConfig)

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

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.

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.

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)

object (ServiceAttribute)

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

object (ActionLink)

Optional. Eine Aktions-URL mit zugehöriger Sprache, Liste der Länder, auf die sie eingeschränkt ist, Typ und optionaler Plattform, die angibt, auf welcher Plattform die Aktion ausgeführt werden soll

object (Advisement)

Optional. Allgemeine Hinweise eines bestimmten Händlers für einen Nutzer, der sich über „Mit Google reservieren“ auf eine Warteliste setzt. Die einzelnen Textfelder in der Mitteilung sollten auf 100 Byte begrenzt sein.

object (EconomicOperator)

Optional. Informationen zum Wirtschaftstreibenden, die mit diesem Händler verknüpft sind und für die Einhaltung der gesetzlichen Bestimmungen erforderlich sind. (optional)

{
  "creditCardRestrictions": {
    object (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.

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

enum (CreditCardType)

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

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

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.

string

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

string

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

object (Price)

Der Preis der Zahlungsoption.

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.

enum (PaymentOptionType)

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

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.

object (TimeRange)

Die Zahlungsoption ist innerhalb dieses Zeitraums verfügbar.

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.

string (Duration format)

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

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

enum (ActivationType)

Definiert, wie das Startdatum der Gültigkeit dieser Zahlungsoption bestimmt wird.

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.

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

boolean

Eine Zahlungsoption, die nur von Nutzern erworben werden kann, die noch nie bei dem entsprechenden Händler gekauft haben.

boolean

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

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

enum (Processor)

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

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

string

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

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

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

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.

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

string

Optional: Die URL zu den Nutzungsbedingungen.

string

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

object (Text)

Der lokalisierte Text, der dem Nutzer angezeigt wird.

{
  "placeId": string
}

string

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

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

string

Eine Kennung, mit der dieses Dienstleistungsattribut für einen Händler von anderen unterschieden wird, z.B. „Kontotyp“.

string

Ein für den Nutzer sichtbarer Name für das Attribut, z.B. „Kontotyp“.

object (Value)

Alle möglichen Werte für dieses Dienstleistungsattribut.

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

string

Eine Kennung, mit der dieser Wert für dieses Dienstleistungsattribut eindeutig identifiziert wird, z.B. „privat“.

string

Ein für den Nutzer sichtbarer Name für den Wert, z.B. „Privat“.

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

object (Text)

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

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

object (Text)

Erforderlich. Name, Adresse, Telefonnummer und E-Mail-Adresse des Wirtschaftsbeteiligten, definiert als Hersteller, bevollmächtigter Vertreter, Importeur, Händler, Auftragsverarbeiter oder jede andere natürliche oder juristische Person, die Verpflichtungen im Zusammenhang mit der Herstellung, Bereitstellung oder Inbetriebnahme von Produkten unterliegt. Beliebige Stringdarstellung des economicOperator. Diese Informationen können mit „"“ und „\n“ formatiert werden.