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

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

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

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

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

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

คุณไม่จำเป็นต้องเรียกใช้ Maps Booking API ทั้งหมด ข้อมูลต่อไปนี้เป็นข้อมูลที่จำเป็น

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

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

ในกรณีที่มีการอัปเดตการจองในศูนย์การดำเนินการ (เช่น ยกเลิกหรือแก้ไข) ในระบบ คุณต้องส่ง 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": "2025-01-02T15:01:23.045123456Z",
  "duration": "3000s",
  "status": "CANCELED"
}

ความพร้อมให้บริการแทนที่ RTU

วิธีการแทนที่เพื่ออัปเดตความพร้อมให้บริการมีอยู่ 2 วิธีดังนี้

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

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

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

  • spotsOpen
  • recurrence

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

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

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

การอัปเดตแบบเรียลไทม์: รูปแบบโฆษณาแบบเปิด

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

ข้อมูลโค้ดฟีด spots_open มีหน้าตาดังนี้

ตัวอย่างข้อมูลฟีด

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

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

แทนที่ข้อมูลโค้ดอัปเดตแบบเรียลไทม์

  {
    "extendedServiceAvailability": [
      {
        "merchantId": "1001",
        "serviceId": "12310",
        "startTimeRestrict": "2025-01-02T15:01:23.045123456Z",
        "endTimeRestrict": "2025-01-02T19:01:23.045123456Z",
        "availability": [
          {
            "startTime": "2025-01-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": 1735831800, # January 02, 2025 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 ซิงค์ข้อมูลความพร้อมจำหน่ายสินค้า