设计实时更新的结构

实时更新的使用场景

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

  • 用户取消您系统上的预订,且空档变为 可用。
  • 当用户通过操作中心和 无法再使用。
  • 如果您的设备上通过操作中心进行的预订被取消, 例如由商家直接上传您需要更新 因为原始空档现在位于 。

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

  • 商家在您系统上更改其时间表(库存状况)。
  • 用户在您的系统和可用性空档进行预订时 已无法再使用。
  • 如果您使用的是旧版集成 CheckAvailability、 预订服务器 CheckAvailability 调用会返回与实际广告资源不匹配的广告资源。

并非所有 Maps Booking API 调用都是必需的。以下几项是强制性的:

根据集成类型,可能还需要提供或必须安装以下组件:

更新预订 RTU

如果对 Actions Center 预订进行了更新(例如,取消或 会造成的影响, notification.partners.bookings.patch (BookingNotification.UpdateBooking) 。

可修改的字段

  • status
  • startTime
  • duration
  • partySize
  • paymentInformation.prepaymentStatus
。 <ph type="x-smartling-placeholder">

取消示例

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

<ph type="x-smartling-placeholder">

有两种类型的替换方法可用于更新 库存状况:

  • 批量替换 (InventoryUpdate.BatchServiceAvailability): 完全替换一个商家和多个 服务。
    • 注意:此批量调用不保证原子性。仅限 将返回已成功更新的可用性空档。
  • 单次替换 (InventoryUpdate.ReplaceServiceAvailability): 完全取代单个商家和服务的可用性。

请使用以下 如需了解详情,请参阅参考文档

实时更新必须使用与数据相同的可用性结构 通过 Feed 发送的请求必须使用以下项之一:

  • spotsOpen
  • recurrence

选择要调用的替换方法

使用以下指南帮助您确定哪种替换方法更为有效 适合:

  • 单次预订会影响多项服务吗?例如,理发 而且配色服务(每项服务都是不同的服务)则由发型师预约, 与该时间空档相关联的造型师服务应予以移除。
  • 您的系统会不时地与 Google 同步, 自上次更新后库存状况更改过(不推荐)。
    • 批量替换
    • 注意:我们预计会在更新后的 5 分钟内发送广告资源 RTU 。因此,您应该至少每 5 分钟检查并发送一次更新。
  • 以上解答皆不适用?
    • 单次替换
    • 注意:您可以使用多个替换调用来模拟 但使用单个替换调用会更高效, 批量替换调用

实时更新:Spots Open 格式

请务必在 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 代码段

"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"
        }
      ]
<ph type="x-smartling-placeholder">

实时更新:重复规则格式

请务必在 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"
                }
              }
            ]
          }
        ]
      }
    ]
  }
<ph type="x-smartling-placeholder">

下面的示例展示了下个每日 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 的补充,应 每天提交一次,以确保库存状况同步 您的系统与 Google 的系统之间。