End-to-End-Support für Google Kalender

FAQ

Im Folgenden finden Sie häufig gestellte Fragen unserer Partner und die entsprechenden Lösungen.

Feeds

Können Partner Händler mit mehreren Standorten angeben?
Ja, das ist möglich. Dazu müssen sie jeden Standort einzeln im Merchant-Feed hinzufügen.
Können sich Slots überschneiden?
Ja, Slots können sich überschneiden. Intervalle zwischen den Slots müssen nämlich nicht gleich lang sein. Sie können viel kürzer als die Dauer der Dienstleistung sein. So kannst du die Geschäftslogik selbst handhaben. Beispielsweise kann es für eine Dienstleistung einen Slot von 9:00 bis 10:00 Uhr und einen anderen von 9:15 bis 10:15 Uhr geben.
Können Ausnahmezeiten bei Wiederholungen, die direkt nebeneinander liegen, zusammengezogen werden?
Ja, das ist möglich.
Was sieht der Nutzer, wenn "min_advance_online_canceling" konfiguriert ist, und was sieht er, wenn es nicht konfiguriert ist?

Je nach Wert von „min_advance_online_canceling“ werden dem Nutzer die folgenden Meldungen angezeigt:

  • Wenn eine bestimmte Zeit festgelegt ist: „Wenn du eine Buchung vorgenommen hast und den Termin nicht wahrnehmen kannst, storniere bitte die Buchung <min_advance_online_canceling> vorher.“
  • Wenn nicht festgelegt: „Wenn du die Buchung zurücknehmen möchtest oder den Termin nicht einhalten kannst, ruf bitte <merchant> unter <phone number> an, um dich nach den Erstattungs- und Stornierungsbedingungen zu erkundigen.“

Buchungsserver

Sollten Partner die Buchungs-ID generieren, wenn eine neue Buchung in der Create Booking API aufgerufen wird?
Ja, du generierst die Buchungs-ID selbst. Wir behandeln sie als nicht transparente Kennung.

Echtzeitaktualisierungen von Buchungen

Wenn ein Nutzer den Beginn, die Dauer oder die Dienstleistungen einer Buchung ändert, werden diese Änderungen dann durch den Verfügbarkeitsfeed eingeschränkt?
Ja. Beispielsweise kann ein Nutzer die Startzeit einer Buchung, die für 10:00 Uhr vorgenommen wurde, nicht zu 10:05 Uhr ändern. Im Verfügbarkeitsfeed sind nämlich keine freien Slots (Zeitblöcke) vorhanden.
Wenn ein Partner einen Händler oder eine Dienstleistung löscht, werden dadurch auch alle zugehörigen Dienstleistungen und verfügbaren Slots gelöscht?
Ja, wenn ein Partner einen Händler oder eine Dienstleistung löscht, werden alle untergeordneten Ebenen automatisch in unserem System deaktiviert.
Enthält die UpdateBookingRequest-Buchung die gesamte Buchung aus CreateBookingResponse oder nur aktualisierte Felder?
Beides. Sie enthält eine Maske mit den aktualisierten Feldern sowie die komplette Buchung aus CreateBookingResponse. Wird eine Buchung storniert, enthält das Buchungsobjekt FieldMask Path="status" beispielsweise nur Booking.status = 'BookingStatus.Canceled'.

Zahlungen

