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

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

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

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

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

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

ข้อกำหนดที่ชัดเจน: วิธีนี้เป็นวิธีที่แนะนำหากคุณ มี 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