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