Wann kann Google meinen bevorzugten Zahlungsabwickler unterstützen?
Eine aktuelle Liste der unterstützten Zahlungsabwickler findest du auf der Google Pay-Website.
Kann ein Unternehmen für einen bestimmten verfügbaren Slot für jeden Mitarbeiter, der dieselbe Dienstleistung erbringt, einen anderen Preis festlegen?
Ja, du kannst einen Preis pro Mitarbeiter und pro verfügbarem Slot für eine Dienstleistung festlegen, wenn du im Händlerfeed mehrere Zahlungsoptionen angibst. Weitere Informationen zu den genauen Feldern, mit denen eine payment_option definiert wird, findest du in der PaymentOption-Nachricht.
Gibt es Abhängigkeiten zwischen Vorauszahlungen, Anzahlungen und Gebühren bei Nichterscheinen?
Es gibt keine Abhängigkeiten zwischen Vorauszahlungen, Anzahlungen und Gebühren bei Nichterscheinen, die im Dienstleistungsfeed festgelegt sind. Anzahlungen und Gebühren bei Nichterscheinen sind gültig, auch wenn du Vorauszahlungen nicht aktivierst. Damit die drei Optionen richtig funktionieren, musst du die Zahlungsintegration abschließen.
Wie werden Nutzern die Steuergebühren angezeigt?
Wenn ein Steuersatz festgelegt ist und eine Onlinezahlung erforderlich ist, werden die Steuergebühren separat von den Servicekosten ausgewiesen. Sie sind im Gesamtpreis enthalten, der dem Nutzer angezeigt wird.

Sandbox-Umgebungen

Wie greife ich auf die Links zum Sandbox-Frontend zu?
Auf Sandbox-Links kannst du über die Seite Partner-Portal > Inventar zugreifen.
Gibt es eine Sandbox-Umgebung, in der Partner ihre Daten sehen und zum Testen verwenden können?
Ja, es gibt eine Sandbox-Umgebung, in der End-to-End-Integrationstests durchgeführt werden können. Weitere Informationen findest du in unserem Leitfaden für End-to-End-Tests.
Gibt es eine Version der API, die auf die Sandbox-Umgebung zugreift?
Ja, aktiviere die Maps Booking API (Entwicklerversion) in deinem Google Cloud-Projekt. Sie ist nur für Nutzer des Partner-Portals zugänglich, denen automatisch Zugriff gewährt wird. Nach der Aktivierung musst du lediglich den Endpunkt deiner API-Aufrufe zu https://partnerdev-mapsbooking.googleapis.com/ ändern.
Was ist der Unterschied zwischen Sandbox und Produktion?

Die Sandbox-Umgebung ist eine unabhängige Umgebung, in der Sie Änderungen testen können, ohne dass sich dies auf Ihre Produktionssysteme auswirkt. Das Steuerfeld für Aktionen bietet die folgenden Elemente der Sandbox-Umgebung:

Wenn alle Komponenten der Sandbox-Umgebung mit einer nicht produktionsnahen Umgebung in Ihren Systemen verbunden sind (z.B. einer Entwicklungs- oder Staging-Umgebung), können Sie eine Produktionsumgebung vollständig simulieren, ohne Ihre Produktionssysteme zu beeinträchtigen. Beachten Sie die folgenden Einschränkungen:

  1. Verbinden Sie Ihre Staging- oder Testfeeds, Ihren Buchungsserver und Ihre Echtzeitaktualisierungs-APIs mit der Sandbox-Umgebung.
  2. Stellen Sie in Ihrer Sandbox-Umgebung einen Teil des Inventars aus der echten Welt bereit, um damit zu testen. So werden alle Grenzfälle mit Ihrem Inventar abgedeckt.
  3. Ein Buchungsserver in der Sandbox darf niemals Buchungsanfragen oder ‑aktualisierungen für Liveinventar ausführen. Weisen Sie die Sandbox-Umgebung stattdessen auf Ihre Staging- oder Testumgebung hin.
  4. Asynchrone Buchungen sollten über die Sandbox-Version Ihrer Händlertools verwaltet werden, um Buchungen zu akzeptieren oder abzulehnen. So können Sie die Echtzeitaktualisierung von BookingNotification in der Sandbox testen.

Partner-Portal

Inventaransicht

