建立即時更新架構

用於即時更新的應用實例

在下列情況下,一律必須發布「即時更新」:

  • 當使用者在您的系統中取消預訂時,該時段可用。
  • 當使用者透過「透過 Google 預訂」進行預訂時,該時段已無法使用。
  • 直接取消 (例如由商家直接取消) 透過「透過 Google 預訂」進行的預訂時。由於原始時段已可供使用,您必須更新預訂和供應情形。

此外,如果您實作了供應情形取代 RTU,在下列情況下應發布即時更新:

  • 商家變更系統中的時間表 (有空與否) 時。
  • 當使用者在您的系統中預訂預訂,且不再提供預約時段時。
  • 如果您使用舊版 CheckAvailability 整合服務,則預訂伺服器 CheckAvailability 呼叫會傳回與實際廣告空間不符的廣告空間。

並非所有 Maps Booking API 呼叫皆需要。是否為必要項目:

視整合類型而定,可能也有下列必要或必要:

更新預訂即時文字訊息

如果系統已在您的系統中更新「透過 Google 預訂」預訂 (例如取消或修改),則必須傳送 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": "2014-10-02T15:01:23.045123456Z",
  "duration": "3000s",
  "status": "CANCELED"
}

供應情形取代 RTU

您可以透過以下兩種替代方法更新有空與否:

  • 批次取代 (InventoryUpdate.BatchServiceAvailability):完全取代商家和多項服務的供應情形資料。
    • 注意:這項批次呼叫不保證會有不可部分完成。系統只會傳回成功更新的可用性運算單元。
  • 單一替換 (InventoryUpdate.ReplaceServiceAvailability):完全取代單一商家與服務之間的供應情形。

詳情請參閱下列參考資料

即時更新必須採用與透過動態饋給傳送的資料相同的可用性結構。必須使用:

  • spotsOpen
  • recurrence

選擇替換的呼叫方法

下列指南可協助您判斷哪個替換方法較為合適:

  • 單一服務是否會影響多項服務?舉例來說,某個髮型和染色 (每個服務都是不同的服務) 都是透過造型師預訂,因此所有與同個時段有雷同關係的服務都會遭到移除。
  • 自從上次更新 (不建議做法) 以來,所有可用性變更都會隨著 Google 不時同步處理。
    • 批次取代
    • 注意事項:在系統更新資料後,我們預計會在 5 分鐘內傳送 Inventory RTU。因此您應該至少每 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"
          }
    ]

在 Inventory Update API 中,用於預訂下午 3: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"
          }
        ]
      }
    ]
  }

如果

動態饋給程式碼片段

"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"
        }
      ]

即時更新:重複格式

請務必在動態饋給、預訂伺服器和即時更新中,使用相同的格式。

使用重複週期的動態饋給看起來會像這樣:

動態饋給程式碼片段

  "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,如果預訂下午 3: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 系統能持續同步處理供應情形資訊。