フィードの作成
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 を使用できます。
詳しくは、汎用フィード ドロップボックスを使用するをご覧ください。例については、サンプルページをご覧ください。
データが正しく表示されることを確認する
パートナー ポータルにログインします。[サンドボックス] 環境に切り替えると、[ダッシュボード] セクションに次のページが表示されます。
- フィード
- フィードの概要の統計情報が表示され、フィードのアップロード中のエラーを確認できます。
サンドボックス環境への最初のアップロード後にデータが正しく表示されることを確認するには、[フィード] ページでフィードのエラーがないか確認します。
フィードを本番環境にアップロードする
エラーのない完全なフィードをサンドボックス環境へ定期的にアップロードできるようになったら、本番環境へのアップロードを開始します。この時点では、統合は有効になりません。
すべての本番環境フィードデータが一貫してアップロードされ、本番環境システムに接続されると、フィードは審査できる状態になります。
Google がフィードを評価する
アップロードしたフィードは、Google が処理し、品質と完全性を評価します。