BatchAvailabilityLookup 메서드

BatchCheckAvailabilityLookup이 발행되면 파트너 예약 서버에서 요청된 약속 시간대가 현재 유효하고 이용 가능한지 확인합니다. 예약 흐름 중에 현재 슬롯만 사용자에게 표시되도록 작업 센터에서 이를 사용할 수 있습니다.

요청

BatchAvailabilityLookupRequest

반환값

BatchAvailabilityLookupResponse

표준 gRPC 오류 코드

• INVALID_ARGUMENT(잘못된 판매자 ID, 서비스 ID 또는 시간대 사양)

message BatchAvailabilityLookupRequest {
  // ID of the merchant.
  string merchant_id = 1;

  // Multiple slot times to be checked for availability. All queried times apply
  // to the same merchant_id and service_id.
  repeated SlotTime slot_time = 3;

  reserved 2;
}

// Response for the [ext.maps.booking.partner.v2.BatchAvailabilityLookupRequest]
// RPC with the availabilities of the appointment slots.
message BatchAvailabilityLookupResponse {
  // The availabilities for the requested SlotTime entries. There must be
  // exactly one slot_time_availability for each SlotTime entry in the
  // [ext.maps.booking.partner.v2.BatchAvailabilityLookupRequest].
  repeated SlotTimeAvailability slot_time_availability = 1;
}

SlotTime 메시지는 파트너 측에서 쿼리될 슬롯을 정의합니다.

// Identifies a Slot service_id and start time and optionally, the Slot duration
// and resources, for a specific merchant. Note that this differs from the
// definition of Slot, as it does not include merchant_id identifier.
message SlotTime {
  // ID of the service. (required)
  string service_id = 5;

  // Start time of the appointment slot in seconds of UTC time since Unix epoch
  // (required)
  int64 start_sec = 1;

  // Duration of the appointment slot in seconds (optional)
  int64 duration_sec = 2;

  // Opaque tag that identifies the availability slot and matches the value
  // provided in the availability feed (optional)
  string availability_tag = 3;

  // The set of resources that specifies the appointment slot, e.g. by
  // indicating the staff member and room selected by the user, or party size
  // for dining slots (optional)
  Resources resources = 4;
}

이에 대한 응답으로 예약 서버에서 SlotTimeAvailability 메시지를 반환합니다.

message SlotTimeAvailability {
  // The SlotTime for which availability was checked.
  SlotTime slot_time = 1;

  // Whether the requested SlotTime is available
  bool available = 2;
}