Onlinedienste hinzufügen (eingestellt)

Onlinedienste werden vollständig online auf einer gehosteten Plattform durchgeführt und erfordern keine persönliche Teilnahme. Hier einige Beispiele für Onlinedienste:

  • Online-Yogakurs über Zoom
  • Online-Make-up-Kurs über Google Meet
  • Online Kostenvoranschlag für Klempnerarbeiten über Skype

Teilnahmevoraussetzungen für Onlinedienste

Lesen Sie sich vor Beginn der Implementierung die Richtlinien und Best Practices für Onlinedienste durch.

Implementierung von Onlinediensten

Die Integration von Onlinediensten ist ein Add-on zur bestehenden End-to-End-Integration von Terminvereinbarungen und erfordert einige Änderungen an einer bestehenden Implementierung. Auf übergeordneter Ebene umfassen die folgenden Änderungen die folgenden Änderungen:

  • Feeds: Fügen Sie den Dienstleistungsfeeds type, VirtualSession, DirectMerchantPayment und CancellationPolicy hinzu (falls nicht bereits hinzugefügt).
  • Buchungsserver: Füge der CreateBooking-Methode „VirtualSessionInfo“ hinzu und sende E-Mails mit virtuellen Einrichtungsinformationen an den Nutzer.
  • Echtzeitaktualisierungen (bestehende Funktionsweise): Änderungen am virtuellen Inventar über die Echtzeitaktualisierung für „InventoryUpdate“, Änderungen an der Buchung über die Echtzeitaktualisierung für „BookingNotification“ und Änderungen am Dienst über die Echtzeitaktualisierung für den Dienst

Feeds

Dienstleistungsfeed

Die folgenden Felder werden dem Dienstleistungsfeed hinzugefügt, um Onlinedienste zu unterstützen.

Feedspezifikationen für Dienstleistungen

 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/actions-center/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: Aus der Beschreibung sollte klar hervorgehen, worum es bei dem Dienst geht. Im Best Practices-Leitfaden erfahren Sie, wie Sie die Inhalte Ihrer Dienste am besten strukturieren.
  • Sitzungsanleitung: Die Sitzungsanleitung sollte alle erforderlichen Einrichtungen beschreiben und den Vorgaben in der Richtlinie entsprechen.
    • Wenn die Video-URL der Plattform und die Besprechungs-ID nicht automatisch im Rahmen von CreateBooking erstellt werden (die Details werden z.B. nicht über CreateBookingResponse gesendet), solltest du in session_instructions deutlich angeben, wann und wer der Nutzer erwarten soll, dass die Plattformdetails an ihn gesendet werden.
  • Sitzungsanforderungen: In den Sitzungsanforderungen sollten alle erforderlichen Geräte oder Materialien beschrieben werden, die ein Nutzer für eine effektive Teilnahme am Kurs 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 sollte die Plattform angeben, über die der Nutzer auf den Onlinedienst zugreift.
    • Wenn die Plattform zu einem späteren Zeitpunkt vom Händler festgelegt wird, setze platform auf FLEXIBLE.
    • Wenn die vom Händler verwendete Plattform nicht in der Liste enthalten ist, setzen Sie platform auf OTHER und geben Sie other_platform_name an.
  • Stornierungsrichtlinien: Die richtigen Stornierungsrichtlinien sind wichtig. Legen Sie CancellationPolicy fest, wenn Erstattungen und Stornierungen zulässig sind. Wenn nichts festgelegt ist, wird standardmäßig davon ausgegangen, dass Rückerstattungen nicht zulässig sind.

Verfügbarkeitsfeed

  • Spots Total (Spots insgesamt): Legen Sie hier die Gesamtkapazität der Teilnehmer fest, die für die Plattform zulässig sind. Achten Sie darauf, dass Sie die Anzahl der Mitarbeiter abziehen.

Buchungsserver

Optional: Wenn dein System im Namen deines Händlers eine Besprechungs-ID und eine URL erstellt, gib VirtualSessionInfo als Teil deines CreateBookingResponse an.

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 zum Aktualisieren von Inventar oder Buchungen sollte für virtuelle Buchungen beibehalten werden.

  • InventoryUpdate RTU: Bei allen Aktualisierungen von Slotänderungen in deinem System oder im Actions Center-System sollte eine „InventoryUpdate“-Echtzeitaktualisierung ausgelöst werden, um uns über die Änderungen der Slots zu informieren.
  • BookingNotification – RTU: Bei allen Aktualisierungen von Buchungen (z.B. Änderung der Uhrzeit oder Stornierungen) in deinem System oder im Actions Center-System sollte eine BookingNotification RTU ausgelöst werden, um uns über die Änderungen einer Buchung zu informieren.
    • Wenn ein Nutzer die Zahlung nicht an den Händler/Partner sendet, senden Sie uns bitte eine Echtzeitaktualisierung für die Stornierung. Sie erhalten vom Actions Center eine Kündigungs-E-Mail.
  • Echtzeitaktualisierung für Dienstleistungen: Wenn Sie Dienstleistungen derzeit über eine Echtzeitaktualisierung für Dienstleistungen aktualisieren, geben Sie bei der Aktualisierung für einen Onlinedienst die entsprechenden Felder für den Onlinedienst an.

E-Mail-Adressen

Standardmäßig sendet das Actions Center die standardmäßigen E-Mails zur Buchungsbestätigung, Änderung und Stornierung, wenn ein Nutzer Transaktionen auf der Actions Center-Plattform durchführt.

Partner sollten außerdem Konferenzdetails, Zahlungsdetails und Informationen zu Stornierungsrichtlinien in separaten E-Mails an den Nutzer senden. Optional können Sie vor dem Termin oder Kurs Erinnerungs-E-Mails senden. Lesen Sie bitte das Richtliniendokument zu den E-Mail-Richtlinien für virtuelle Kurse.