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