Ingestion Viewer

Pelihat Penyerapan (dapat diakses di bagian Penyerapan > Histori di Actions Center) memberikan visibilitas yang mendekati real-time ke dalam status, kondisi validasi, dan histori pemrosesan feed lokasi menarik lokal.

Gunakan Pelihat Penyerapan untuk melacak upload feed harian, memantau kondisi penyerapan, memeriksa statistik error validasi tingkat item, dan memverifikasi kedatangan file feed.

Ringkasan

Halaman utama Ingestion Viewer menampilkan log kronologis terbalik dari setiap feed yang diterima oleh Google.

Fase siklus proses penyerapan

Setiap pengiriman feed diproses melalui tahap pemrosesan berurutan berikut:

  1. Akuisisi File: Google menerima file feed menggunakan SFTP.
  2. Validasi File: Sistem memverifikasi integritas file, dekompresi, dan format skema secara keseluruhan.
  3. Ekstraksi & Validasi Entitas: Pipeline mengurai setiap catatan lokal (poi_id, alamat, koordinat, pelokalan) dan memeriksa sintaksis, kelengkapan, dan kepatuhan terhadap kebijakan.
  4. Rekonsiliasi & Pencocokan: Entitas yang valid diteruskan ke mesin pencocokan Google untuk ditautkan dengan ID Tempat Google kanonis untuk penayangan.
  5. Pembuatan Laporan: Metrik ringkasan dan diagnostik masalah yang dikelompokkan dipublikasikan ke Pelihat Penyerapan.

Untuk melihat histori penyerapan feed, selesaikan langkah-langkah berikut:

  1. Login ke Actions Center.
  2. Buka Ingestion > History page.
  3. Memfilter, mengurutkan, dan melihat tabel penyerapan menggunakan kontrol kolom.

Kolom daftar penyerapan

Tabel ringkasan utama menyediakan kolom berikut untuk setiap proses penyerapan:

Kolom Jenis Data Deskripsi
ID String ID unik untuk proses penyerapan.
Waktu penyerapan (UTC) Timestamp Tanggal dan waktu (dalam UTC) saat Google mulai memproses penyerapan feed.
Jenis penyerapan Enum Jenis akuisisi data (misalnya, Feed).
Nama String Nama untuk jenis penyerapan feed. Nilainya adalah google.local_vss.
Status State Status pemrosesan keseluruhan penyerapan (misalnya, Selesai, Gagal). Lihat Definisi status.
Perilaku penyerapan Enum Semua feed POI lokal diproses dalam mode Batch.
Error Integer Jumlah total masalah validasi tingkat error yang memblokir yang terdeteksi.
Peringatan Integer Jumlah total masalah tingkat peringatan non-pemblokiran yang terdeteksi.
Item Integer Jumlah total properti lokal yang diproses dalam penyerapan ini.

Definisi status

Kolom Status menunjukkan status operasional saat ini dari pengiriman feed:

  • Selesai (STATUS_COMPLETE): Feed berhasil di-ingest, divalidasi, dan diproses tanpa error fatal.
  • Gagal (STATUS_FAILED): Penyerapan mengalami error skema fatal, kerusakan file, atau error pipeline dan tidak dapat diselesaikan.
  • Sedang diproses (STATUS_PROCESSING): Google sedang memvalidasi, mencocokkan, dan menyimpan data feed secara aktif.
  • Dilewati (NOT_STARTED): Upload feed dilewati (misalnya, jika stempel waktu pembuatan lebih lama daripada feed yang diproses sebelumnya).

Tampilan Detail Penyerapan

Klik baris mana pun di tabel Pelihat Penyerapan untuk membuka Tampilan Detail Penyerapan. Tampilan ini menyediakan kartu diagnostik komprehensif dan panel yang dapat diluaskan untuk melakukan proses debug masalah.

Panel detail

Halaman Detail Penyerapan dibagi menjadi empat bagian yang dapat diluaskan:

1. Info dasar

Menampilkan metadata inti tentang eksekusi run:

  • Waktu penyerapan (UTC): Stempel waktu saat Google mulai penyerapan.
  • Jenis penyerapan: Feed.
  • Nama: google.local_vss
  • Perilaku penyerapan: Batch
  • Status: Badge status berkode warna (Done, Failed, Processing, Skipped).

2. Validasi

Mencantumkan semua temuan validasi yang ditemukan selama penyerapan:

  • Error File (Kotak Keterangan): Jika seluruh file feed gagal (misalnya, karena arsip yang tidak dapat dibaca atau sintaksis JSON yang salah format), keterangan peringatan yang jelas akan menampilkan pesan penyebab utama.
  • Masalah Entitas (Tabel Accordion): Masalah validasi tingkat item yang dikelompokkan berdasarkan tingkat keparahan dan kode error.
    • Kode Masalah: ID error tertentu (seperti INVALID_ATTRIBUTE_VALUE, MISSING_RECOMMENDED_FIELD, atau SAFE_SEARCH_POLICY_VIOLATION_TEXT).
    • Info Masalah: Deskripsi diagnostik yang menjelaskan penyebab utama dan kolom yang terpengaruh.
    • Catatan: Jumlah total entitas properti yang terpengaruh oleh masalah ini.
    • Klik baris masalah untuk meluaskan ID entitas contoh (poi_ids) dengan link langsung untuk memeriksa properti di Penampil Inventaris.

3. Item

Menyediakan kartu skor delta inventaris tingkat item untuk proses penyerapan:

  • Total: Jumlah total properti lokal yang diproses.
  • Ditambahkan: Jumlah listingan bisnis yang baru ditemukan dan ditambahkan ke katalog Anda.
  • Diubah: Jumlah properti yang ada yang atributnya (misalnya, nama, alamat, koordinat, atau gambar) diperbarui.
  • Dihapus: Jumlah properti yang dihapus atau dihilangkan dibandingkan dengan dasar pengukuran feed sebelumnya.

4. File

Menampilkan nama file feed yang diupload:

  • Nama File: Nama file feed (misalnya, local_feed.json.gz).

Memecahkan Masalah Kegagalan Penyerapan

Saat memecahkan masalah feed di Penampil Penyerapan, gunakan pedoman berikut:

Gejala Kemungkinan Penyebab Tindakan yang Disarankan
Statusnya adalah Failed dengan Error File Arsip ZIP/GZIP rusak, sintaksis JSON salah bentuk, atau encoding file tidak didukung. Pastikan feed Anda dipaketkan dengan benar menggunakan Pedoman Pengemasan Feed.
Jumlah Errors tinggi dalam Validasi Kolom skema wajib diisi (seperti poi_id, location.address terstruktur, atau koordinat WGS84) tidak ada dalam data. Tinjau akordeon Validasi yang diperluas untuk mengidentifikasi poi_id yang bermasalah, perbaiki pipeline feed POI, dan impor ulang feed.
Zero Items diproses File feed kosong atau rekaman gagal penguraian array JSON tingkat root. Pastikan struktur wrapper feed Anda sesuai dengan spesifikasi pesan VssPoi. Lihat Pedoman Pengemasan Feed.