构建实时更新

实时更新使用场景

必须始终在以下情况发出实时更新：

  • 当用户取消您系统中的预订时，相应槽会变为可用。
  • 当用户通过“通过 Google 预订”完成预订且可用性空档不再可用时。
  • 当您通过“通过 Google 预订”进行预订时（例如，商家直接取消）。您需要更新预订和空房情况，因为原来的空档已恢复为可预订状态。

此外，如果您实现可用性替换 RTU，则应在以下情况下发出实时更新：

  • 商家在您的系统中更改其时间安排（库存状况）后。
  • 当用户预订系统中的预订且可用性空档不再可用时。
  • 如果您使用的是与 CheckAvailability 的旧版集成，则预订服务器 CheckAvailability 调用会返回与实际商品目录不匹配的商品目录。

仅部分 Maps Booking API 调用是必需的。以下几项是必需的：

根据集成的类型，以下配置可能也可用或必不可少：

更新预订 RTU

如果您的系统上的“通过 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)：完全替换单个商家和服务的可用性。

如需了解详情，请参阅以下参考文档。

实时更新必须使用与通过 Feed 发送的数据相同的可用性结构。它们必须使用以下格式之一：

  • spotsOpen
  • recurrence

选择要调用的替换方法

您可以参考以下指南来确定哪种替换方法更合适：

  • 一项预订是否会影响多项服务？例如，发型和着色（每一项都是不同的服务）都是通过造型师预订的，因此应与相应时间段的造型师关联的所有服务。
  • 您的系统将不时更新 Google 的数据，方法是发送自上次更新以来的所有可用性变更（不推荐）。
    • 批量替换
    • 注意：我们希望在您更新后 5 分钟内发送商品目录 RTU。因此，您至少应每 5 分钟检查并发送一次更新。
  • 以上都不适用？
    • 单个替换
    • 注意：您可以使用多个单个替换调用来模拟批量替换调用，但使用单个批量替换调用会更加高效

实时更新：Spot 开放格式

请务必在 Feed、预订服务器和实时更新中使用相同的格式。

spots_open Feed 代码段如下所示：

Feed 代码段

   "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 预订的下一个每日 Feed 中的活动：

Feed 代码段

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

实时更新：重复格式

请务必在 Feed、预订服务器和实时更新中使用相同的格式。

使用重复周期的 Feed 如下所示：

Feed 代码段

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

下例说明了下个每日 Feed 的预期变化。请注意，它就是该商家对整个服务的可用性，以及它之前和现在的所有 schedule_exceptions：

Feed 代码段

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

何时提交实时更新

每当可用性发生变化时，都应持续发送实时更新。 这是对全面可用性 Feed 的补充，您应每天提交一次此类 Feed，以确保您和 Google 系统之间的可用性同步。