임대 사양

임대는 요청된 슬롯의 소유권을 일시적으로 보유합니다.

파트너 백엔드에서 요청된 약속 시간대가 유효하고 아직 예약 가능한지 확인합니다. 내부적으로 파트너는 요청된 시간대를 일시적으로 보류하며 이 보류는 lease_expiration_time에 자동으로 만료되도록 설정됩니다. 예를 들어 요청된 임대 시간이 너무 긴 경우 백엔드에서 lease_expiration_time을(를) 수정할 수 있습니다. 생성된 임대가 클라이언트에 반환됩니다.

예약 API는 임대를 선택적으로 지원합니다. 임대 지원을 사용하면 예약을 생성할 때 요청한 슬롯의 임대를 만드는 것이 첫 번째 단계입니다.

// Temporary lease for an inventory slot
message Lease {
  // ID of the lease.
  // Not populated in CreateLeaseRequest. The value is chosen by the partner and
  // has to be returned in the response of CreateLease. (required)
  string lease_id = 1;

  // The appointment slot that the lease is created for. (required)
  Slot slot = 2;

  // Unique identifier for this lease, chosen by Reserve with Google. Serves as
  // an idempotency token for [ext.maps.booking.partner.v2.CreateLease]
  // requests. (required)
  string user_reference = 3;

  // Expiration time of the lease in UTC Timestamp (required)
  google.protobuf.Timestamp lease_expiration_time = 4;
}

// Reference to a [ext.maps.booking.partner.v2.Lease] that has been created via
// [ext.maps.booking.partner.v2.CreateLease]
message LeaseReference {
  // Lease ID (required)
  string lease_id = 1;
}

임대에 대한 추가 정보

임대 지원은 선택사항입니다. 지원을 구현하는 데 관심이 있는 파트너에게 적용됩니다. 시작하기 전에 Actions Center에 문의하여 자격 요건을 확인하세요.

임대를 지원하려면 권장 API v2 집합을 구현해야 합니다. 또한

• CreateLease를 구현해야 합니다.
• CreateBooking을 구현해야 하며 임대 참조를 사용해야 합니다. 파트너 백엔드는 제공된 임대 참조로 예약합니다.

API v2의 요구사항은 임대 지원에도 적용됩니다. 또한

• CreateBooking은 임대 참조를 사용해야 합니다. 제공된 임대 참조로 예약할 때 파트너는 임대를 소비하고 더 이상 예약에 사용할 수 없게 됩니다. 또한 파트너는 요청 메시지에 슬롯을 사용하여 생성된 예약을 확인해야 합니다.
• 추가 gRPC 오류 코드로 임대 참조를 제공하고 파트너에게 임대 ID를 알 수 없는 경우 NOT_FOUND가 사용됩니다.

그림: 임대에 대한 예약 만들기