フィードの作成
データを Google に直接表示するには、定期的にフィードを Google に提供する必要があります。次のフィードが必要です。
| フィード | 説明 | 周波数 |
|---|---|---|
| 実務担当者 | 開業者について説明するデータ（開業者との予約に関するサードパーティのリンクを含む）が含まれます。（対応: 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 がフィードを処理し、品質と完全性を評価します。