Warum werden nach dem Anwenden von Filtern keine Ergebnisse angezeigt?
Prüfen Sie, ob in den Filterwerten Tippfehler enthalten sind (z.B. nachgestellte Leerzeichen). Wenn das Inventar aus den Feeds gelöscht wird, wird es nur dann in den Suchergebnissen angezeigt, wenn der Filter „Integrationsstatus = Deleted“ explizit festgelegt ist.
Wie sortiere ich nach Inventarstatus?
Wenn Sie einen Inventarstatusfilter hinzufügen möchten, fügen Sie zuerst einen Filter für den Integrationstyp hinzu. Legen Sie beispielsweise den Filter für den Integrationstyp auf E2E (End-to-End-Integration) und dann den Filter für den Inventarstatus auf Live fest. Weitere Informationen zum Festlegen von Filtern findest du unter [here]/actions-center/partner-portal/inventory#applying_filters.

Terminologie

Die folgenden Begriffe werden auf der Website verwendet.

Termine

Wird synonym mit Buchungen verwendet. Ein Nutzer bucht oder vereinbart einen Termin für einen bestimmten Zeitraum.

Buchungen

Eine Buchung ist die Verknüpfung eines von einem Händler angebotenen Dienstes mit einem bestimmten Zeitraum. Ein Google-Nutzer kann eine Buchung erstellen. Ein Dienstleistungsangebot kann beispielsweise ein Fitnesskurs oder ein Haarschnitt sein.

inventory

Die Händler, Dienste und Slots, die Sie an das Actions Center senden.

Leasingverträge

Das Steuerfeld für Aktionen fordert eine Lizenz an, nachdem ein Nutzer einen bestimmten Slot ausgewählt hat. Durch die Reservierung wird der Zeitblock reserviert, sodass kein anderer Nutzer diesen Termin buchen kann, bis die Reservierung abgelaufen ist oder die Buchung abgeschlossen wurde. In Version 2 der API sind Leases optional. Wir empfehlen stattdessen die Verwendung von „CheckAvailabilty“.

Reservierungen

Eine Reservierung ist eine vorläufige Buchung. Sie gilt insbesondere für Restaurants.

Dienste

Die Dienstleistungen werden von Händlern angeboten. Ein bestimmter Servicezeitblock kann von einem Google-Nutzer gebucht werden.

Slots

Ein Slot ist eine bestimmte Instanz eines Dienstes, der zur Buchung verfügbar ist. Es kann mehrere Zeitfenster für jeden Tag geben und sie können sich überschneiden.

Planungspartner

Ein Planungspartner sendet Inventardaten an Google. Wir senden Ihnen Nutzerdaten, wenn ein Nutzer eine Buchung vornimmt und Sie die Buchung ausführen.

Redaktionelle Richtlinien für Inhalte

Bei der Angabe von Dienstnamen und ‑beschreibungen sollten Ihre Einreichungen drei Prinzipien folgen:

  • Seien Sie ehrlich und sachlich.
  • Beschreiben Sie den Dienst klar und präzise.
  • Geben Sie relevante und vollständige Informationen zu Händlerdiensten mit Attributen an.

Beachten Sie außerdem Folgendes:

  • Verwenden Sie die Standardschreibweise und -grammatik.
  • Vermeiden Sie wiederholte und unnötige Satzzeichen, Großschreibung oder Symbole. Verwenden Sie in den Titeln Ihrer Dienstleistungen keine Ausrufezeichen. Die Verwendung von Symbolen, Zahlen und Buchstaben sollte der tatsächlichen Bedeutung des jeweiligen Symbols entsprechen.
  • Vermeiden Sie Wiederholungen. Sie dürfen keine übermäßig vielen, sich wiederholenden oder irrelevanten Keywords posten.
  • Verwenden Sie keine anstößigen oder unangemessenen Ausdrücke.
  • Geben Sie um das Beschreibungsfeld keine doppelten Anführungszeichen ein.
  • Fügen Sie keine überflüssigen Zeichen ein, z.B. Sternchen, die nicht auf eine Fußnote verweisen. Wenn Sie eine Fußnote oder einen Haftungsausschluss einfügen möchten, geben Sie den Text als letzte Zeile in das Attribut ein.
  • Geben Sie in Ihren Diensten relevante Informationen zu den Varianten an, damit Kunden sie unterscheiden können.
  • Vermeiden Sie in einem Feld falsch geschriebene oder falsch gesetzte Texte.

