結構即時更新

即時更新用例

必須一律在下列情況發出即時更新:

  • 使用者從您的系統取消預訂,而該時段會變成 廣告。
  • 當使用者透過 Actions Center 預訂 供應時段已無法使用。
  • 當你透過 Actions Center 取消預訂時 例如直接由商家決定您需要更新 及供應情形,因為原始時段現已 就能再次使用。

此外,如果您在 供應情形取代 RTU, 即時更新應於下列情況下發出:

  • 商家在系統上變更時間表 (供應情形) 時。
  • 當使用者在您的系統上預訂,以及供應時段 已不再提供。
  • 如果您正在使用 CheckAvailability、 當預訂伺服器 CheckAvailability 呼叫會傳回與實際廣告空間不符的庫存。

不需要所有 Maps Booking API 呼叫。以下是必要項目:

視整合類型而定,以下項目或許可用或必要:

更新預訂 RTU

如果 Actions Center 預訂事宜有相關更新 (例如已取消或 檔案內容 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): 完全取代商家的供應情形資料和 免費 Google Cloud 服務
    • 注意事項:這項批次呼叫不保證不可部分完成。僅限 更新成功的供應時段。
  • 單一取代 (InventoryUpdate.ReplaceServiceAvailability): 完全取代單一商家和服務的供應情形。

請使用以下項目 參考資料 詳細資料。

即時更新必須採用與資料相同的可用性結構 會透過動態饋給傳送的圖片請務必使用以下其中一項:

  • spotsOpen
  • recurrence

選擇取代呼叫方式

下列指南可協助您判斷哪個取代方法比較合適 適合:

  • 單筆預訂會影響多項服務嗎?例如剪髮 和著色 (各自都是不同服務) 的客戶搭配設計師 與該時段樣式清單相關聯的服務,都必須移除。
  • 系統會不時向 Google 同步傳送上述所有個人資訊 供應情形自上次更新後有所變動 (不建議)。
    • 批次取代
    • 注意:我們預計在更新後 5 分鐘內傳送廣告空間 RTU 。因此,建議您至少每 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,替換了 下午 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"
          }
        ]
      }
    ]
  }

以下舉例說明,如果在下列網站有新時段,系統應該在下次每日動態饋給裡 下午 3: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"
        }
      ]

即時更新:重複規則格式

請務必在動態饋給、預訂伺服器和 即時更新。

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

動態饋給程式碼片段

  "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 系統之間的關聯