피드 만들기
데이터가 Google에 직접 표시되려면 피드를 Google에 정기적으로 제공해야 합니다. 다음 피드가 필요합니다.
| 피드 | 설명 | 빈도 |
|---|---|---|
| 전문가 | 전문가를 설명하는 데이터(전문가와의 예약을 위한 서드 파티 링크 포함)가 포함됩니다. (상응하는 역할: FHIR 전문가) . [특정 전문가와의 예약에만 필요] | 24시간마다 한 번 |
| 시설 | 실험실 테스트 센터, 클리닉과 같은 의료 시설/위치를 설명하는 데이터를 포함하며, 시설 예약을 위한 서드 파티 링크도 포함됩니다. (상위 요소: FHIR 위치) | 24시간마다 한 번 |
| 상담 유형 | ID 및 이름을 포함한 모든 약속 유형의 목록을 포함합니다. 예: 진단, 질병, 신규 환자 일정을 좁히는 데 참고로 사용됩니다. (상위 요소: FHIR 약속 유형) | 24시간마다 한 번 |
| 제공 지역 | 지정된 의료인, 시설, 서비스 유형, 상담 유형의 이용 가능 시간대를 나열합니다. (대응 항목: FHIR 슬롯) 각 의료인, 시설, 약속 유형 조합에 대해 다음으로 사용 가능한 슬롯부터 최소 24시간의 적용 범위가 제공되어야 합니다. | 15~60분마다 한 번 |
| 전환 | 링크 방문 및 예약 완료 측정항목을 포함하여 전환율을 Google과 공유합니다. | 매주 1회 |
피드 형식은 프로토콜 버퍼 3 구문으로 설명되지만 피드 샘플을 참고하여 JSON 형식을 확인할 수 있습니다. JSON 형식으로 피드를 업로드하는 것이 좋습니다.
피드 파일 크기, 샤딩, 압축
압축 및 샤드에 관한 다음 튜토리얼을 참고하세요.피드의 크기를 결정하려면 다음 가이드라인을 참고하세요 (피드는 '샤드'라고 하는 여러 파일로 구성할 수 있습니다).
- 추천 피드 샤딩:
- 전문가 피드: 샤드 1개
- 시설 피드: 샤드 1개
- 약속 유형 피드: 샤드 1개
- 전환 피드: 샤드 1개
- 이용 가능 여부 피드: 샤드 20개 미만
- 피드 파일의 크기 및 샤딩:
- 샤드 파일 크기를 200MB 미만으로 유지합니다(압축 후). 필요한 경우 여러 개의 샤드를 사용합니다.
- 하나의 샤드로 전송되는 개별 레코드는 이후 피드에서 동일한 샤드로 전송하지 않아도 됩니다.
- 성능을 향상하려면 데이터를 샤드 간에 균등하게 분할하여 모든 샤드 파일의 크기를 비슷하게 만듭니다.
- 필요한 경우 gzip을 사용하여 일반 텍스트 JSON 피드를 압축합니다. 단, 개별 피드 샤드에 대해 이 작업을 실행합니다.
SFTP 보관용 계정에 피드 업로드
피드 업로드를 시작하려면 먼저 설정 안내를 완료하세요. 그런 다음 파트너 포털의 피드 페이지로 이동합니다. 모든 피드는 일반 계정에 업로드해야 합니다.
각 피드는 파일 세트 설명자 파일과 함께 SFTP를 통해 별도로 업로드해야 합니다.
파일 세트 설명자의 파일 이름은 <feed_name>-<
generation_timestamp>.filesetdesc.json이어야 하며 여기서 <feed_name>은 healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type, healthappointments.availability일 수 있습니다.
자세한 내용은 일반 피드 보관용 계정 사용을 참고하세요. 예시는 샘플 페이지에서 확인할 수 있습니다.
데이터가 올바른지 확인
파트너 포털에 로그인합니다. 샌드박스 환경으로 전환하여 대시보드 섹션에서 다음 페이지를 찾습니다.
- 피드
- 피드 요약 통계를 표시하고 피드를 업로드하는 동안 발생한 오류를 표시합니다.
샌드박스 환경에 처음 업로드한 후 데이터가 올바른지 확인하려면 피드 페이지에서 피드 오류가 있는지 확인하세요.
프로덕션에 피드 업로드
오류가 없는 완전한 피드를 샌드박스 환경에 지속적으로 업로드할 수 있게 되면 프로덕션 환경에 업로드를 시작할 수 있습니다. 이 시점에서는 통합이 게시되지 않습니다.
프로덕션 피드 데이터가 모두 일관되게 업로드되고 프로덕션 시스템에 연결되면 피드를 검토할 수 있습니다.
Google에서 피드 평가
피드를 업로드하면 Google에서 피드를 처리하고 피드의 품질과 완전성을 평가합니다.