การอัปเดตโครงสร้างแบบเรียลไทม์

กรณีการใช้งานสำหรับการอัปเดตแบบเรียลไทม์

การอัปเดตแบบเรียลไทม์ต้องออกในสถานการณ์ต่อไปนี้เสมอ

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

นอกจากนี้ หากคุณใช้ ความพร้อมให้บริการแทนที่ RTU การอัปเดตแบบเรียลไทม์ควรดำเนินการในสถานการณ์ต่อไปนี้

  • เมื่อผู้ขายเปลี่ยนกำหนดเวลา (ความพร้อมจำหน่ายสินค้า) ในระบบของคุณ
  • เมื่อผู้ใช้จองในระบบของคุณและช่วงเวลาห้องว่าง ไม่มีให้บริการแล้ว
  • หากคุณใช้การผสานรวมเดิมกับ CheckAvailability เมื่อเซิร์ฟเวอร์การจอง CheckAvailability จะแสดงพื้นที่โฆษณาที่ไม่ตรงกับพื้นที่โฆษณาจริง

โดยไม่จำเป็นต้องเรียกใช้ Maps Booking API บางรายการ โดยต้องระบุข้อมูลต่อไปนี้

อาจมีหรือจำเป็นต้องมีเนื้อหาต่อไปนี้ด้วย ทั้งนี้ขึ้นอยู่กับประเภทการผสานรวม

อัปเดต RTU การจอง

ในกรณีที่มีการอัปเดตการจองใน Actions Center (เช่น ยกเลิกหรือ ) ในระบบของคุณ notification.partners.bookings.patch (BookingNotification.UpdateBooking) ต้องส่ง

ฟิลด์ที่แก้ไขได้

  • status
  • startTime
  • duration
  • partySize
  • paymentInformation.prepaymentStatus

ตัวอย่างการยกเลิก

Request:
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status

Body:
{
  "name": "partners/<PARTNER_ID>/bookings/<BOOKING_ID>",
  "merchantId": "10001",
  "serviceId": "1001",
  "startTime": "2014-10-02T15:01:23.045123456Z",
  "duration": "3000s",
  "status": "CANCELED"
}

ความพร้อมจำหน่ายสินค้าแทนที่ RTU

วิธีการแทนที่อัปเดตได้มี 2 ประเภท ความพร้อมจำหน่ายสินค้า [availability]:

  • แทนที่เป็นกลุ่ม (InventoryUpdate.BatchServiceAvailability): แทนที่ข้อมูลความพร้อมจำหน่ายสินค้าทั้งหมดสำหรับผู้ขายและหลายราย บริการต่างๆ
    • หมายเหตุ: การเรียกใช้แบบกลุ่มนี้ไม่ได้รับประกันความสมบูรณ์ เฉพาะ ระบบจะแสดงผลสล็อตความพร้อมจำหน่ายสินค้าที่อัปเดตเรียบร้อยแล้ว
  • แทนที่รายการเดียว (InventoryUpdate.ReplaceServiceAvailability): แทนที่ความพร้อมสำหรับผู้ขายและบริการหนึ่งๆ โดยสมบูรณ์

โปรดใช้สิ่งต่อไปนี้ reference เพื่อดูข้อมูลเพิ่มเติม รายละเอียด

การอัปเดตแบบเรียลไทม์ต้องใช้โครงสร้างความพร้อมใช้งานเดียวกันกับข้อมูล ที่ส่งผ่านฟีด โดยต้องใช้อย่างใดอย่างหนึ่งต่อไปนี้

  • spotsOpen
  • recurrence

การเลือกวิธีแทนที่เพื่อโทรออก

ใช้คำแนะนำต่อไปนี้เพื่อช่วยคุณพิจารณาว่าวิธีการแทนที่แบบใดมากกว่า เหมาะสม:

  • บริการหลายอย่างได้รับผลกระทบจากการจองครั้งเดียวไหม เช่น ตัดผม และการลงสี (แต่ละบริการเป็นบริการที่ไม่เหมือนกัน) จะจองกับสไตลิสต์ ดังนั้น บริการที่เชื่อมโยงกับสไตลิสต์สำหรับช่วงเวลานั้นควรถูกนำออก
  • ระบบของคุณจะซิงค์กับ Google เป็นครั้งคราวโดยส่ง ความพร้อมจำหน่ายสินค้ามีการเปลี่ยนแปลงตั้งแต่การอัปเดตครั้งล่าสุด (ไม่แนะนำ)
    • แทนที่เป็นกลุ่ม
    • หมายเหตุ: เราคาดว่าจะส่ง RTU ของพื้นที่โฆษณาภายใน 5 นาทีหลังจากการอัปเดตเกิดขึ้น เคียงข้างกัน คุณจึงควรตรวจสอบและส่งการอัปเดตทุกๆ 5 นาทีเป็นอย่างน้อย
  • ไม่ตรงกับข้อใดเลย
    • แทนที่รายการเดียว
    • หมายเหตุ: คุณสามารถใช้การเรียกแทนที่แบบเดี่ยวหลายรายการเพื่อจำลอง แต่การใช้คำสั่งเดียวแทนแบบกลุ่มมักจะมีประสิทธิภาพมากกว่า การเรียกใช้การแทนที่แบบกลุ่ม

การอัปเดตแบบเรียลไทม์: รูปแบบการเปิดของ Spots

คุณจะต้องใช้รูปแบบเดียวกันทั้งในฟีด เซิร์ฟเวอร์การจอง และ การอัปเดตแบบเรียลไทม์

ตัวอย่างข้อมูลฟีด spots_open มีลักษณะดังนี้

