Tạo nguồn cấp dữ liệu
Nguồn cấp dữ liệu phải được cung cấp thường xuyên cho Google để dữ liệu được hiển thị trực tiếp trên Google. Bạn cần có các nguồn cấp dữ liệu sau.
Nguồn cấp dữ liệu | Nội dung mô tả | Tần suất |
---|---|---|
Chuyên viên | Chứa dữ liệu mô tả về các chuyên viên, bao gồm cả các đường liên kết của bên thứ ba để đặt lịch hẹn với những chuyên viên. (phần đối chiếu: Chuyên viên FHIR) . [Chỉ bắt buộc đối với việc đặt chỗ với những người hành nghề cụ thể] | 24 giờ một lần |
Cơ sở vật chất | Chứa dữ liệu mô tả các cơ sở/địa điểm chăm sóc sức khoẻ, chẳng hạn như trung tâm xét nghiệm và phòng khám, trong đó có các đường liên kết của bên thứ ba để đặt phòng tại cơ sở y tế. (phần đối chiếu: vị trí FHIR) | 24 giờ một lần |
Loại cuộc hẹn | Chứa danh sách tất cả loại cuộc hẹn, bao gồm cả mã cuộc hẹn và tên. Ví dụ: khám, bệnh nhân mới và bệnh nhân mới. Bản sao này sẽ được dùng làm tài liệu tham khảo để thu hẹp lịch biểu. (phần đối chiếu: loại cuộc hẹn FHIR) | 24 giờ một lần |
Phạm vi cung cấp | Liệt kê các khung giờ còn trống cho những người hành nghề, cơ sở vật chất, loại dịch vụ và loại cuộc hẹn nhất định. (đối chiếu: vùng FHIR) Bạn phải cung cấp thông tin tối thiểu là 24 giờ kể từ khung giờ trống tiếp theo cho từng tổ hợp người hành nghề, cơ sở và loại hình cuộc hẹn. | 15-60 phút một lần |
Lượt chuyển đổi | Chia sẻ tỷ lệ chuyển đổi cho Google, bao gồm cả các chỉ số về việc truy cập vào đường liên kết và hoàn tất cuộc hẹn đặt trước. | Mỗi tuần một lần |
Định dạng nguồn cấp dữ liệu được mô tả bằng cú pháp vùng đệm giao thức 3, tuy nhiên, bạn có thể tham khảo Mẫu nguồn cấp dữ liệu để xem định dạng JSON. Bạn nên tải nguồn cấp dữ liệu lên ở định dạng JSON.
Kích thước tệp, phân đoạn và nén nguồn cấp dữ liệu
Vui lòng xem các hướng dẫn sau về cách nén và phân đoạn:Để xác định kích thước của nguồn cấp dữ liệu, hãy sử dụng các nguyên tắc sau (một nguồn cấp dữ liệu có thể được cấu thành từ nhiều tệp được gọi là "phân đoạn"):
- Tính năng phân đoạn nguồn cấp dữ liệu được đề xuất:
- Nguồn cấp dữ liệu của chuyên viên: 1 phân đoạn
- Nguồn cấp dữ liệu cơ sở: 1 phân đoạn
- Nguồn cấp dữ liệu loại cuộc hẹn: 1 phân đoạn
- Nguồn cấp dữ liệu lượt chuyển đổi: 1 phân đoạn
- Nguồn cấp dữ liệu về tình trạng còn hàng : ít hơn 20 phân đoạn
- Kích thước của tệp nguồn cấp dữ liệu và phân đoạn:
- Giữ kích thước tệp phân đoạn dưới 200 MB (sau khi nén). Sử dụng nhiều phân đoạn nếu cần.
- Bạn không cần gửi từng bản ghi riêng lẻ được gửi trong một phân đoạn trong các nguồn cấp dữ liệu sau này.
- Để có hiệu suất tốt hơn, hãy chia dữ liệu đồng đều giữa các phân đoạn để làm cho tất cả các tệp phân đoạn có kích thước tương tự nhau.
- Nếu cần, hãy sử dụng gzip để nén nguồn cấp dữ liệu JSON dạng văn bản thuần tuý. Tuy nhiên, hãy làm như vậy cho từng phân đoạn nguồn cấp dữ liệu riêng lẻ.
Tải nguồn cấp dữ liệu lên Dropbox SFTP
Để bắt đầu tải nguồn cấp dữ liệu lên, trước tiên, hãy hoàn thành hướng dẫn Thiết lập. Sau đó, hãy chuyển đến trang nguồn cấp dữ liệu trong cổng thông tin của đối tác. Bạn phải tải tất cả nguồn cấp dữ liệu lên tài khoản Chung.
Bạn cần tải riêng từng nguồn cấp dữ liệu lên thông qua Giao thức truyền tệp bảo mật (SFTP) với một tệp chỉ số mô tả nhóm tệp.
Tên tệp của một chỉ số mô tả nhóm tệp phải là <feed_name>-<
generate_timestamp>.filesetặn.json,
trong đó <feed_name> có thể là
healthappointments.practitioner
, healthappointments.facility
,
healthappointments.appointment_type
và healthappointments.availability
.
Hãy xem bài viết Sử dụng tài khoản đăng nguồn cấp dữ liệu chung để biết thêm thông tin. Bạn có thể xem ví dụ trên trang Mẫu của chúng tôi.
Xác nhận rằng dữ liệu của bạn chính xác
Đăng nhập vào Cổng đối tác. Hãy chuyển sang môi trường Hộp cát để tìm các trang sau trong phần Trang tổng quan.
- Nguồn cấp dữ liệu
- Cho thấy số liệu thống kê tóm tắt nguồn cấp dữ liệu và chỉ ra các lỗi trong quá trình tải nguồn cấp dữ liệu lên.
Để xác nhận rằng dữ liệu của bạn chính xác sau lần đầu bạn tải dữ liệu lên môi trường hộp cát, hãy kiểm tra trang Nguồn cấp dữ liệu để xem có lỗi nào về nguồn cấp dữ liệu hay không.
Tải nguồn cấp dữ liệu lên kênh phát hành công khai
Sau khi có thể tải nguồn cấp dữ liệu hoàn chỉnh, không có lỗi lên môi trường Hộp cát một cách nhất quán, bạn có thể bắt đầu tải lên môi trường Phát hành công khai. Tại thời điểm này, chức năng tích hợp của bạn sẽ không hoạt động.
Khi tất cả dữ liệu trong nguồn cấp dữ liệu sản xuất của bạn được tải lên một cách nhất quán và kết nối với hệ thống sản xuất, nguồn cấp dữ liệu đó đã sẵn sàng để được xem xét.
Google đánh giá nguồn cấp dữ liệu
Sau khi bạn tải nguồn cấp dữ liệu lên, Google sẽ xử lý và đánh giá các nguồn cấp dữ liệu đó về chất lượng và tính hoàn chỉnh.