取り込みビューア（Actions Center の [取り込み > 履歴] でアクセス可能）では、宿泊施設のスポット フィードのステータス、検証の健全性、処理履歴をほぼリアルタイムで確認できます。
取り込みビューアを使用して、毎日のフィードのアップロードを追跡し、取り込みの健全性をモニタリングし、アイテムレベルの検証エラーの統計情報を確認し、フィード ファイルの到着を確認します。
概要
取り込みビューアのメインページには、Google が受信したすべてのスポット フィードのログが新しい順に表示されます。
取り込みライフサイクルのフェーズ
フィードの送信は、次の順序で処理されます。
- ファイルの取得: Google が SFTP 経由でフィード ファイルを受信します。
- ファイルの検証: システムがファイルの整合性、解凍、スキーマ形式全体を検証します。
- エンティティの抽出と検証: パイプラインが個々の宿泊施設のレコード（
poi_id、住所、座標、ローカライズ）を解析し、構文、完全性、ポリシー準拠を確認します。 - 調整と照合: 有効なエンティティは Google の照合エンジンに渡され、配信のために正規の Google プレイス ID にリンクされます。
- レポートの生成: 概要指標とグループ化された問題の診断が取り込みビューアに公開されます。
取り込みビューアを操作する
フィードの取り込み履歴を表示する手順は次のとおりです。
- アクション センターにログインします 。
- [取り込み > 履歴] ページを開きます。
- 列のコントロールを使用して、取り込みテーブルをフィルタ、並べ替え、表示します。
取り込みリストの列
メインの概要テーブルには、取り込み実行ごとに次の列が表示されます。
| 列 | データ型 | 説明 |
|---|---|---|
| ID | 文字列 | 取り込み実行の一意の識別子。 |
| 取り込み時間（UTC） | タイムスタンプ | Google がフィードの取り込みの処理を開始した日時（UTC）。 |
| 取り込みタイプ | 列挙型 | データ取得のタイプ（フィードなど）。 |
| 名前 | 文字列 | フィードの取り込みタイプの名前。これは google.lodging_vss になります。 |
| ステータス | 州 | 取り込みの全体的な処理ステータス（完了、失敗など）。ステータスの定義をご覧ください。 |
| 取り込みの動作 | 列挙型 | すべての宿泊施設のスポット フィードは「バッチ」モードで処理されます。 |
| エラー | 整数 | 検出されたブロック エラーレベルの検証問題の合計数。 |
| 警告 | 整数 | 検出されたブロックしない警告レベルの問題の合計数。 |
| アイテム | 整数 | この取り込みで処理された宿泊施設の総数。 |
ステータスの定義
[ステータス] 列には、フィード送信の現在のオペレーション ステータスが表示されます。
- 完了: フィードが正常に取り込まれ、検証され、致命的なエラーなく処理されました。
- 失敗: 取り込みで致命的なスキーマ、ファイルの破損、パイプライン エラーが発生し、完了できませんでした。
- 処理中: Google がフィードデータの検証、照合、保存を積極的に行っています。
- スキップ: フィードのアップロードがスキップされました（生成タイムスタンプが以前に処理済みフィードよりも古い場合など）。
取り込みの詳細ビュー
取り込みビューアのテーブルの任意の行をクリックして、[取り込みの詳細ビュー] を開きます。このビューには、問題のデバッグに役立つ包括的な診断カードと展開パネルが表示されます。
詳細パネル
[取り込みの詳細] ページは、展開可能な 4 つのセクションに分かれています。
1. 基本情報
実行に関するコアメタデータが表示されます。
- 取り込み時間（UTC）: Google が取り込みを開始したタイムスタンプ。
- 取り込みタイプ: フィード。
- 名前:
google.lodging_vss - 取り込みの動作: バッチ。
- ステータス: 色分けされたステータス バッジ（完了、失敗、処理中、スキップ）。
- 生成時間（UTC）: パートナーがフィード ペイロードを生成したタイムスタンプ（フィード ヘッダーで宣言されている場合）。
2. 検証
取り込み中に検出されたすべての検証結果が一覧表示されます。
- ファイル エラー（吹き出しボックス）: フィード ファイル全体が失敗した場合（読み取り不能なアーカイブや形式が正しくない JSON 構文など）、根本原因のメッセージが目立つ警告吹き出しに表示されます。
- エンティティの問題（アコーディオン テーブル）: アイテムレベルの検証問題が重大度とエラーコードでグループ化されます。
- 問題コード: 特定のエラー識別子（
MISSING_REQUIRED_FIELD、INVALID_LATLNG、SAFE_SEARCH_POLICY_VIOLATION_IMAGEなど）。 - 問題情報: 根本原因と影響を受けるフィールドを説明する診断の説明。
- レコード: この問題の影響を受ける宿泊施設のエンティティの合計数。
- 問題の行をクリックすると、サンプル エンティティ ID（
poi_id）が展開され、 インベントリ ビューでプロパティを確認するための直接 リンクが表示されます。
- 問題コード: 特定のエラー識別子（
3. アイテム
取り込み実行のアイテムレベルのインベントリ差分スコアカードが表示されます。
- 合計: 処理された宿泊施設の総数。
- 追加: カタログに追加された新しく検出されたホテル リスティングの数。
- 変更: 属性（名前、住所、座標、画像など）が更新された既存の宿泊施設の数。
- 削除: 前のフィードのベースラインと比較して削除または省略された宿泊施設の数。
4. ファイル
アップロードされたフィード ファイルの名前が表示されます。
- ファイル名: フィード ファイルの名前（
lodging_feed.json.gzなど）。
取り込みの失敗のトラブルシューティング
取り込みビューアでフィードのトラブルシューティングを行う場合は、次のガイドラインを使用してください。
| 症状 | 考えられる原因 | 推奨される対応 |
|---|---|---|
| ステータスが [失敗] で、ファイル エラーが発生している | ZIP/GZIP アーカイブが破損している、JSON 構文の形式が正しくない、サポートされていないファイル エンコードを使用している。 | フィードのパッケージ化に関するガイドラインに沿って、フィードが正しくパッケージ化されていることを確認します。 |
| [検証] のエラー数が多い | レコードに必須のスキーマ フィールド（poi_id、構造化された location.address、WGS84 座標など）がありません。 |
展開された [検証] アコーディオンを確認して、問題のある poi_id を特定し、スポット フィード パイプラインを修正して、フィードを再インポートします。インベントリ ビューで個々のエンティティの問題を確認します。 |
| 処理されたアイテムがゼロ | フィード ファイルが空であるか、レコードがルートレベルの JSON 配列の解析に失敗しました。 | フィード ラッパーの構造が VssPoi メッセージ仕様に準拠していることを確認します。フィードのパッケージ化に関するガイドラインを参照してください。 |