Tạo nguồn cấp dữ liệu
Nguồn cấp dữ liệu phải được cung cấp cho Google thường xuyên để dữ liệu xuất hiện 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 | Mô tả | Tần số |
|---|---|---|
| Chuyên viên | Chứa dữ liệu mô tả các chuyên viên, bao gồm cả đường liên kết của bên thứ ba để đặt lịch hẹn với những người hành nghề. (đối tác: Chuyên viên FHIR) . [Chỉ bắt buộc khi đặt vé 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ở/vị trí chăm sóc sức khỏe, như trung tâm xét nghiệm và phòng khám, trong đó có đường liên kết của bên thứ ba để đặt phòng. (đối tác: Vị trí FHIR) | 24 giờ một lần |
| Loại cuộc hẹn | Chứa danh sách tất cả các loại cuộc hẹn, bao gồm cả mã nhận dạng và tên. Ví dụ: thăm khám, bệnh nhân và bệnh nhân mới. Nó sẽ được dùng làm tệp đối chiếu để thu hẹp lịch biểu. (đối tác: 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ờ nhận đặt chỗ 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 tác: Khung giờ đã triển khai) Phải cung cấp tối thiểu 24 giờ bảo hiểm bắt đầu từ khung giờ tiếp theo để cung cấp cho từng bác sĩ, cơ sở và loại lịch hẹn. | 15-60 phút một lần |
| Thời gian | Chia sẻ tỷ lệ chuyển đổi với Google, bao gồm cả các chỉ số về việc truy cập vào các đường liên kết và hoàn tất các 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 giao thức bộ đệ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 nguồn cấp dữ liệu, phân đoạn và nén
Vui lòng xem 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 (nguồn cấp dữ liệu có thể được tạo thành từ nhiều tệp có tên là "phân đoạn"):
- Phân đoạn nguồn cấp dữ liệu được đề xuất:
- Nguồn cấp dữ liệu dành cho học viên: 1 phân đoạn
- Nguồn cấp dữ liệu về cơ sở vật chất: 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 chuyển đổi: 1 phân đoạn
- Nguồn cấp dữ liệu về tính sẵn có : dưới 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.
- Mỗi bản ghi được gửi trong một phân đoạn không cần phải được gửi trong cùng một phân đoạn trong các nguồn cấp dữ liệu trong tương lai.
- Để 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 các nguồn cấp dữ liệu JSON văn bản thuần túy. 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 tài khoản đăng qua 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 phần hướng dẫn Thiết lập. Sau đó, chuyển đến trang nguồn cấp dữ liệu trong cổng thông tin dành cho đối tác. Tất cả nguồn cấp dữ liệu phải được tải lên tài khoản General.
Bạn cần tải riêng từng nguồn cấp dữ liệu lên thông qua SFTP kèm theo tệp chỉ số mô tả tệp. Tên tệp của phần mô tả tệp phải là <feed_name>-< Generation_timestamp>.filesetDown.json, trong đó <feed_name> có thể là healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type và healthappointments.availability.
Hãy truy cập vào phần Sử dụng dropbox nguồn cấp dữ liệu chung để biết thêm thông tin. Bạn có thể xem các 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 là chính xác
Đăng nhập vào Cổng thông tin dành cho đối tác. Chuyển sang môi trường Sandbox để tìm các trang sau trong phần Trang tổng quan.
- Nguồn cấp dữ liệu
- Hiển thị số liệu thống kê tóm tắt về nguồn cấp dữ liệu và chỉ ra 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 trông chính xác sau lần tải lên môi trường hộp cát ban đầu, hãy kiểm tra trang Nguồn cấp dữ liệu để xem có lỗi về nguồn cấp dữ liệu hay không.
Tải nguồn cấp dữ liệu lên phiên bản chính thức
Sau khi có thể tải nguồn cấp dữ liệu hoàn chỉnh mà không gặp lỗi lên môi trường Hộp cát, bạn có thể bắt đầu tải lên môi trường Sản xuất. Tại thời điểm này, 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 chính thức của bạn đều được tải lên 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 của bạn sẽ sẵn sàng để 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á chất lượng và mức độ hoàn chỉnh của chúng.