실시간 업데이트 구조화

실시간 업데이트 사용 사례

실시간 업데이트는 항상 다음과 같은 경우에 실행해야 합니다.

  • 사용자가 시스템에서 예약을 취소하고 슬롯을 사용할 수 있게 되는 경우
  • 사용자가 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): 단일 판매자 및 서비스의 가용성을 완전히 대체합니다.

자세한 내용은 다음 참조를 확인하세요.

실시간 업데이트는 피드를 통해 전송되는 데이터와 동일한 가용성 구조를 사용해야 합니다. 다음 중 하나를 사용해야 합니다.

  • spotsOpen
  • recurrence

가용성 구조 가이드를 참조하여 어떤 형식이 더 적합한지 확인하세요.

교체할 메서드 선택

다음 가이드를 사용하여 더 적합한 대체 방법을 결정하세요.

  • 하나의 예약이 여러 서비스에 영향을 미치나요? 예를 들어 헤어컷과 색상 (각각 별개의 서비스)은 스타일리스트와 함께 예약되므로 스타일리스트에 연결된 모든 서비스는 해당 시간대에서 삭제해야 합니다.
  • 시스템이 마지막 업데이트 이후 모든 가용성 변경사항을 전송하여 Google과 수시로 동기화합니다 (권장되지 않음).
    • 일괄 교체
    • 참고: 업데이트가 적용된 후 5분 내에 인벤토리 RTU가 전송될 것으로 예상됩니다. 최소 5분마다 업데이트를 확인하고 전송해야 합니다.
  • 해당 사항 없음
    • 단일 대체
    • 참고: 여러 단일 교체 호출을 사용하여 일괄 교체 호출을 에뮬레이션할 수 있지만 단일 일괄 교체 호출을 사용하는 것이 더 효율적입니다.

실시간 업데이트: Spots Open 형식

피드, 예약 서버, 실시간 업데이트에서 동일한 형식을 사용하는 것이 중요합니다.

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 시스템 간에 재고가 동기화되도록 하기 위해 하루에 한 번 제출해야 하는 포괄적인 가용성 피드에 추가됩니다.