تُعرَّف الخدمات على الإنترنت على أنّها الخدمات التي يتم تقديمها بالكامل على الإنترنت من خلال منصة مستضافة، ولا تتطلّب من العميل حضور الخدمة شخصيًا. تشمل بعض الأمثلة على الخدمات على الإنترنت ما يلي:
- حصة يوغا على الإنترنت من خلال Zoom
- دورة تدريبية مكثفة على الإنترنت حول المكياج من خلال Google Meet
- تقدير مرئي عبر الفيديو لأعمال السباكة على الإنترنت باستخدام Skype
متطلبات الأهلية للاستفادة من الخدمات على الإنترنت
قبل بدء التنفيذ، يُرجى مراجعة سياسات الخدمات على الإنترنت وأفضل الممارسات.
تنفيذ الخدمات على الإنترنت
إنّ عملية دمج الخدمات على الإنترنت هي إضافة إلى عملية الدمج الحالية لميزة "المواعيد من البداية إلى النهاية"، وتتطلّب إجراء بعض التغييرات على عملية التنفيذ الحالية. على مستوى عالٍ، تشمل التغييرات التالية ما يلي:
- الخلاصات: أضِف
typeوVirtualSessionDirectMerchantPaymentوCancellationPolicy(إذا لم يسبق إضافتها) إلى خلاصات "الخدمات". - خادم الحجز: أضِف VirtualSessionInfo إلى طريقة CreateBooking، أرسِل رسائل إلكترونية إلى المستخدم تتضمّن معلومات الإعداد الافتراضي.
- التعديلات في الوقت الفعلي (السلوك الحالي): يمكنك معالجة التغييرات في المستودع الافتراضي من خلال التعديل في الوقت الفعلي لـ InventoryUpdate، والتعديلات في الحجز من خلال التعديل في الوقت الفعلي لـ BookingNotification، والتغييرات في الخدمة من خلال تعديل في الوقت الفعلي لـ Service.
الخلاصات
خلاصة الخدمات
تتم إضافة الحقول التالية إلى خلاصة "الخدمات" لإتاحة الخدمات على الإنترنت.
مواصفات خلاصة الخدمات
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; }
مثال على خلاصة الخدمات
{ "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.
مواصفات CreateBooking
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 [(datapol.semantic_type) = ST_ACCOUNT_CREDENTIAL]; } 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" } } }
آخر الأخبار في الوقت الفعلي
يجب الحفاظ على المنطق الحالي لتعديل المستودع أو الحجوزات للحجوزات الافتراضية.
- InventoryUpdate RTU: يجب أن يؤدي أي تعديلات على التغييرات في الفتحات على نظامك أو نظام "مركز الإجراءات" إلى تنشيط InventoryUpdate RTU لإعلامنا بالتغييرات في الفتحات.
-
BookingNotification RTU: أي تعديلات على الحجوزات
(مثل تعديل الوقت أو الإلغاء) على نظامك أو على نظام
"مركز الإجراءات"، يجب أن تؤدي إلى إرسال رسالة BookingNotification RTU لإعلامنا
بتغييرات الحجز.
- إذا لم يرسل المستخدم الدفعة إلى التاجر/الشريك، يُرجى إرسال طلب إعادة نظر في الإلغاء إلينا. سيرسل "مركز الإجراءات" رسالة إلكترونية لإلغاء الاشتراك.
- Service RTU: إذا كنت حاليًا تعدّل الخدمات من خلال Service RTU، تأكَّد من تضمين حقول الخدمة المناسبة على الإنترنت في حال إجراء تعديلات على خدمة على الإنترنت.
الرسائل الإلكترونية
سيرسِل "مركز الإجراءات" تلقائيًا رسائل التأكيد العادية بشأن الحجز والتعديل والإلغاء عندما يجري المستخدم معاملة على منصة "مركز الإجراءات".
على الشركاء أيضًا إرسال تفاصيل المؤتمر وتفاصيل الدفع ومعلومات عن سياسة الإلغاء إلى المستخدم في رسائل إلكترونية منفصلة. يمكنك اختياريًا إرسال رسائل تذكير عبر البريد الإلكتروني قبل الموعد أو الصف. يُرجى الرجوع إلى مستند السياسة للتأكّد من التزامك بسياسات البريد الإلكتروني للفصول الافتراضية.