เซิร์ฟเวอร์การจองพร้อมแล้ว

คุณต้องมี Booking Server เพื่อให้ Actions Center โทรกลับเพื่อสร้างและอัปเดตการจองในนามของคุณ ซึ่งจะช่วยให้ Actions Center สร้างการนัดหมาย การจอง และการจองล่วงหน้ากับคุณในนามของผู้ใช้ได้

ดูวิธีกำหนดค่าการเชื่อมต่อกับ Booking Server ในแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริงได้ที่หัวข้อ กำหนดค่าข้อมูลเข้าสู่ระบบของ Booking Server

ทำตามงานต่อไปนี้ในส่วน Booking Server Ready ให้เสร็จสมบูรณ์ก่อนที่จะย้ายไปใช้การอัปเดตแบบเรียลไทม์

ระบบจะทำเครื่องหมายว่าแต่ละงานเสร็จสมบูรณ์แล้วและเปลี่ยนเป็นสีเขียวเมื่อคุณส่งรายละเอียดสินค้าคงคลังแบบเรียลไทม์ที่ถูกต้องไปยังคำขอ Booking Server ผ่านขั้นตอนการจองในแซนด์บ็อกซ์ ระบบจะวิเคราะห์เหตุการณ์สำคัญของ Booking Server เป็นระยะเวลา 14 วัน

ใช้อินเทอร์เฟซ REST API

ใช้ API อินเทอร์เฟซที่อิงตาม REST ซึ่งจะช่วยให้ Google ส่งคำขอ Booking Server ผ่าน HTTPS ได้

หากต้องการใช้ API อินเทอร์เฟซ ให้ตั้งค่า Booking Server สำหรับการพัฒนาหรือแซนด์บ็อกซ์ที่เชื่อมต่อกับสภาพแวดล้อมแซนด์บ็อกซ์ของ Actions Center และย้ายไปใช้สภาพแวดล้อมเวอร์ชันที่ใช้งานจริงหลังจากทดสอบเซิร์ฟเวอร์แซนด์บ็อกซ์อย่างละเอียดแล้วเท่านั้น

คำขอ Booking Server ทั้งหมดของ Google จะสัมพันธ์กับ URL ของ Booking Server ที่ตั้งค่าไว้ ใน หน้า Booking Server เช่น หากตั้งค่า URL เป็น api.example.com/google ระบบจะส่งคำขอ HealthCheck ทั้งหมดไปยัง api.example.com/google/v3/HealthCheck

ตรวจสอบว่าได้กำหนดค่าจุดสิ้นสุดของ Booking Server ที่ถูกต้องสำหรับทั้งสภาพแวดล้อมแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริงด้วยตัวสลับสภาพแวดล้อม

ความปลอดภัยและการตรวจสอบสิทธิ์

การสื่อสารทั้งหมดกับ Booking Server จะเกิดขึ้นผ่าน HTTPS โดยใช้การตรวจสอบสิทธิ์แบบพื้นฐาน เราขอแนะนำให้ใช้เครื่องมือตรวจสอบ SSL หรือ TLS ที่เปิดให้ใช้งานแก่สาธารณะ เช่น เครื่องมือทดสอบเซิร์ฟเวอร์ SSL ของ Qualys เพื่อช่วยตั้งค่าเซิร์ฟเวอร์

คำขอทั้งหมดที่ Google ส่งไปยัง Booking Server จะได้รับการตรวจสอบสิทธิ์ด้วยการตรวจสอบสิทธิ์แบบพื้นฐานของ HTTPS คุณสามารถป้อนข้อมูลการตรวจสอบสิทธิ์แบบพื้นฐาน รหัสผ่าน และชื่อผู้ใช้ของ Booking Server ในหน้าการกำหนดค่า Booking Server ของ Actions Center โดยต้องเปลี่ยนข้อมูลเข้าสู่ระบบทุกๆ 6 เดือน

สร้าง Booking Server

