フィードを作成する
データを Google に直接表示するには、フィードを Google に定期的に提供する必要があります。次のフィードが必要です。
| フィード | 説明 | 頻度 |
|---|---|---|
| Practitioner | 医療従事者に関するデータが含まれます。これには、医療従事者との予約へのサードパーティのリンクが含まれます。（対応する FHIR 担当者）[特定の施術者との予約の場合のみ必須] | 24 時間に 1 回 |
| 施設 | 医療機関や医療施設（検査センターやクリニックなど）を記述するデータが含まれます。これには、施設の予約に使用できるサードパーティのリンクが含まれます。（対応する FHIR ロケーション: ） | 24 時間に 1 回 |
| 予約の種類 | すべての予約タイプのリスト（ID と名前を含む）が含まれます。例: 健康診断、病気、新規患者。スケジュールを絞り込む際の参照として使用されます。 （対応する FHIR の予約タイプ: ） | 24 時間に 1 回 |
| 利用可能な国と地域 | 特定の医療従事者、施設、サービスタイプ、予約タイプの空き時間枠を一覧表示します。（対応する FHIR スロット: ）次の空きスロットから 24 時間以上のカバレッジを、医師、施設、予約タイプの組み合わせごとに提供する必要があります。 | 15 ～ 60 分ごとに 1 回 |
| コンバージョン数 | リンクへのアクセスや予約の完了に関する指標など、コンバージョン率を Google と共有します。 | 毎週 1 回 |
フィード形式は、プロトコル バッファ 3 の構文で記述されていますが、フィードのサンプルを参照して JSON 形式を確認できます。フィードを JSON 形式でアップロードすることをおすすめします。
フィード ファイルのサイズ、シャーディング、圧縮
圧縮とシャードに関する次のチュートリアルをご覧ください。フィードのサイズを決定するには、次のガイドラインを使用します（フィードは「シャード」と呼ばれる複数のファイルで構成される場合があります）。
- 推奨されるフィードのシャーディング:
- 医療従事者フィード: 1 個のシャード
- 施設フィード: 1 個のシャード
- 予約タイプ フィード: 1 個のシャード
- コンバージョン フィード: 1 個のシャード
- 空き状況フィード: 20 個未満のシャード
- フィード ファイルのサイズとシャーディング:
- （圧縮後の）シャード ファイルのサイズは 200 MB 未満に抑えます。必要に応じて、複数のシャードを使用します。
- 1 つのシャードで送信された個々のレコードを、今後のフィードの同じシャードで送信する必要はありません。
- パフォーマンスを向上させるには、シャード間でデータを均等に分割し、すべてのシャード ファイルを同じくらいのサイズにします。
- 必要に応じて、gzip を使用してプレーン テキストの JSON フィードを圧縮します。ただし、その場合には個々のフィード シャードごとに行ってください。
SFTP ドロップボックスにフィードをアップロードする
フィードのアップロードを開始するには、まず設定手順を完了します。その後、パートナー ポータルの [フィード] ページに移動します。すべてのフィードは、汎用アカウントにアップロードする必要があります。
各フィードは、ファイルセット記述子ファイルとともに SFTP 経由で個別にアップロードする必要があります。ファイルセット記述子のファイル名は <feed_name>-<generation_timestamp>.filesetdesc.json にする必要があります。ここで、<feed_name> は healthappointments.practitioner、healthappointments.facility、healthappointments.appointment_type、healthappointments.availability のいずれかです。
詳しくは、汎用フィード ドロップボックスの使用をご覧ください。サンプルは、 サンプルページで確認できます。
データが正しく表示されることを確認する
パートナー ポータルにログインします。サンドボックス環境に切り替えて、[ダッシュボード] セクションで以下のページを探します。
- フィード
- フィードの統計情報の概要が表示され、フィード アップロード中のエラーが報告されます。
サンドボックス環境に最初にアップロードしたデータが正しく表示されることを確認するには、[フィード] ページでフィードのエラーがないかを確認します。
フィードを本番環境にアップロードする
エラーのない完全なフィードをサンドボックス環境に一貫してアップロードできるようになると、本番環境へのアップロードを開始できます。この時点では、統合は公開されません。
本番環境フィードデータがすべて一貫してアップロードされ、本番環境システムに接続されたら、フィードは審査の準備が整います。
Google がフィードを評価する
フィードのアップロードが完了すると、Google はそれらのフィードを処理し、その品質と完全性を評価します。