권장사항

다음 권장사항은 Google 예약 엔드 투 엔드 통합에 적용되며 사용성 및 성능 문제를 방지하는 데 활용할 수 있습니다. 데이터 품질이 낮으면 인벤토리 게시 중단이 발생할 수 있습니다.

피드

  • 서비스에 설정된 길이가 없으면 이용 가능 여부 피드의 duration_sec를 다음 중 하나로 설정합니다.
    • 서비스를 합리적인 방식으로 수행하는 데 걸리는 시간(초)입니다.

    • 서비스를 완료하는 데 필요한 평균 시간(초)입니다.

  • 판매자 피드의 Category 필드 입력을 지정합니다. 예를 들어 레스토랑의 경우 프랑스어 또는 일본어와 같은 특정 유형을 제출할 수 있습니다. 자세한 내용은 장소 유형의 잠재적 카테고리 값을 참고하세요.

  • 도서 버튼 아래에 다음 메모가 표시되도록 판매자 피드의 Terms 필드에서 판매자별 서비스 약관을 설정합니다.

    계속 진행하면 <merchant>의 서비스 약관에 동의하는 것으로 간주됩니다.
    이 경우 '서비스 약관'은 링크를 클릭하면 약관 텍스트 필드에 표시된 텍스트를 표시하는 링크입니다.

  • gzip를 사용하여 피드 압축

예약 서버

Maps Booking API 통합을 최적화하려면 다음을 따르세요.

  • 항상 UTC 타임스탬프를 UTC 형식으로 사용합니다.
  • CreateBooking API에서 새 예약이 호출될 때 고유 예약 ID를 생성합니다.

실시간 업데이트

예약 과정에서 최적의 사용자 환경을 제공하려면 다음을 따르세요.

  • 표준 구현의 경우 BookingNotifications API를 사용하여 예약의 시작 시간, 기간 및 예약 상태(예: 취소 또는 예약 불이행)를 변경할 수 있습니다.
  • 측에서 Google 예약이 변경되면 항상 BookingNotification API를 통해 시스템에서 실시간 예약 업데이트를 실시간으로 전송하여 데이터가 Google 예약에서 비활성 상태가 되지 않도록 하세요. 예를 들어 Google 예약의 시스템에서 예약을 취소, 일정 변경, 업데이트할 수 있습니다.
  • UpdateBookingRequest의 모든 예약 업데이트의 경우 UpdateBookingResponse 값에 예약 ID가 포함되어 있고 업데이트된 모든 필드에 새 값이 반영되어야 합니다.
  • 인벤토리 RTU가 구현된 경우
    • API 호출당 슬롯 100~1,000개 단위로만 이용 가능 여부를 업데이트합니다.
    • *Restrict (예: startTimeRestrict) 필드를 사용하여 수정 대상을 좁히고 페이로드 크기를 줄이며 변경되지 않은 데이터가 너무 많이 재전송되지 않게 하세요.
    • 여러 스레드를 가동하는 경우 지수 백오프를 구현하여 제한 오류를 방지합니다. 지수 백오프를 올바르게 구현하지 않으면 RESOURCE_EXHAUSTED 할당량 오류가 발생할 수 있습니다. 이를 처리하기 위해 지수 백오프를 다시 시도할 수 있지만 ReplaceServiceAvailability을 실행할 때 서버가 할당량에 자주 도달하는 경우 가용성을 일괄 교체하도록 서버를 구성합니다. 이 솔루션은 서비스가 수행해야 하는 API 호출 수를 줄여주기 때문에 할당량 오류를 방지합니다.
  • API 호출 응답 시간 제한을 1초 미만으로 설정하세요. 서버가 95% 이상의 시간 동안 1초 미만의 지연 시간으로 5개의 초당 쿼리 수 (QPS)를 처리할 수 있는지 확인합니다.