이 페이지는 Cloud Translation API를 통해 번역되었습니다.

실시간 업데이트 구조화

실시간 업데이트 사용 사례

다음과 같은 시나리오에서는 항상 실시간 업데이트를 실행해야 합니다.

사용자가 시스템에서 예약을 취소하여 시간대를 사용할 수 있게 되는 경우
사용자가 Actions Center를 통해 예약하고 이용 가능 시간대를 더 이상 이용할 수 없는 경우
Actions Center를 통한 예약이 판매자 측에서 취소된 경우(예: 판매자가 직접 취소하는 경우) 이제 기존 시간대를 다시 이용할 수 있으므로 예약과 이용 가능 여부를 업데이트해야 합니다.

또한 재고 대체 RTU를 구현하는 경우 다음과 같은 시나리오에서 실시간 업데이트가 제공되어야 합니다.

판매자가 시스템에서 일정 (재고)을 변경하는 경우
사용자가 시스템에서 예약하고 이용 가능 시간대를 더 이상 이용할 수 없는 경우
CheckAvailability와 기존 통합을 사용하는 경우 예약 서버 CheckAvailability 호출 시 실제 인벤토리와 일치하지 않는 인벤토리가 반환됩니다.

모든 Maps Booking API 호출이 필요하지는 않습니다. 다음은 필수입니다.

notification.partners.bookings.patch (BookingNotification.UpdateBooking)

통합 유형에 따라 다음 항목이 사용 가능하거나 필요할 수 있습니다.

inventory.partners.availability.replace (InventoryUpdate.BatchServiceAvailability) 또는 inventory.partners.merchants.services.availability.replace (InventoryUpdate.ReplaceServiceAvailability)

예약 RTU 업데이트

시스템에서 Actions Center 예약을 업데이트 (예: 취소 또는 수정)한 경우 notification.partners.bookings.patch(BookingNotification.UpdateBooking)를 전송해야 합니다.

수정 가능한 필드

status
startTime
duration
partySize
paymentInformation.prepaymentStatus

참고: name, merchant_id, service_id와 변경되는 특정 필드를 지정해야 합니다. 다른 입력란은 선택사항입니다. 상황에 따라 여러 필드가 동시에 변경될 수 있습니다. 이 경우 updateMask에서 필드를 쉼표로 구분하세요(예: updateMask=partySize,startTime).

취소 예시

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

참고: 더 이상 사용 가능하지 않은 경우 (spots_open는 0) Inventory API의 교체 요청을 전송할 수 있는 두 가지 형식이 있습니다.

명시적 지정: spots_total > 1가 있는 경우에 권장되는 메서드입니다.

  {
    "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": "0",
            "spotsTotal": "2",
            "availabilityTag": "1000001"
          }
        ]
      }
    ]
  }

빈 사양: 대부분의 판매자 및 서비스에서 spots_total = 1인 경우에만 권장됩니다.

  {
  "extendedServiceAvailability": [
    {
      "merchantId": "1001",
      "serviceId": "12310",
      "startTimeRestrict": "2014-10-02T15:01:23.045123456Z",
      "endTimeRestrict": "2014-10-02T19:01:23.045123456Z",
      "availability": [
        {}
      ]
    }
  ]
}

실시간 업데이트: 반복 형식

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

반복을 사용하는 피드는 다음과 같습니다.

피드 스니펫

  "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가 포함되어야 합니다. 그 이유는 API 메서드가 해당 특정 서비스와 판매자의 가용성을 대체하기 때문입니다. 다른 페이지로 대체하려면 이 정보가 해당 서비스의 이용 가능 여부에 대한 전체 정보여야 하며 이 서비스의 모든 예약 시간대를 포함해야 합니다.

다음은 다음 일일 피드에서 예상되는 내용의 예입니다. 이는 해당 판매자의 전체 서비스 가용성과 모든 이전 및 새로운 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 시스템 간에 이용 가능 여부를 동기화하기 위해 하루에 한 번 제출해야 하는 포괄적인 이용 가능 여부 피드에 추가됩니다.