Tạo nguồn cấp dữ liệu
Bạn phải thường xuyên cung cấp nguồn cấp dữ liệu 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 | Mô tả | Tần suất |
|---|---|---|
| Người hành nghề | Chứa dữ liệu mô tả các chuyên gia, bao gồm cả đường liên kết của bên thứ ba để đặt lịch hẹn với các chuyên gia. (đối tác: người hành nghề FHIR) . [Chỉ bắt buộc đối với những người đặt chỗ với một số chuyên gia trị liệu cụ thể] | 24 giờ một lần |
| Cơ sở | Chứa dữ liệu mô tả các cơ sở/vị trí chăm sóc sức khoẻ, chẳng hạn như trung tâm xét nghiệm và phòng khám, bao gồm cả đường liên kết của bên thứ ba để đặt phòng với các cơ sở đó. (phần tương ứng: 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 mã nhận dạng và tên. Ví dụ: khám sức khoẻ, bệnh nhân ốm và bệnh nhân mới. Giá trị này sẽ được dùng làm thông tin tham khảo để thu hẹp lịch biểu. (phần tương ứng: 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ờ trống cho một số bác sĩ, cơ sở, loại dịch vụ và loại cuộc hẹn nhất định. (phần tương ứng: khoảng thời gian FHIR) Bạn phải cung cấp thời gian bảo hiểm tối thiểu là 24 giờ kể từ khoảng thời gian có sẵn tiếp theo cho mỗi tổ hợp gồm bác sĩ, cơ sở và loại cuộc hẹn. | 15 đến 60 phút một lần |
| Lượt chuyển đổi | Chia sẻ tỷ lệ chuyển đổi với Google, bao gồm cả các chỉ số về lượt truy cập vào đường liên kết và lượt hoàn tất việc đặt lịch hẹn. | Một lần mỗi tuần |
Định dạng nguồn cấp dữ liệu được mô tả bằng ngữ 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 nguồn cấp dữ liệu, phân đoạn và nén
Vui lòng xem các hướng dẫn sau đây về việc nén và phân mảnh:Để 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ể bao gồm nhiều tệp được gọi là "mảnh"):
- Cách phân đoạn nguồn cấp dữ liệu được đề xuất:
- Nguồn cấp dữ liệu cho chuyên gia: 1 phân mảnh
- Nguồn cấp dữ liệu cơ sở: 1 phân mảnh
- Nguồn cấp dữ liệu loại cuộc hẹn: 1 phân mảnh
- Nguồn cấp dữ liệu lượt chuyển đổi: 1 phân mảnh
- Nguồn cấp dữ liệu về tình trạng phòng : ít hơn 20 phân đoạn
- Kích thước 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.
- Các bản ghi riêng lẻ được gửi trong một phân mảnh không cần phải được gửi trong cùng một phân mảnh 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 đều cho các phân đoạn để 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 văn bản thuần tuý. Tuy nhiên, hãy làm như vậy cho từng mảnh 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 SFTP
Để bắt đầu tải nguồn cấp dữ liệu lên, trước tiên, hãy hoàn tất 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 dành cho đố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 từng nguồn cấp dữ liệu lên qua SFTP bằng một tệp mô tả tập hợp tệp.
Tên tệp của chỉ số mô tả tập hợp tệp phải là <feed_name>-<
generation_timestamp>.filesetdesc.json, trong đó <feed_name> có thể là healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type và healthappointments.availability.
Hãy truy cập vào bài viết Sử dụng hộp thư mục chung cho nguồn cấp dữ liệu để biết thêm thông tin. Bạn có thể xem ví dụ trên trang Mẫu.
Xác nhận rằng dữ liệu của bạn có vẻ chính xác
Đăng nhập vào Cổng đối tác. 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
- 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 có vẻ chính xác sau lần tải lên đầu tiên vào 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 nguồn cấp dữ liệu nào không.
Tải nguồn cấp dữ liệu lên phiên bản chính thức
Khi có thể tải lên môi trường Hộp cát nguồn cấp dữ liệu hoàn chỉnh và không có lỗi một cách nhất quán, bạn có thể bắt đầu tải lên môi trường Chính thức. Tại thời điểm này, tính năng tích hợp của bạn sẽ chưa hoạt động.
Khi tất cả dữ liệu nguồn cấp dữ liệu chính thức 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 chính thức, nguồn cấp dữ liệu của bạn đã 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á chất lượng cũng như tính hoàn chỉnh của nguồn cấp dữ liệu đó.