ข้อมูลโค้ดฟีด

   "availability": [
          {
            "merchant_id": "1001",
            "service_id": "12310",
            "spots_open": 2,
            "spots_total": 2,
            "start_sec": 1412263800, # October 02, 2014 15:30:00
            "duration_sec": 1800,
            "availabilityTag": "1000001"
          }
    ]

สำหรับ Inventory Update API รูปแบบเนื้อหาของคำขอจะแทนที่เมื่อ เวลา 15:30 น. มีการจองเวลาไว้:

แทนที่ตัวอย่างข้อมูลการอัปเดตแบบเรียลไทม์

  {
    "extendedServiceAvailability": [
      {
        "merchantId": "1001",
        "serviceId": "12310",
        "startTimeRestrict": "2014-10-02T15:01:23.045123456Z",
        "endTimeRestrict": "2014-10-02T19:01:23.045123456Z",
        "availability": [
          {
            "startTime": "2014-10-02T15:30:00.00Z",
            "duration": "3600s",
            "spotsOpen": "1",
            "spotsTotal": "2",
            "availabilityTag": "1000001"
          }
        ]
      }
    ]
  }

ต่อไปนี้คือตัวอย่างของสิ่งที่เราคาดหวังในฟีดรายวันถัดไป หากช่องใหม่ที่ 15:30 น. ได้รับการจอง

ข้อมูลโค้ดฟีด

"availability": [
        {
          "merchant_id": "1001",
          "service_id": "12310",
          "spots_open": 1,
          "spots_total": 2,
          "start_sec": 1412263800, # October 02, 2014 15:30:00
          "duration_sec": 1800,
          "availabilityTag": "1000001"
        }
      ]

การอัปเดตแบบเรียลไทม์: รูปแบบการเกิดซ้ำ

คุณจะต้องใช้รูปแบบเดียวกันทั้งในฟีด เซิร์ฟเวอร์การจอง และ การอัปเดตแบบเรียลไทม์

ฟีดที่ใช้การเกิดซ้ำมีลักษณะดังนี้

ข้อมูลโค้ดฟีด

  "availability": [
        {
          "merchant_id": "1001",
          "service_id": "12310",
          "spots_open": 1,
          "spots_total": 1,
          "start_sec": 1540890000, # October 30, 2018 9:00:00 AM
          "duration_sec": 1800,
          "recurrence": {
            "repeat_every_sec": 1800,
            "repeat_until_sec": 1540918800 # October 30, 2018 5:00:00 PM
          },
          "schedule_exception": [
            {
              "time_range": {
                "begin_sec": 1540902600, # October 30, 2018 12:30:00 PM
                "end_sec": 1540904400 # October 30, 2018 1:00:00 PM
              }
            }
          ],
        }
      ]

สำหรับ Inventory Update API รูปแบบเนื้อหาของคำขอจะแทนที่เมื่อ มีการจองช่วงเวลา 15:30 น. ซึ่งมีลักษณะดังนี้

  {
    "extendedServiceAvailability": [
      {
        "merchantId": "1001",
        "serviceId": "12310",
        "startTimeRestrict": "2018-10-30T15:01:23.045123456Z",
        "endTimeRestrict": "2018-10-30T19:01:23.045123456Z",
        "availability": [
          {
            "startTime": "2018-10-30T15:30:00.00Z",
            "duration": "3600s",
            "spotsOpen": "1",
            "scheduleException": [
             {
                "timeRange": {
                  "startTime": "2018-10-30T12:30:00.00Z",
                  "endTime": "2018-10-30T13:00:00.00Z"
                }
              },
              {
                "timeRange": {
                  "startTime": "2018-10-30T15:30:00.00Z",
                  "endTime": "2018-10-30T16:00:00.00Z"
                }
              }
            ]
          }
        ]
      }
    ]
  }

นี่คือตัวอย่างที่คาดไว้ในฟีดรายวันถัดไป โปรดสังเกตด้วยว่า เป็นความพร้อมทั้งหมดของบริการสำหรับผู้ขายรายนั้น และทั้งหมด schedule_exceptions ก่อนหน้าและใหม่:

ข้อมูลโค้ดฟีด

   "availability": [
        {
          "merchant_id": "1001",
          "service_id": "12310",
          "spots_open": 1,
          "spots_total": 1,
          "start_sec": 1540890000, # October 30, 2018 9:00:00 AM
          "duration_sec": 1800,
          "recurrence": {
            "repeat_every_sec": 1800,
            "repeat_until_sec": 1540918800 # October 30, 2018 5:00:00 PM
          },
          "schedule_exception": [
            {
              "time_range": {
                "begin_sec": 1540902600, # October 30, 2018 12:30:00 PM
                "end_sec": 1540904400 # October 30, 2018 1:00:00 PM
              }
            },
            {
              "time_range": {
                "begin_sec": 1540913400, # October 30, 2018 3:30:00 PM
                "end_sec": 1540915200 # October 30, 2018 4:00:00 PM
              }
            }
          ],
        }
      ]

กรณีที่ควรส่งการอัปเดตแบบเรียลไทม์

ควรส่งการอัปเดตแบบเรียลไทม์อย่างต่อเนื่องเมื่อมีการเปลี่ยนแปลงความพร้อมให้บริการ หมวดหมู่นี้นอกเหนือจากฟีดความพร้อมจำหน่ายสินค้าที่ครอบคลุม ส่งวันละครั้ง เพื่อให้มั่นใจว่าได้ซิงค์ความพร้อมจำหน่ายสินค้าแล้ว ระหว่างระบบของคุณกับ Google