หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

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

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

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

แต่ไม่จําเป็นต้องเรียก Maps Booking API บางรายการ คุณต้องดำเนินการต่อไปนี้

notification.partners.bookings.patch (BookingNotification.UpdateBooking)

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

inventory.partners.availability.replace (InventoryUpdate.BatchServiceAvailability) หรือ inventory.partners.merchants.services.availability.replace (InventoryUpdate.ReplaceServiceAvailability)

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

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

ช่องที่ปรับแต่งได้

status
startTime
duration
partySize
paymentInformation.prepaymentStatus

หมายเหตุ: name, merchant_id, service_id และช่องที่เฉพาะเจาะจงที่เปลี่ยนแปลง ส่วนช่องอื่นๆ ทั้งหมดเป็นตัวเลือก ในบางกรณี ช่องหลายช่องอาจเปลี่ยนแปลงได้พร้อมกัน ในกรณีนี้ ให้คั่นช่องต่างๆ ใน updateMask (เช่น updateMask=partySize,startTime) ด้วยคอมมา

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

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 ประเภทดังนี้

การแทนที่เป็นกลุ่ม (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": 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"
        }
      ]

หมายเหตุ: ในกรณีที่ไม่มีห้องว่างเหลือแล้ว (spots_open เท่ากับ 0) การส่งคำขอแทนที่สำหรับ Inventory API จะมี 2 รูปแบบด้วยกัน

ข้อกำหนดที่ชัดเจน: ขอแนะนำให้ใช้วิธีนี้หากคุณมี spots_total > 1

  {
    "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": "0",
            "spotsTotal": "2",
            "availabilityTag": "1000001"
          }
        ]
      }
    ]
  }

ข้อกำหนดว่างเปล่า: ขอแนะนำให้ใช้เฉพาะกับ spots_total = 1 สำหรับผู้ขายและบริการส่วนใหญ่

  {
  "extendedServiceAvailability": [
    {
      "merchantId": "1001",
      "serviceId": "12310",
      "startTimeRestrict": "2014-10-02T15:01:23.045123456Z",
      "endTimeRestrict": "2014-10-02T19:01:23.045123456Z",
      "availability": [
        {}
      ]
    }
  ]
}

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

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

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

  "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 ทั้งหมดสำหรับ สล็อตที่มีการจอง เนื่องจากเมธอด API ได้มาแทนที่ความพร้อมใช้งานของบริการและผู้ขายที่เจาะจงดังกล่าว หากแทนที่ด้วยบริการอื่น บริการดังกล่าวต้องเป็นข้อมูลทั้งหมดเกี่ยวกับความพร้อมใช้งานของบริการนั้นและต้องมีสล็อตทั้งหมดที่จองไว้

นี่คือตัวอย่างของสิ่งที่คาดว่าจะเกิดในฟีดรายวันถัดไป โปรดทราบว่านี่จะเป็นบริการทั้งหมดที่พร้อมใช้งานสำหรับผู้ขายรายนั้น รวมถึง 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