Partner-Portal-Benachrichtigungen

Auf dieser Seite finden Sie weitere Informationen zu Benachrichtigungen im Partner-Portal. In jedem Abschnitt finden Sie Links zu den entsprechenden nächsten Schritten für Ihr Problem.

Fehlende Verfügbarkeit bei Händlern

Ein Händler muss mindestens eine zukünftige Verfügbarkeit im Verfügbarkeitsfeed haben. Wenn der Händler im Verfügbarkeitsfeed keine zukünftige Verfügbarkeit hat, kann er nicht im Actions Center veröffentlicht werden. Eine vollständige Liste dieser Händler findest du im Partner-Portal auf dem Dashboard Inventory Details (Inventardetails) in der Tabelle „Merchants Missing Future Availability“ (Händler ohne zukünftige Verfügbarkeit). Diese Tabelle wird alle zwei Stunden aktualisiert.

Fehlende Dienste für Händler

Ein Händler muss mindestens einen Dienst im Dienstleistungsfeed haben. Wenn der Händler mindestens einen Dienst im Services-Feed hat, kann er im Actions Center live sein. Eine vollständige Liste dieser Händler findest du im Partner-Portal auf dem Dashboard Inventardetails in der Tabelle „Händler ohne Dienstleistungen“. Diese Tabelle wird alle zwei Stunden aktualisiert.

Händler in einem nicht unterstützten Land

Der Händler muss sich in einem Land befinden, das von Ihrer Implementierung unterstützt wird. Wenn das Land des Händlers nicht vom Actions Center unterstützt wird oder Ihre Implementierung dieses Land nicht unterstützt, kann der Händler nicht im Actions Center live geschaltet werden. Eine vollständige Liste der Händler nach Land findest du im Partner-Portal auf dem Dashboard Live-Händler in der Tabelle „Gesamtzahl der Live-Händler nach Land“. Diese Tabelle wird alle zwei Stunden aktualisiert. Öffnen Sie im Partner-Portal eine Anfrage, um zu sehen, in welchen Ländern Ihre Implementierung derzeit unterstützt wird oder welche Händler aufgrund ihres Landes nicht aktiv sind.

Händler ohne vollständige Adresse

Damit ein Händler im Actions Center angezeigt werden kann, muss er einem Eintrag auf Google Maps zugeordnet werden. Die Adresse eines Händlers ist ein wichtiger Faktor dafür, wie Google erkennt, welcher Händler zu welchem Google Maps-Eintrag gehört. Wir empfehlen Ihnen, regelmäßig die Tabelle „Händler ohne vollständige Adresse“ im Partner-Portal aufzurufen, um eine vollständige Liste der Händler ohne vollständige Adresse zu sehen. Diese Händler sind im Actions Center nicht aktiv. Die Tabelle wird alle zwei Stunden aktualisiert.

Händler ohne Telefonnummer

Damit ein Händler im Actions Center angezeigt werden kann, muss er einem Eintrag auf Google Maps zugeordnet werden. Die Telefonnummer eines Händlers ist ein entscheidender Faktor dafür, wie Google erkennt, welcher Händler zu welchem Google Maps-Eintrag gehört. Wir empfehlen Ihnen dringend, die Telefonnummer anzugeben, damit Google Ihre Händler automatisch einem Google Maps-Eintrag zuordnen kann. Das richtige Format der Telefonnummer finden Sie im Merchants-Feed.

Dienste ohne Preis

