피드 만들기
데이터가 Google에 직접 표시되려면 정기적으로 피드를 Google에 제공해야 합니다. 다음 피드가 필요합니다.
| 피드 | 설명 | 주파수 |
|---|---|---|
| 실무자 | 전문직 종사자를 설명하는 데이터가 포함되며 여기에는 전문직 종사자 예약으로 연결되는 서드 파티 링크가 포함됩니다. (상대자: FHIR 실무자) [특정 전문직 종사자와의 예약 시에만 필수] | 24시간마다 |
| 시설 | 실험실 테스트 센터 및 클리닉과 같이 의료 시설/위치를 설명하는 데이터가 포함되며, 시설 예약으로 연결되는 서드 파티 링크가 포함됩니다. (상응 부분: FHIR 위치) | 24시간마다 |
| 약속 유형 | ID와 이름을 포함한 모든 약속 유형의 목록을 포함합니다. 예: 건강 검진, 아픈 환자, 신규 환자 이 정보는 일정 범위를 좁히는 데 참고용으로 사용됩니다. (상대 부분: FHIR 예약 유형) | 24시간마다 |
| 제공 지역 | 지정된 전문직 종사자, 시설, 서비스 유형, 예약 유형의 이용 가능 시간대를 나열합니다. (상대: FHIR 시간대) 전문직 종사자, 시설, 예약 유형 조합별로 이용 가능한 다음 시간대부터 최소 24시간의 보장이 제공되어야 합니다. | 15~60분마다 |
| 전환 | 링크를 방문하고 예약을 완료하기 위한 측정항목을 포함한 전환율을 Google과 공유합니다. | 매주 한 번 |
피드 형식은 프로토콜 버퍼 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에서 피드를 처리하고 품질과 완전성을 평가합니다.