Booking Server จะกำหนดวิธีที่การผสานรวมสื่อสารกับระบบของคุณ รวมถึงทำการจองหรืออัปเดตการจอง ดูวิธีกำหนดค่าการเชื่อมต่อกับ Booking Server ในแซนด์บ็อกซ์และ เวอร์ชันที่ใช้งานจริงได้ที่หัวข้อ กำหนดค่าข้อมูลเข้าสู่ระบบของ Booking Server

การตอบกลับทุกรายการที่ Booking Server ส่งไปยังคำขอจาก Reserve with Google ควรมีรายละเอียดสินค้าคงคลังแบบเรียลไทม์ที่ถูกต้อง ตารางต่อไปนี้แสดงวิธีการสำหรับการติดตั้งใช้งานแต่ละรายการ และมีลิงก์ไปยังรูปแบบโปรโตคอลบริการ

วิธีการ คำจำกัดความ คำตอบ คำขอ HTTP
การโหลดหน้าเว็บ BatchAvailabilityLookup

เมื่อผู้ใช้คลิกจองโต๊ะ สำหรับผู้ขาย ระบบจะเรียกคำขอ BatchAvailabilityLookup เมื่อโหลดหน้า

เพย์โหลดมีช่องจำนวนมากที่อิงตามการอัปโหลดฟีดล่าสุด ซึ่งจองกับ Google ถือว่าพร้อมให้บริการ

 การตอบกลับต้องรวมคำขอช่องทุกรายการและความพร้อมให้บริการปัจจุบันของช่อง ซึ่งจะป้องกันไม่ให้ช่องที่ไม่พร้อมให้บริการปรากฏ POST /v3/BatchAvailabilityLookup/
การคลิกช่อง BatchAvailabilityLookup เมื่อผู้ใช้เห็นช่องที่พร้อมให้บริการสำหรับการจองและคลิกช่อง ระบบจะเรียกคำขอ BatchAvailabilityLookup สำหรับการคลิกช่อง การตอบกลับต้องแสดงความพร้อมให้บริการปัจจุบันและจริงของ ช่อง หากมีการจองช่องนั้นไปแล้วก่อนที่จะมีการคลิกช่อง ให้แสดงการตอบกลับว่า ช่องนั้นไม่พร้อมให้บริการ POST /v3/BatchAvailabilityLookup/
CreateBooking เมื่อผู้ใช้ยืนยันว่าต้องการจองช่องเวลาที่เลือกใน โมดัลการจอง ระบบจะส่งคำขอ CreateBooking

การตอบกลับต้องแสดงความสำเร็จหรือความล้มเหลวของการ จอง

หากการจองไม่สำเร็จ คุณต้องแสดงเหตุผลที่เฉพาะเจาะจงสำหรับความล้มเหลว เช่น ช่องมีการจองไปแล้วก่อนที่จะมีการเรียกการตอบกลับ CreateBooking

หากสร้างการจองที่สำเร็จ การตอบกลับจะมี booking_id ที่ไม่ซ้ำกันเพื่อใช้อ้างอิงการจองในคำขอหรือการอัปเดตในอนาคต

POST /v3/CreateBooking/
UpdateBooking หลังจากทำการจองผ่าน จองกับ Google แล้ว ผู้ใช้สามารถเลือกที่จะแก้ไขการจองได้ เมื่อผู้ใช้อัปเดตหรือยกเลิกการจอง ระบบจะส่งคำขอ UpdateBooking การตอบกลับ UpdateBooking ต้องแสดงความสำเร็จของการจองหรือ แสดงเหตุผลที่เฉพาะเจาะจงสำหรับความล้มเหลว เช่นเดียวกับการตอบกลับ CreateBooking POST /v3/UpdateBooking/
HealthCheck Actions Center จะเรียก Booking Server เป็นประจำเพื่อ ยืนยันว่าโครงสร้างพื้นฐานของคุณทำงานอยู่

