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

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

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

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

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

นอกจากนี้ หากคุณใช้งานแทนที่ 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

ในกรณีที่ระบบได้อัปเดตการจองด้วย "จองกับ Google" (เช่น ยกเลิกหรือแก้ไข) ในระบบแล้ว คุณต้องส่ง 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 นาที
ไม่ตรงกับข้อใดเลย
- แทนที่ครั้งเดียว
- หมายเหตุ: คุณสามารถใช้การเรียกแทนที่แบบกลุ่มเดียวเพื่อจําลองการเรียกใช้การแทนที่แบบกลุ่ม แต่จะมีประสิทธิภาพมากขึ้นเมื่อใช้การเรียกแทนที่แบบกลุ่มเดียว

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

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

ข้อมูลโค้ดฟีดของ 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"
          }
    ]

สําหรับพื้นที่โฆษณาอัปเดต 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
              }
            }
          ],
        }
      ]

สําหรับพื้นที่โฆษณาอัปเดต 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