フィードの作成
Google に直接データを表示するには、定期的に Google にフィードを提供する必要があります。次のフィードが必要です。
| フィード | 説明 | 周波数 |
|---|---|---|
| 販売者 | 販売者に関する情報。 | 24 時間に 1 回 |
| Service | 販売者が提供しているサービスについて説明する | 24 時間に 1 回 |
| 利用可能な国と地域 | 販売者が提供するサービスで利用可能なスロット。保証期間は 30 日以上にする必要があります。 | 24 時間に 1 回 |
各フィードには解釈方法を示す metadata を含めます。
フィード形式はプロトコル バッファ 3 の構文で記述されていますが、対応する JSON 形式でフィードをアップロードすることもできます。JSON 形式についてはフィード サンプルをご覧ください。 フィードは JSON 形式でアップロードすることをおすすめします。
フィードのファイルサイズ、シャーディング、圧縮
圧縮とシャードに関する次のチュートリアルをご覧ください。フィードのサイズを決定するには、次のガイドラインを使用します（「フィードはシャード」と呼ばれる複数のファイルで構成されます）。
- フィードのシャーディングに関する提案:
- 販売者フィード: 1 個のシャード
- サービス フィード: 1 個のシャード
- 空き状況フィード: 20 個未満のシャード
- フィード ファイルのサイズとシャーディング:
- （圧縮後の）シャード ファイルのサイズは 200 MB 未満に抑えます。必要に応じて複数のシャードを使用します。
- 1 つのシャードに送信した個々のレコードを、今後のフィードで同じシャードに送信する必要はありません。
- パフォーマンスを向上させるには、データをシャード間で均等に分割し、すべてのシャード ファイルのサイズを類似させます。
- 必要に応じて、gzip を使用してプレーン テキストの JSON フィードを圧縮します。ただし、この操作は個々のフィード シャードごとに行ってください。
SFTP ドロップボックスにフィードをアップロードする
サンドボックス環境にフィードをアップロードします。これを行うには、パートナー ポータルのフィード設定ページでユーザー名を参照します。Google SFTP サーバーは、ポート 19321 にある sftp://partnerupload.google.com で利用できます。
アップロードするファイルには一意の名前を付けることをおすすめします。たとえば、各ファイル名にタイムスタンプを付けると便利です。これは、問題のトラブルシューティングとフィード ステータスのクエリに役立ちます。
データが正しく表示されることを確認する
パートナー ポータルにログインします。[サンドボックス] 環境に切り替えると、[ダッシュボード] セクションに次のページが表示されます。
- フィード
- フィードの概要の統計情報が表示され、フィードのアップロード中のエラーを確認できます。
サンドボックス環境への最初のアップロード後にデータが正しく表示されることを確認するには、[フィード] ページでフィードのエラーがないか確認します。[Inventory Summary] ページで、データの問題がないかどうかを確認します。よくある問題としては、サービスを公開していない販売者のアップロードや、今後予約枠のないサービスのアップロードがあります。
ライブ UI エクスペリエンスをエミュレートするサンドボックス フロントエンドは、ユーザーの視点でデータがどのように表示されるかを示します。これにアクセスするには、上部の環境切り替えツールがサンドボックスに設定され、[在庫] > [在庫] に移動して、[準備完了] または [ライブ（サンドボックス）] の販売者を見つけて、右端の列（利用可能な場合）にある行をクリックするか、[RwG - E2E] リンクをクリックします。ステータスが [準備完了] または [ライブ（サンドボックス）] の販売者がない場合は、無効になっている販売者を開き、右側に表示されるすべての問題（将来の在庫がアップロードされたことを確認するなど）を修正します。
サンドボックス フロントエンドにアクセスできない場合は、フロントエンドへのアクセスが許可されているアカウントでログインしていることを確認します。また、このアカウントが、ログインしている唯一のアカウントであることを確認してください。別のアカウントでログインした後にユーザー切り替え機能を使用して承認済みの Google アカウントにログインしても、サンドボックスのフロントエンドはブロックされます。
フィードを本番環境にアップロードする
エラーのない完全なフィードをサンドボックス環境へ定期的にアップロードできるようになったら、本番環境へのアップロードを開始します。この時点では、統合は有効になりません。
販売者と Google ビジネス リスティングを照合できるようにするには、できるだけ早く完全な Merchant フィードを（少なくともリリースの 1 週間前）にアップロードしてください。一致している正確性を確認してください。
すべての本番環境フィードデータが一貫してアップロードされ、本番環境システムに接続されると、フィードは審査できる状態になります。
Google がフィードを評価する
アップロードしたフィードは、Google が処理し、品質と完全性を評価します。評価の際には、以下の要素が考慮されます。
- フィードがフィードの仕様と一致している。
- フィードにすべての必須フィールドが含まれている。
- フィード内の販売者の合計数は、Google との間で話し合った販売者の数と一致しています。
- 販売者ごとに 1 つ以上のサービスが定義されている。
- フィード内のサービスの合計数が、Google に相談している数と一致しています。
- 今後 1 ～ 30 日間の間に、可用性スロットが開いているサービスの数を確認します。
- Google では、指定されたビジネスのうち、Google マップの対象物と照合できる販売者の数を確認しています。