ใช้รหัสสถานะ HTTP เพื่อระบุสถานะการให้บริการของเซิร์ฟเวอร์ แสดงรหัสสถานะ HTTP 200 หากเซิร์ฟเวอร์ทำงานอยู่และทำงานได้สำเร็จ

หากต้องการระบุข้อผิดพลาดหรือนำการผสานรวมออกจากระบบชั่วคราว ให้แสดงรหัสสถานะ HTTP ที่ไม่ใช่ 2xx ที่เหมาะสม HTTP status code

 GET /v3/HealthCheck/

เกณฑ์เหตุการณ์สำคัญ

หากต้องการทำเหตุการณ์สำคัญ Booking Server Ready ให้เสร็จสมบูรณ์ การผสานรวมต้องเป็นไปตามเกณฑ์ต่อไปนี้ในสภาพแวดล้อมแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริง

วิธีการ จำนวนคำขอที่จำเป็น (แซนด์บ็อกซ์) จำนวนคำขอที่จำเป็น (เวอร์ชันที่ใช้งานจริง) อัตราความสำเร็จที่จำเป็น
การโหลดหน้าเว็บ BatchAvailabilityLookup 20 20 90%
การคลิกช่อง BatchAvailabilityLookup 20 20 90%
CreateBooking 10 3 90%
UpdateBooking 10 3 90%

ขั้นตอนการจองในแซนด์บ็อกซ์

หากต้องการดูขั้นตอนการจองในแซนด์บ็อกซ์ ให้ไปที่มุมมอง สินค้าคงคลังของ Actions Center คอลัมน์ RwG - E2E ของมุมมองสินค้าคงคลังจะแสดงลิงก์ใช้งานจริง (ในแซนด์บ็อกซ์) ไปยัง ขั้นตอนการจองในแซนด์บ็อกซ์สำหรับผู้ขายในแซนด์บ็อกซ์ที่ ตรงกัน และมีความพร้อมให้บริการในอนาคต

การดำเนินการในขั้นตอนการจองมีดังนี้

  • เมื่อคุณคลิกลิงก์ RwG - E2E ระบบจะทริกเกอร์คำขอ BatchAvailabilityLookup เมื่อการโหลดหน้าเว็บและแสดงความพร้อมให้บริการที่ทราบของผู้ขาย

  • เมื่อคุณคลิกเวลาจอง ระบบจะทริกเกอร์คำขอ BatchAvailabilityLookup เมื่อคลิกช่องและแสดงโมดัลการจอง

  • ทำการจองให้เสร็จสมบูรณ์ด้วยโมดัลการจองเพื่อส่งคำขอ CreateBooking

  • หลังจากทำการจองในสภาพแวดล้อมแซนด์บ็อกซ์เสร็จแล้ว บัญชีที่ใช้สร้างการจองจะได้รับอีเมลยืนยันพร้อมรายละเอียดการจอง

  • หากต้องการทริกเกอร์เมธอด UpdateBooking ให้เปลี่ยนหรือยกเลิกการจองจากอีเมล

HealthCheck

ตรวจสอบว่าได้ใช้เมธอด HealthCheck ในแซนด์บ็อกซ์และเวอร์ชันที่ใช้งานจริง เมธอดนี้จะแสดงสถานะความสมบูรณ์ของ Booking Server ซึ่งจะช่วยให้ Google ตรวจสอบสถานะการให้บริการของ Booking Server ได้อย่างต่อเนื่อง

คำขอ: ไม่มี

ผลลัพธ์: ไม่มี

ใช้รหัสสถานะ HTTP เพื่อระบุสถานะการให้บริการของเซิร์ฟเวอร์

หากเซิร์ฟเวอร์ทำงานอยู่และทำงานได้สำเร็จ ให้แสดงรหัสสถานะ HTTP 200, หรือหากต้องการระบุข้อผิดพลาด ให้แสดงรหัสสถานะ HTTP รายการใดรายการหนึ่ง