Langkah 2: Feed

Membuat feed

Feed harus diberikan ke Google secara rutin agar data dapat ditampilkan langsung di Google. Feed berikut diperlukan.

Feed Deskripsi Frekuensi
Praktisi Berisi data yang menjelaskan praktisi, yang mencakup link pihak ketiga untuk melakukan pemesanan dengan praktisi. (counterpart: FHIR practitioner) . [Hanya diperlukan untuk pemesanan dengan praktisi tertentu] Setiap 24 jam sekali
Fasilitas Berisi data yang menjelaskan fasilitas/lokasi layanan kesehatan, seperti klinik dan pusat pengujian lab, yang mencakup link pihak ketiga untuk melakukan pemesanan dengan fasilitas. (counterpart: FHIR location) Setiap 24 jam sekali
Jenis Janji Temu Berisi daftar semua jenis janji temu termasuk ID dan nama. Misalnya, pemeriksaan kesehatan, pasien sakit, dan pasien baru. Ini akan digunakan sebagai referensi untuk mempersempit jadwal. (counterpart: Jenis janji temu FHIR) Setiap 24 jam sekali
Ketersediaan Mencantumkan slot ketersediaan untuk praktisi, fasilitas, jenis layanan, dan jenis janji temu tertentu. (counterpart: slot FHIR) Cakupan minimal 24 jam mulai dari slot berikutnya yang tersedia harus diberikan untuk setiap kombinasi jenis janji temu, fasilitas, dan praktisi. Sekali setiap 15-60 menit
Konversi Membagikan rasio konversi kepada Google, termasuk metrik untuk membuka link dan menyelesaikan janji temu pemesanan. Seminggu sekali

Format feed dideskripsikan dengan sintaksis protocol buffer 3, tetapi Anda dapat mereferensikan Contoh feed untuk melihat format JSON. Sebaiknya upload feed dalam format JSON.

Ukuran, sharding, dan kompresi file feed

Tonton tutorial berikut terkait kompresi dan shard:

Untuk menentukan ukuran feed, gunakan panduan berikut (feed dapat terdiri dari beberapa file yang disebut "shard"):

  • Sharding feed yang disarankan:
    • Feed praktisi: 1 shard
    • Feed fasilitas: 1 shard
    • Feed jenis janji temu: 1 shard
    • Feed konversi: 1 shard
    • Feed ketersediaan: kurang dari 20 shard
  • Ukuran file feed dan sharding:
    • Pertahankan ukuran file shard di bawah 200 MB (setelah kompresi). Gunakan beberapa shard jika diperlukan.
    • Setiap catatan yang dikirim dalam satu shard tidak perlu dikirim dalam shard yang sama di feed mendatang.
    • Untuk mendapatkan performa yang lebih baik, bagi data secara merata di antara shard sehingga semua file yang di-sharding memiliki ukuran yang serupa.
    • Jika perlu, gunakan gzip untuk mengompresi feed JSON teks biasa. Namun, lakukan hal tersebut untuk setiap shard feed.

Mengupload feed ke Dropbox SFTP

Untuk mulai mengupload feed, selesaikan petunjuk Penyiapan terlebih dahulu. Setelah itu, buka halaman feed di portal partner. Semua feed harus diupload ke akun Generik.

Setiap feed harus diupload melalui SFTP secara terpisah dengan file deskripsi set file. Nama file deskripsi set file harus <feed_name>-< generation_timestamp>.filesetdesc.json, dengan <feed_name> dapat berupa healthappointments.practitioner, healthappointments.facility, healthappointments.appointment_type, dan healthappointments.availability.

Buka Menggunakan dropbox feed Generik untuk mengetahui informasi selengkapnya. Contoh tersedia di halaman Contoh kami.

Mengonfirmasikan bahwa data terlihat benar

Login ke Portal Partner. Beralih ke lingkungan Sandbox untuk menemukan halaman berikut di bagian Dashboards.

Feed
Menampilkan statistik ringkasan feed dan menunjukkan error selama upload feed.

Untuk mengonfirmasi bahwa data Anda terlihat benar setelah upload awal ke lingkungan sandbox, periksa halaman Feeds untuk melihat apakah ada error feed.

Mengupload feed ke produksi

Setelah Anda dapat secara konsisten mengupload feed lengkap yang bebas error ke lingkungan Sandbox, Anda dapat mulai mengupload ke lingkungan Produksi. Pada tahap ini, integrasi Anda tidak akan aktif.

Setelah semua data feed produksi Anda diupload secara konsisten dan terhubung ke sistem produksi, feed Anda siap untuk ditinjau.

Google mengevaluasi feed

Setelah Anda mengupload feed, Google akan memproses dan mengevaluasi kualitas serta kelengkapan feed tersebut.