예약 서버 준비 완료

Actions Center에서 사용자를 대신하여 예약을 만들고 업데이트하는 콜백을 실행하려면 예약 서버가 필요합니다. 이렇게 하면 Actions Center에서 사용자를 대신하여 약속 및 예약을 만들 수 있습니다.

샌드박스 및 프로덕션 예약 서버에 대한 연결을 구성하는 방법을 알아보려면 예약 서버 사용자 인증 정보 구성을 참고하세요.

실시간 업데이트로 이동하기 전에 다음 예약 서버 준비 작업을 완료하세요.

샌드박스 예약 흐름을 통해 예약 서버 요청에 정확한 실시간 재고 세부정보를 전송하면 각 작업이 완료된 것으로 표시되고 녹색으로 바뀝니다. 예약 서버 마일스톤은 14일 동안 분석됩니다.

REST API 인터페이스 구현

REST를 기반으로 API 인터페이스를 구현합니다 . 이렇게 하면 Google에서 HTTPS를 통해 예약 서버 요청을 보낼 수 있습니다.

API 인터페이스를 구현하려면 Actions Center 샌드박스 환경에 연결되는 개발 또는 샌드박스 예약 서버를 설정하세요. 샌드박스 서버가 완전히 테스트된 후에만 프로덕션 환경으로 이동합니다.

모든 Google 예약 서버 요청은 예약 서버 페이지에 설정된 예약 서버 URL을 기준으로 합니다. 예를 들어 URL이 api.example.com/google로 설정된 경우 모든 HealthCheck 요청이 api.example.com/google/v3/HealthCheck로 전송됩니다.

환경 전환 도구를 사용하여 샌드박스 및 프로덕션 환경 모두에 올바른 예약 서버 엔드포인트가 구성되어 있는지 확인합니다.

보안 및 인증

예약 서버와의 모든 통신은 기본 인증을 사용하여 HTTPS를 통해 이루어집니다. 서버를 설정하는 데 도움이 되도록 공개적으로 제공되는 SSL 또는 TLS 확인 도구(예: Qualys SSL 서버 테스트)를 사용하는 것이 좋습니다.

Google에서 예약 서버에 보내는 모든 요청은 HTTPS 기본 인증으로 인증됩니다. Actions Center의 예약 서버 구성 페이지에서 예약 서버의 기본 인증 정보, 비밀번호, 사용자 이름을 입력할 수 있습니다. 사용자 인증 정보는 6개월마다 변경해야 합니다.

예약 서버 빌드

예약 서버는 통합이 시스템과 통신하는 방법과 예약을 실행하거나 업데이트하는 방법을 결정합니다. 샌드박스 및 프로덕션 예약 서버에 대한 연결을 구성하려면 예약 서버 사용자 인증 정보 구성을 참고하세요.

예약 서버에서 Google 예약의 요청에 대해 실행하는 모든 응답에는 정확한 실시간 재고 세부정보가 포함되어야 합니다. 다음 표에는 각 구현의 메서드가 표시되어 있으며, 서비스 프로토콜 형식에 대한 링크도 포함되어 있습니다.

메서드 정의 응답 HTTP 요청
BatchAvailabilityLookup 페이지 로드

사용자가 판매자의 테이블 예약 을 클릭하면 페이지 로드 시 BatchAvailabilityLookup 요청이 호출됩니다.

페이로드에는 Google 예약에서 사용 가능한 것으로 간주하는 최신 피드 업로드를 기반으로 하는 여러 슬롯이 포함되어 있습니다.

 응답에는 모든 슬롯 요청과 슬롯의 현재 사용 가능 여부가 포함되어야 합니다. 이렇게 하면 사용할 수 없는 슬롯이 표시되지 않습니다. POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup 슬롯 클릭 사용자에게 예약 가능한 슬롯이 표시되고 슬롯을 클릭하면 슬롯 클릭에 대해 BatchAvailabilityLookup 요청이 호출됩니다. 응답은 슬롯의 현재 실제 사용 가능 여부를 나타내야 합니다. 슬롯 클릭 전에 예약이 완료된 경우 사용할 수 없다는 응답을 반환합니다. POST /v3/BatchAvailabilityLookup/