Für einen Dienst, der mit zusätzlichen Kosten verbunden ist, muss ein gültiger Preis angegeben werden. Wenn der Preis des Dienstes nicht gültig ist oder 0, 00 € beträgt, kann der Dienst nicht im Actions Center veröffentlicht werden. Eine vollständige Liste dieser Dienste findest du im Partner-Portal auf dem Dashboard Inventory Details (Inventardetails) in der Tabelle „Services Without Prices“ (Dienste ohne Preise). Diese Tabelle wird alle zwei Stunden aktualisiert.

Dienste ohne Beschreibung

Ein Dienst muss eine gültige Beschreibung enthalten. Wenn die Beschreibung des Dienstes fehlt, empfehlen wir Ihnen dringend, eine hinzuzufügen. So erhalten Nutzer wichtige Details, die sie wissen müssen, um eine Buchung vorzunehmen. Öffne eine Anfrage im Partnerportal, um eine Liste der Dienste zu erhalten, die keine Beschreibung haben.

Hilfe

Hier finden Sie eine Anleitung, wie Sie Hilfe erhalten.

Neue Partner

Wenn Sie das Actions Center in Ihre App einbinden möchten, füllen Sie bitte dieses Formular aus.

Bestehende Partner

Anfrage oder Beschwerde einreichen

Wenn Sie bereits Partner des Actions Centers sind und eine Frage oder Beschwerde haben, können Sie im Partner-Portal eine neue Anfrage erstellen, um uns zu kontaktieren. Im Partnerportal können Sie über die Seite Hilfe und Support > Supportanfragen auf Ihren Fallverlauf zugreifen. Wenn Sie einen neuen Fall erstellen möchten, füllen Sie das Feld „Wie können wir Ihnen behilflich sein?“ aus und klicken Sie auf „Starten“, um das Formular für den neuen Fall aufzurufen.

Wenn Sie eine neue Anfrage erstellen, werden Ihnen einige Fragen gestellt, anhand derer wir Ihnen besser helfen können. Bitte beantworten Sie die folgenden Fragen so gut wie möglich.

Nachdem Sie eine Anfrage erstellt haben, können Sie sie über Ihren Posteingang oder das Partner-Portal aufrufen und beantworten. Sie erhalten eine E-Mail, sobald es Neuigkeiten zu Ihrem Fall gibt. Wenn ein Fall geschlossen wurde, können Sie nicht mehr darauf antworten. Bei weiteren Fragen müssen Sie einen neuen Fall eröffnen.

Alle Nutzer, denen Sie Zugriff auf Ihr Partner-Portal-Konto gewähren (wie Sie den Zugriff verwalten, erfahren Sie im Leitfaden zu Konten und Nutzern), können alle bisherigen Fälle sehen und auf alle offenen Fälle im Partner-Portal antworten. Jeder Fall hat eine Fallnummer, auf die Sie jederzeit Bezug nehmen können. Außerdem kann unseren E-Mails eine Referenz-ID zugewiesen sein. Geben Sie diese Referenz-ID oder andere Kennungen (z. B. eine Händler-ID) an, die für den Fall relevant sind.

Supportanfrage nachverfolgen

Wenn eine von Ihnen eingereichte Anfrage geschlossen wurde und Sie weitere Fragen dazu haben, können Sie sie über die Schaltfläche „Weitere Fragen zu einer Anfrage stellen“ wieder öffnen. Diese Schaltfläche befindet sich oben in der geschlossenen Anfrage, wenn Sie sie in der Partner Portal-Hilfe und auf der Seite Support > Anfragen aufrufen.

Ihre Anschlussanfrage wird im Partner-Portal als neue Anfrage angezeigt, nachdem Sie auf „Senden“ geklickt haben.

Anforderung von Geschäftsdaten

Wenn Sie Geschäftsdaten anfordern möchten, die noch nicht über die Berichte im Center für Aktionen verfügbar sind, kontaktieren Sie uns bitte über das Antragsformular für den Zugriff auf Geschäftsdaten.