권장사항

다음 권장사항은 액션 센터 지역 서비스 광고 엔드 투 엔드 통합에 적용되며 사용성 및 성능 문제를 방지하는 데 활용할 수 있습니다. 데이터 품질이 낮으면 인벤토리가 게시 중단될 수 있습니다.

피드

  • 서비스의 길이가 설정되지 않은 경우 이용 가능 여부 피드에서 duration_sec를 다음 중 하나로 설정합니다.
    • 적절한 방식으로 서비스를 실행하는 데 걸리는 초 수입니다.

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

  • 판매자 피드의 Category 필드 입력을 구체적으로 만듭니다. 예를 들어 음식점의 경우 프렌치 또는 일식과 같이 구체적인 유형을 제출할 수 있습니다. 자세한 내용은 장소 유형의 잠재적 카테고리 값을 참고하세요.

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

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

  • gzip를 사용하여 피드 압축하기

예약 서버

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

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

실시간 업데이트

예약 절차 중에 최상의 사용자 환경을 제공하려면 다음 단계를 따르세요.

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