CreateBooking 사용자가 예약 모달에서 선택한 시간 슬롯을 예약하려는 것을 확인하면 CreateBooking 요청이 전송됩니다.

응답은 예약의 성공 또는 실패를 나타내야 합니다.

예약이 실패하면 실패의 구체적인 이유를 반환해야 합니다. 예를 들어 슬롯이 예약되기 전에 CreateBooking 응답이 호출되었습니다.

예약이 성공적으로 생성되면 응답에 향후 요청 또는 업데이트에서 예약을 참조할 수 있는 고유한 booking_id가 포함됩니다.

 POST /v3/CreateBooking/
UpdateBooking Google 예약을 통해 예약이 완료된 후 사용자는 예약을 수정할 수 있습니다. 사용자가 예약을 업데이트하거나 취소하면 UpdateBooking 요청이 전송됩니다. CreateBooking 응답과 마찬가지로 UpdateBooking에 대한 응답은 예약의 성공을 나타내거나 실패의 구체적인 이유를 반환해야 합니다. POST /v3/UpdateBooking/
HealthCheck Actions Center는 인프라가 활성 상태이고 실행 중인지 확인하기 위해 예약 서버를 정기적으로 호출합니다.

서버의 서비스 제공 상태를 나타내려면 HTTP 상태 코드를 사용하세요. 서버가 활성 상태이고 실행 중인 경우 HTTP 상태 코드 200을 반환합니다.

오류를 나타내거나 통합을 일시적으로 오프라인 상태로 전환하려면 적절한 2xx가 아닌 HTTP 상태 코드를 반환합니다.

 GET /v3/HealthCheck/

마일스톤 기준

예약 서버 준비 마일스톤을 완료하려면 통합이 샌드박스 및 프로덕션 환경에서 다음 기준을 충족해야 합니다.

메서드 필수 요청 수(샌드박스) 필수 요청 수(프로덕션) 필수 성공률
BatchAvailabilityLookup 페이지 로드 20 20 90%
BatchAvailabilityLookup 슬롯 클릭 20 20 90%
CreateBooking 10 3 90%
UpdateBooking 10 3 90%

샌드박스 예약 흐름

샌드박스 예약 흐름을 보려면 Actions Center 인벤토리 보기로 이동하세요. 인벤토리 보기의 RwG - E2E 열에는 일치하고 향후 사용 가능 여부가 있는 샌드박스 판매자의 샌드박스 예약 흐름에 대한 라이브 (샌드박스) 링크가 표시됩니다.

예약 흐름의 작업은 다음과 같습니다.

  • RwG - E2E 링크를 클릭하면 페이지 로드 시 BatchAvailabilityLookup 요청이 트리거되고 판매자의 알려진 사용 가능 여부가 표시됩니다.

  • 예약 시간을 클릭하면 슬롯 클릭 요청 시 BatchAvailabilityLookup이 트리거되고 예약 모달이 표시됩니다.

  • 예약 모달로 예약을 완료하여 CreateBooking 요청을 전송합니다.

  • 샌드박스 환경에서 예약을 완료하면 예약을 만드는 데 사용된 계정으로 예약 세부정보가 포함된 확인 이메일이 전송됩니다.

  • UpdateBooking 메서드를 트리거하려면 이메일에서 예약을 변경하거나 취소하세요.

HealthCheck

샌드박스 및 프로덕션에서 HealthCheck 메서드를 구현해야 합니다. 예약 서버 상태를 반환하는 메서드입니다. 이를 통해 Google에서 예약 서버의 서비스 제공 상태를 지속적으로 모니터링할 수 있습니다.

요청: 없음

반환 값: 없음

서버의 서비스 제공 상태를 나타내려면 HTTP 상태 코드를 사용하세요.

서버가 활성 상태이고 실행 중인 경우 HTTP 상태 코드 200을 반환하고, 오류를 나타내려면 HTTP 상태 코드 중 하나를 반환하세요.