取り込みビューア（アクション センターの [取り込み] > [履歴] でアクセス可能）では、ローカルのスポット フィードのステータス、検証の健全性、処理履歴をほぼリアルタイムで確認できます。
取り込みビューアを使用して、フィードの毎日のアップロードを追跡し、取り込みの健全性をモニタリングし、商品レベルの検証エラーの統計情報を確認し、フィード ファイルの到着を確認します。
概要
[取り込みビューア] のメインページには、Google が受信したすべてのフィードの逆時系列ログが表示されます。
取り込みライフサイクルのフェーズ
各フィード送信は、次の順次処理ステージを通過します。
- ファイル取得: Google は SFTP を使用してフィード ファイルを受信します。
- ファイル検証: システムは、ファイルの整合性、解凍、スキーマ形式全体を検証します。
- エンティティの抽出と検証: パイプラインは個々のローカル レコード（
poi_id、住所、座標、ローカライズ）を解析し、構文、完全性、ポリシーの遵守状況を確認します。 - 調整と照合: 有効なエンティティは Google の照合エンジンに渡され、配信用の正規の Google プレイス ID にリンクされます。
- レポートの生成: 要約指標とグループ化された問題の診断結果が Ingestion Viewer に公開されます。
取り込みビューアを操作する
フィードの取り込み履歴を表示する手順は次のとおりです。
- アクション センターにログインします。
- [取り込み] > [履歴] ページを開きます。
- 列コントロールを使用して、取り込みテーブルをフィルタ、並べ替え、表示します。
取り込みリストの列
メインの概要テーブルには、取り込み実行ごとに次の列が表示されます。
| 列 | データ型 | 説明 |
|---|---|---|
| ID | String
|
取り込み実行の一意の識別子。 |
| 取り込み時間（UTC） | Timestamp
|
Google がフィードの取り込みの処理を開始した日時（UTC）。 |
| 取り込みタイプ | Enum
|
データ取得のタイプ（例: Feed）。 |
| 名前 | String
|
フィード取り込みのタイプの名前。これは google.local_vss になります。 |
| ステータス | State
|
取り込みの全体的な処理状態（完了、失敗など）。ステータスの定義をご覧ください。 |
| 取り込みの動作 | Enum
|
すべてのローカル POI フィードは Batch モードで処理されます。 |
| エラー | Integer
|
検出されたブロック エラーレベルの検証問題の合計数。 |
| 警告 | Integer
|
検出されたブロックしない警告レベルの問題の合計数。 |
| アイテム | Integer
|
この取り込みで処理されたローカル プロパティの合計数。 |
ステータスの定義
[ステータス] 列には、フィード送信の現在のオペレーション ステータスが表示されます。
- 完了（
STATUS_COMPLETE）: フィードは正常に取り込まれ、検証され、致命的なエラーなしで処理されました。 - 失敗（
STATUS_FAILED）: 取り込みで致命的なスキーマ、ファイルの破損、パイプライン エラーが発生し、完了できませんでした。 - 処理中（
STATUS_PROCESSING）: Google がフィードデータの検証、照合、保存を積極的に行っています。 - スキップ（
NOT_STARTED）: フィードのアップロードがスキップされました（生成タイムスタンプが以前に処理されたフィードよりも古い場合など）。
取り込みの詳細ビュー
取り込みビューアの表の任意の行をクリックして、取り込みの詳細ビューを開きます。このビューには、問題のデバッグに役立つ包括的な診断カードと展開パネルが表示されます。
詳細パネル
[取り込みの詳細] ページは、次の 4 つの展開可能なセクションに分かれています。
1. 基本情報
実行の実行に関するコア メタデータを表示します。
- 取り込み時間（UTC）: Google が取り込みを開始したタイムスタンプ。
- 取り込みタイプ:
Feed。 - 名前:
google.local_vss - 取り込みの動作:
Batch - ステータス: ステータス バッジの色分け（
Done、Failed、Processing、Skipped）。
2. 検証
取り込み中に検出されたすべての検証結果を一覧表示します。
- ファイルエラー（吹き出し）: フィード ファイル全体が失敗した場合（アーカイブが読み取れない、JSON 構文が不正な形式であるなど）、根本原因のメッセージが目立つ警告の吹き出しに表示されます。
- エンティティの問題
（アコーディオン テーブル）: 重大度とエラーコードでグループ化された商品アイテム単位の検証に関する問題。
- Issue Code: 特定のエラー識別子（
INVALID_ATTRIBUTE_VALUE、MISSING_RECOMMENDED_FIELD、SAFE_SEARCH_POLICY_VIOLATION_TEXTなど）。 - 問題情報: 根本原因と影響を受けるフィールドを説明する診断の説明。
- レコード: この問題の影響を受けたプロパティ エンティティの合計数。
- 問題の行をクリックすると、サンプル エンティティ ID（
poi_id）が展開され、インベントリ ビューアでプロパティを検査するための直接リンクが表示されます。
- Issue Code: 特定のエラー識別子（
3. アイテム
取り込み実行のアイテムレベルの在庫デルタ スコアカードを提供します。
- 合計: 処理されたローカル プロパティの合計数。
- 追加済み: カタログに追加された、新たに検出されたビジネス リスティングの数。
- 変更済み: 属性（名前、住所、座標、画像など）が更新された既存の物件の数。
- 削除済み: 前回のフィードのベースラインと比較して、削除または省略されたプロパティの数。
4. ファイル
アップロードされたフィード ファイルの名前が表示されます。
- ファイル名: フィード ファイルの名前（例:
local_feed.json.gz）。
取り込みの失敗に関するトラブルシューティング
取り込みビューアでフィードのトラブルシューティングを行う場合は、次のガイドラインを使用します。
| 症状 | 考えられる原因 | 推奨される対応 |
|---|---|---|
ステータスが Failed で、ファイル エラーが発生している |
ZIP/GZIP アーカイブの破損、JSON 構文の形式不正、またはサポートされていないファイル エンコード。 | フィード パッケージ化ガイドラインに沿って、フィードが正しくパッケージ化されていることを確認します。 |
検証での Errors の数が多い |
必要なスキーマ フィールド（poi_id、構造化された location.address、WGS84 座標など）がレコードにありません。 |
展開された [検証] アコーディオンを確認して、問題のある poi_id を特定し、POI フィード パイプラインを修正して、フィードを再インポートします。 |
ゼロItems処理済み |
フィード ファイルが空であるか、ルートレベルの JSON 配列の解析に失敗したレコードがあります。 | フィード ラッパーの構造が VssPoi メッセージ仕様に準拠していることを確認します。フィード パッケージのガイドラインを参照してください。 |