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

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

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

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

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

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

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

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

อัปเดต Booking 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"
}

Availability Replace 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 จะซิงค์ความพร้อม