الخدمات على الإنترنت هي خدمات يتم تقديمها على الإنترنت بالكامل من خلال منصّة مستضافة، ولا تتطلّب من العميل حضور الخدمة شخصيًا. في ما يلي بعض الأمثلة على الخدمات على الإنترنت:
- دروس اليوغا على الإنترنت عبر Zoom
- دورة تدريبية حول الماكياج على الإنترنت من خلال Google Meet
- تقدير فيديو السباكة على الإنترنت من خلال Skype
متطلبات الأهلية للخدمات على الإنترنت
قبل بدء عملية التنفيذ، يُرجى مراجعة أفضل الممارسات المتعلقة بالخدمات على الإنترنت.
تنفيذ خدمات على الإنترنت
إنّ دمج الخدمات على الإنترنت هو إضافة إلى الدمج الحالي التام بين الأطراف ويتطلب إجراء بعض التغييرات على عملية تنفيذ حالية. وعلى مستوى عالٍ، تشمل التغييرات التالية:
- الخلاصات: يمكنك إضافة
typeوVirtualSessionوDirectMerchantPaymentوCancellationPolicy(إذا لم تتم إضافتها بعد) إلى خلاصات "الخدمات". - خادم الحجز: أضِف VirtualSessionInfo إلى طريقة CreateBooking وأرسِل رسائل إلكترونية تتضمن معلومات الإعداد الافتراضية إلى المستخدم
- تعديلات في الوقت الفعلي (السلوك الحالي): يمكنك معالجة التغييرات في المستودع الافتراضي عبر طلب المستودع الإعلاني في الوقت الفعلي، وتعديلات على الحجز من خلال الحجز RTU، والتغييرات في الخدمة من خلال الخدمة RTU.
الخلاصات
خلاصة الخدمات
تتم إضافة الحقول التالية إلى خلاصة "الخدمات" لإتاحة الخدمات على الإنترنت.
مواصفات خلاصة الخدمات
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;
}
مثال على خلاصة الخدمات
{
"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"
}
]
}
- الوصف المترجَم: يجب أن يصف الوصف موضوع الخدمة بوضوح. يُرجى الرجوع إلى دليل أفضل الممارسات للاطّلاع على أفضل طريقة لإنشاء بنية الخدمات التي تقدّمها.
- تعليمات الجلسة: يجب أن تصف تعليمات الجلسة جميع عمليات الإعداد اللازمة وأن تستوفي الإرشادات الموضّحة في
السياسة.
- إذا لم يتم إنشاء عنوان URL لفيديو النظام الأساسي ومعرّف الاجتماع تلقائيًا
كجزء من CreateBooking (على سبيل المثال، لا يتم إرسال التفاصيل عبر
CreateBookingResponse)، يجب أن تقدّم معلومات واضحة فيsession_instructionsعندما ومن يجب أن يتوقع المستخدم إرسال تفاصيل النظام الأساسي إليه.
- إذا لم يتم إنشاء عنوان URL لفيديو النظام الأساسي ومعرّف الاجتماع تلقائيًا
كجزء من CreateBooking (على سبيل المثال، لا يتم إرسال التفاصيل عبر
- متطلبات الجلسة: يجب أن تصف متطلبات الجلسة جميع المعدات أو المواد الضرورية التي يحتاجها المستخدم للمشاركة في الصف الدراسي بشكل فعّال. يمكنك أيضًا تضمين المواد الاختيارية التي قد يحتاجها المستخدم، ولكن يُرجى وضع علامة عليها على أنها اختيارية.
- النظام الأساسي: يجب أن يشير النظام الأساسي إلى النظام الأساسي الذي سيستخدمه المستخدم للوصول إلى الخدمة على الإنترنت.
- إذا حدّد التاجر في وقت لاحق المنصّة،
اضبط
platformعلىFLEXIBLE. - إذا كانت المنصّة التي يستخدمها التاجر غير مدرَجة في القائمة، اضبط
platformعلىOTHER، وحدِّدother_platform_name.
- إذا حدّد التاجر في وقت لاحق المنصّة،
اضبط
- سياسة الإلغاء: من المهم أن يكون لديك سياسات إلغاء
دقيقة. اضبط
CancellationPolicyإذا كانت عمليات ردّ الأموال والإلغاء مسموح بها. الافتراض التلقائي هو أنّه لا يُسمح بردّ الأموال.
خلاصة مدى التوفّر
- إجمالي عدد النقاط: يمكنك ضبط هذا العدد على السعة الإجمالية للمشاركين المسموح لهم بالمنصّة (مع ضمان استبعاد الموظفين).
خادم الحجز
إجراء اختياري: إذا أنشأ النظام معرّفًا للاجتماع وعنوان URL نيابةً عن
التاجر، يُرجى تضمين السمة VirtualSessionInfo كجزء من
السمة CreateBookingResponse.
مواصفات إنشاء الحجز
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;
}
إنشاء طلب حجز
{
"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"
}
}
إنشاء حجز
{
"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"
}
}
}
تعديلات في الوقت الفعلي
يجب الاحتفاظ بالمنطق الحالي لتحديث المستودع أو الحجوزات للحجوزات الافتراضية.
- InventoryUpdate RTU: إنّ أي تعديلات على تغييرات الخانات على نظامك أو على نظام "الحجز عبر Google" يجب أن يتم تنشيطها في أي وقت لإعلامنا بالتغييرات التي تطرأ على الخانات.
-
BookingNotification RTU: إنّ أي تعديلات على الحجوزات
(مثل تعديل الوقت أو عمليات الإلغاء) على نظامك أو
نظام "الحجز عبر Google" يجب أن يتم تنشيطها من خلال RTT Booking.
- إذا لم يُرسل المستخدم الدفعة إلى التاجر/الشريك، يُرجى إرسال طلب إلغاء في الوقت الفعلي (RTT) إلينا. وسيتم إرسال رسالة إلكترونية تفيد بالإلغاء من خلال "الحجز عبر Google".
- الخدمة (RTU): إذا كنت تعدّل الخدمات حاليًا من خلال خدمة RTU، تأكّد من تضمين حقول الخدمة المناسبة على الإنترنت في حال تعديل خدمة على الإنترنت.
الرسائل الإلكترونية
بشكل تلقائي، سترسل ميزة "الحجز عبر Google" رسائل إلكترونية تتضمّن تأكيد الحجز والتعديل والإلغاء عندما يجري أحد المستخدمين معاملة على منصة "الحجز عبر Google".
على الشركاء أيضًا إرسال تفاصيل المؤتمر وتفاصيل الدفع ومعلومات سياسة الإلغاء في رسائل إلكترونية منفصلة إلى المستخدم. يمكنك اختياريًا إرسال رسائل التذكير الإلكترونية قبل الموعد أو الصف. يُرجى الرجوع إلى مستند السياسة للتأكّد من التزامك بسياسات البريد الإلكتروني للصفوف الافتراضية.