Onlinedienste sind Dienste, die vollständig online über eine gehostete Plattform gehalten werden und bei denen Kunden nicht persönlich teilnehmen müssen. Hier einige Beispiele für Onlinedienste:
- Online-Yogakurs mit Zoom
- Online-Make-up-Meisterkurs über Google Meet
- Online-Kostenvoranschläge per Klempner per Skype
Teilnahmevoraussetzungen für Onlinedienste
Bevor Sie mit der Implementierung beginnen, lesen Sie die Richtlinien und Best Practices für Onlinedienste.
Implementierung von Onlinediensten
Eine Onlinedienst-Einbindung ist ein Add-on für die bestehende End-to-End-Einbindung und erfordert einige Änderungen an einer vorhandenen Implementierung. Im Folgenden sehen Sie die allgemeinen Änderungen:
- Feeds: Füge den Dienstleistungsfeeds
type,VirtualSession,DirectMerchantPaymentundCancellationPolicy(falls noch nicht hinzugefügt) hinzu. - Buchungsserver: Füge VirtualSessionInfo der Methode „CreateBooking“ hinzu und versende E-Mails mit Informationen zur virtuellen Einrichtung an den Nutzer
- Echtzeitaktualisierungen (vorhandenes Verhalten): Änderungen an virtuellem Inventar über die Inventaraktualisierungs-RTU, Änderungen an der Buchung über die Echtzeitaktualisierung von BookingNotification und Änderungen am Dienst über die Echtzeitaktualisierung für Dienste
Feeds
Dienstleistungsfeed
Die folgenden Felder werden dem Dienstleistungsfeed hinzugefügt, um Onlinedienste zu unterstützen.
Spezifikationen des Dienstleistungsfeeds
enum ServiceType {
SERVICE_TYPE_UNSPECIFIED = 0;
// Service that provides dining reservation.
SERVICE_TYPE_DINING_RESERVATION = 1;
// Service that provides food ordering in general, could be either takeout
// or delivery or both.
SERVICE_TYPE_FOOD_ORDERING = 2;
// Service that only provides food delivery.
SERVICE_TYPE_FOOD_DELIVERY = 6;
// Service that only provides food takeout.
SERVICE_TYPE_FOOD_TAKEOUT = 7;
// Service that provides appointments or classes. Recommended for (1) health
// and fitness, (2) spa and beauty, and (3) financial consults and
// evaluations services. Please see the supported service types:
// https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_APPOINTMENT = 5;
// Service that provides appointment for an online class or session which
// will be fully virtual. Must be set if enabling virtual service bookings.
SERVICE_TYPE_ONLINE_APPOINTMENT = 8;
}
// Information about virtual/online session. E.g. Online yoga class, virtual
// cooking class etc.
message VirtualSession {
// Instructions on how this virtual class is set up. If the partner does not
// include the video URL with the booking, then this text must include when
// the video URL will be shared with the user. Eg. “Zoom url will be mailed
// 30 minutes prior to the class”. (Recommended)
// Only the folloiwng four tags are supported: <br>, <strong>, <em>, <i>.
Text session_instructions = 1;
// Requirements for the given virtual session. Eg. yoga mat,
// cooking utensils etc. (Recommended)
// Only the folloiwng four tags are supported: <br>, <strong>, <em>, <i>.
Text session_requirements = 2;
// Information about the virtual platform used in this session. (Required to
// enable virtual services)
message VirtualPlatformInfo {
// Enum to indicate which virtual platform would be used by the merchant.
enum Platform {
PLATFORM_UNSPECIFIED = 0;
// The merchant is flexible in which video platform they use.
FLEXIBLE = 1;
GOOGLE_HANGOUTS = 2;
GOOGLE_MEET = 3;
ZOOM = 4;
SKYPE = 5;
YOUTUBE = 6;
// Should be set if the video platform used is different from the ones
// mentioned here.
OTHER = 7;
}
Platform platform = 1;
// The name of the platform if the platform is set to OTHER. (Required if
// platform is set to OTHER)
Text other_platform_name = 2;
}
VirtualPlatformInfo virtual_platform_info = 3;
// Set this as true if the virtual session is not live and is pre-recorded.
// (Optional)
bool is_session_prerecorded = 4;
}
// Information about how the user can pay directly to the merchant instead of
// pre-paying for the service via RwG.
message DirectMerchantPayment {
// Users would be advised to pay only via the payment methods mentioned below.
repeated Text payment_methods = 1;
}
// Cancellation policy for a service.
message CancellationPolicy {
// Defines a single refund condition. Multiple refund conditions could be
// used together to describe "refund steps" as various durations before the
// service start time.
message RefundCondition {
// Duration in seconds before the start time, until when the customer can
// receive a refund for part of the service's cost specified in
// `refund_percent`.
// When set to 0 (default), the service can be cancelled at any time.
int64 min_duration_before_start_time_sec = 1;
// The percent that can be refunded, as long as the service booking is
// cancelled at least `min_duration_before_start_time` before the service
// start time, in the range of [0, 100]. When set to 0 (default), the
// service is not refundable. When set to 100 this service is fully
// refundable.
uint32 refund_percent = 2;
}
// Zero or more refund conditions applicable to the policy.
repeated RefundCondition refund_condition = 1;
}
Beispiel für einen Dienstleistungsfeed
{
"service": [
{
"merchant_id": "100",
"service_id": "100-1",
"type" : "SERVICE_TYPE_ONLINE_APPOINTMENT",
"localized_service_name": {
"value": "Makeup masterclass",
"localized_value": [
{
"locale": "en",
"value": "Makeup masterclass"
}
]
},
"localized_description": {
"value": "Learn how to do runway makeup from an award winning makeup artist.",
"localized_value": [
{
"locale": "en",
"value": "Learn how to do runway makeup from an award winning makeup artist."
}
]
},
"virtual_session": {
"session_instructions": {
"value": "You must have access to a computer, and a solid internet connection. Class registration link will be sent to you 15 mins before the start of the class. The class link will be accessible 1 day after the class. ",
"localized_value": [
{
"locale": "en",
"value": "You must have access to a computer, and a solid internet connection. Class registration link will be sent to you 15 mins before the start of the class. The class link will be accessible 1 day after the class. "
}
]
},
"session_requirements": {
"value": "makeup brush, makeup palette, mirror",
"localized_value": [
{
"locale": "en",
"value": "makeup brush, makeup palette, mirror"
}
]
},
"virtual_platform_info": {
"platform": "OTHER",
"other_platform_name": "Susan's hosted platform"
}
},
"direct_merchant_payment": {
"payment_methods": [
{
"value": "Venmo",
"localized_value": [
{
"locale": "en",
"value": "Venmo"
}
]
}
]
},
"price": {
"price_micros": 75000000,
"currency_code": "USD"
},
"rules": {
"min_advance_booking": 0,
"min_advance_online_canceling": 86400,
"cancellation_policy": {
"refund_condition": [
{
"min_duration_before_start_time_sec": 3600,
"refund_percent": 100
}
]
}
},
"prepayment_type": "NOT_SUPPORTED",
"tax_rate": {
"micro_percent": 7750000
}
},
{
"merchant_id": "100",
"service_id": "100-2",
"type" : "SERVICE_TYPE_ONLINE_APPOINTMENT",
"localized_service_name": {
"value": "Advanced Vinyasa Yoga",
"localized_value": [
{
"locale": "en",
"value": "Advanced Vinyasa Yoga"
}
]
},
"localized_description": {
"value": "Learn the advanced techniques of vinyasa yoga taught by award winning yoga instructors.",
"localized_value": [
{
"locale": "en",
"value": "Learn the advanced techniques of vinyasa yoga taught by award winning yoga instructors."
}
]
},
"virtual_session": {
"session_instructions": {
"value": "You must have access to a computer, and a solid internet connection. Class registration link will be included in an email from the merchant.",
"localized_value": [
{
"locale": "en",
"value": "You must have access to a computer, and a solid internet connection. Class registration link will be included in an email from the merchant."
}
]
},
"session_requirements": {
"value": "yoga mat, dumbbells",
"localized_value": [
{
"locale": "en",
"value": "yoga mat, dumbbells"
}
]
},
"virtual_platform_info": {
"platform": "ZOOM"
}
},
"price": {
"price_micros": 40000000,
"currency_code": "USD"
},
"rules": {
"min_advance_booking": 0,
"min_advance_online_canceling": 86400,
"cancellation_policy": {
"refund_condition": [
{
"min_duration_before_start_time_sec": 86400,
"refund_percent": 100
},
{
"min_duration_before_start_time_sec": 3600,
"refund_percent": 50
}
]
}
},
"prepayment_type": "REQUIRED",
"tax_rate": {
"micro_percent": 7750000
},
"require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}
]
}
- Lokalisierte Beschreibung: In der Beschreibung sollte klar beschrieben werden, worum es bei dem Dienst geht. In der Best-Practices-Anleitung erfahren Sie, wie Sie den Inhalt Ihrer Dienste am besten strukturieren.
- Anleitung für die Sitzung: In der Sitzungsanleitung sollten alle nötigen Einrichtungsschritte beschrieben und die Richtlinien beschrieben werden.
- Wenn die Video-URL und die Besprechungs-ID der Plattform nicht automatisch im Rahmen der Funktion „CreateBooking“ erstellt werden (z.B. werden die Details nicht über
CreateBookingResponsegesendet), solltest du deutlich imsession_instructionsangeben, wann und von wer der Nutzer erwartet, dass die Plattforminformationen an ihn gesendet werden.
- Wenn die Video-URL und die Besprechungs-ID der Plattform nicht automatisch im Rahmen der Funktion „CreateBooking“ erstellt werden (z.B. werden die Details nicht über
- Sitzungsanforderungen: Die Sitzungsanforderungen sollten alle erforderlichen Geräte oder Materialien beschreiben, die ein Nutzer für die effektive Teilnahme an der Klasse benötigt. Sie können auch optionales Material hinzufügen, das der Nutzer möglicherweise benötigt, aber markieren Sie diese als optional.
- Plattform: Die Plattform muss die Plattform angeben, über die der Nutzer auf den Onlinedienst zugreift.
- Wenn die Plattform später vom Händler bestimmt wird, setze
platformaufFLEXIBLE. - Wenn die vom Händler verwendete Plattform nicht in der Liste enthalten ist, setze
platformaufOTHERund gibother_platform_namean.
- Wenn die Plattform später vom Händler bestimmt wird, setze
- Stornierungsrichtlinien: Es ist wichtig, korrekte Stornierungsrichtlinien zu haben. Legen Sie
CancellationPolicyfest, wenn Erstattungen und Stornierungen zulässig sind. Sofern nichts anderes festgelegt ist, sind Erstattungen nicht zulässig.
Verfügbarkeitsfeed
- Spots Gesamt: Legen Sie hier die Gesamtkapazität der Teilnehmer fest, die für die Plattform zugelassen ist. Achten Sie dabei darauf, alle Mitarbeiter abzuziehen.
Buchungsserver
Optional: Wenn dein System eine Besprechungs-ID und eine URL im Namen deines Händlers erstellt, füge VirtualSessionInfo als Teil von CreateBookingResponse hinzu.
CreateBooking-Spezifikation
message Booking {
// Information related to the virtual session which was booked.
message VirtualSessionInfo {
// URL which was created for the virtual session. (optional)
string session_url = 1;
// The meeting id which was created for the virtual session. (optional)
string meeting_id = 2;
// Password required to access the session. (optional)
string password = 3;
}
VirtualSessionInfo virtual_session_info = X;
}
CreateBookingRequest
{
"idempotency_token": "10000000000",
"payment_information": {
"prepayment_status": "PREPAYMENT_NOT_PROVIDED"
},
"slot": {
"confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS",
"duration_sec": "3600",
"merchant_id": "10001",
"service_id": "10001-1",
"start_sec": "1586829600"
},
"user_information": {
"email": "john.doe@gmail.com",
"family_name": "John",
"given_name": "Doe",
"telephone": "+123 456 7890",
"user_id": "110291237"
}
}
CreateBookingResponse
{
"booking": {
"bookingId": "abcdefg-12345",
"slot": {
"merchantId": "10001",
"serviceId": "10001-1",
"startSec": "1586804400",
"durationSec": "3600"
},
"userInformation": {
"userId": "110291237",
"givenName": "John",
"familyName": "Doe",
"telephone": "+123 456 7890",
"email": "john.doe@gmail.com"
},
"status": "CONFIRMED",
"virtual_session_info": {
"video_url": "meet.google.com/abcd-efg",
"meeting_id": "abcd-efg",
"password" : "somepassword"
}
}
}
Real-time Updates (Echtzeitaktualisierungen)
Die vorhandene Logik für die Aktualisierung von Inventar oder Buchungen sollte für virtuelle Buchungen beibehalten werden.
- InventoryUpdate RTU: Bei jeder Aktualisierung von Slot-Änderungen in deinem System oder im System von „Mit Google reservieren“ solltest du ein Inventar-Update von Inventarupdates auslösen, um uns über Änderungen bei den Slots zu informieren.
-
BookingNotification RTU: Alle Aktualisierungen von Buchungen (z.B. Änderungen der Zeit oder Stornierungen) in deinem System oder im System von „Mit Google reservieren“ sollten eine RTU für BookingNotification auslösen, um uns über Änderungen an einer Buchung zu informieren.
- Wenn ein Nutzer die Zahlung nicht an den Händler/Partner sendet, senden Sie uns eine RTU zur Stornierung. Eine Stornierungs-E-Mail wird von „Mit Google reservieren“ gesendet.
- Dienst-RTU: Wenn du derzeit Dienste über eine Dienst-RTU aktualisierst, musst du die entsprechenden Felder für den Onlinedienst angeben, wenn du sie für einen Onlinedienst aktualisierst.
E-Mails
Standardmäßig sendet „Mit Google reservieren“ E-Mails mit der Buchungsbestätigung, der Änderung und der Stornierung, wenn ein Nutzer auf der Plattform von „Mit Google reservieren“ Transaktionen ausführt.
Partner sollten zusätzlich Konferenz- und Zahlungsdetails sowie Informationen zu den Stornierungsrichtlinien in separaten E-Mails an den Nutzer senden. Optional können Sie auch vor dem Termin oder Kurs Kurs-E-Mails senden. Lesen Sie das Richtliniendokument, um sicherzustellen, dass Sie die E-Mail-Richtlinien für virtuelle Kurse einhalten.