Kullanım Görüntüleyicisi

Alma Görüntüleyici (İşlemler Merkezi'ndeki Alma > Geçmiş bölümünden erişilebilir), yerel önemli yer feed'lerinin durumu, doğrulama durumu ve işleme geçmişi hakkında neredeyse gerçek zamanlı görünürlük sağlar.

Günlük feed yüklemelerini izlemek, alım sağlığını takip etmek, öğe düzeyindeki doğrulama hatası istatistiklerini incelemek ve feed dosyalarının gelişini doğrulamak için Alım Görüntüleyici'yi kullanın.

Genel Bakış

Ana Ingestion Viewer sayfasında, Google'ın aldığı her feed'in ters kronolojik sırayla günlüğü gösterilir.

Veri alma yaşam döngüsü aşamaları

Her feed gönderimi, aşağıdaki sıralı işleme aşamalarından geçer:

  1. Dosya Edinme: Google, feed dosyasını SFTP kullanarak alır.
  2. Dosya Doğrulama: Sistem, dosya bütünlüğünü, sıkıştırmayı açmayı ve genel şema biçimini doğrular.
  3. Varlık Çıkarma ve Doğrulama: Ardışık düzen, yerel kayıtları (poi_id, adres, koordinatlar, yerelleştirmeler) tek tek ayrıştırır ve söz dizimi, eksiksizlik ve politika uygunluğu açısından kontrol eder.
  4. Mutabakat ve Eşleştirme: Geçerli öğeler, sunum için standart Google Yer Kimlikleri ile bağlantı oluşturmak üzere Google'ın eşleştirme motoruna iletilir.
  5. Rapor oluşturma: Özet metrikler ve gruplandırılmış sorun teşhisleri, alım görüntüleyiciye yayınlanır.

Feed besleme geçmişinizi görüntülemek için aşağıdaki adımları tamamlayın:

  1. İşlemler Merkezi'nde oturum açın.
  2. Alım > Geçmiş sayfası'nı açın.
  3. Sütun kontrollerini kullanarak alım tablosunu filtreleyin, sıralayın ve görüntüleyin.

Alım listesi sütunları

Ana özet tablosunda, her alım çalıştırması için aşağıdaki sütunlar sağlanır:

Sütun Veri Türü Açıklama
No String Alım çalıştırmasının benzersiz tanımlayıcısı.
Alınan zaman (UTC) Timestamp Google'ın feed alımını işlemeye başladığı tarih ve saat (UTC).
Besleme türü Enum Veri edinme türü (ör. Feed).
Ad String Feed alımı türünün adı. Bu, google.local_vss olur.
Durum State Alımın genel işleme durumu (ör. Tamamlandı, Başarısız). Durum tanımları başlıklı makaleyi inceleyin.
Besleme davranışı Enum Tüm yerel ÖY feed'leri Batch modunda işlenir.
Hatalar Integer Algılanan, engelleyici hata düzeyindeki doğrulama sorunlarının toplam sayısı.
Uyarılar Integer Toplam sayıda engelleyici olmayan uyarı düzeyinde sorun tespit edildi.
Öğeler Integer Bu alımda işlenen yerel mülklerin toplam sayısı.

Durum tanımları

Durum sütunu, bir feed gönderiminin mevcut operasyonel durumunu gösterir:

  • Tamamlandı (STATUS_COMPLETE): Feed başarıyla alındı, doğrulandı ve kritik hatalar olmadan işlendi.
  • Başarısız (STATUS_FAILED): Alma işlemi sırasında önemli şema, dosya bozulması veya ardışık düzen hatalarıyla karşılaşıldı ve işlem tamamlanamadı.
  • İşleniyor (STATUS_PROCESSING): Google, feed verilerini etkin bir şekilde doğruluyor, eşleştiriyor ve saklıyor.
  • Atlandı (NOT_STARTED): Feed yükleme işlemi atlandı (örneğin, oluşturma zaman damgası daha önce işlenen bir feed'den daha eskiyse).

Besleme Ayrıntıları Görünümü

Ingestion Details View'ı açmak için Ingestion Viewer tablosundaki herhangi bir satırı tıklayın. Bu görünüm, sorunları ayıklamak için kapsamlı teşhis kartları ve genişletme panelleri sunar.

Ayrıntı panelleri

Alım Ayrıntıları sayfası dört genişletilebilir bölüme ayrılmıştır:

1. Temel bilgiler

Yürütme çalıştırmasıyla ilgili temel meta verileri gösterir:

  • Alım zamanı (UTC): Google'ın alım işlemine başladığı zaman damgası.
  • Besleme türü: Feed.
  • Ad: google.local_vss
  • Besleme davranışı: Batch
  • Durum: Renk kodlu durum rozeti (Done, Failed, Processing, Skipped).

2. Doğrulamalar

Alma sırasında karşılaşılan tüm doğrulama bulgularını listeler:

  • Dosya Hataları (Açıklama Kutusu): Feed dosyasının tamamı başarısız olursa (örneğin, okunamaz bir arşiv veya hatalı JSON söz dizimi nedeniyle) temel neden mesajını içeren belirgin bir uyarı açıklama kutusu gösterilir.
  • Varlık Sorunları (Accordion Tablosu): Öğe düzeyindeki doğrulama sorunları, önem derecesine ve hata koduna göre gruplandırılır.
    • Sorun Kodu: Belirli hata tanımlayıcısı (ör. INVALID_ATTRIBUTE_VALUE, MISSING_RECOMMENDED_FIELD veya SAFE_SEARCH_POLICY_VIOLATION_TEXT).
    • Sorun bilgileri: Temel nedeni ve etkilenen alanları açıklayan teşhis açıklaması.
    • Kayıtlar: Bu sorundan etkilenen tesis varlıklarının toplam sayısı.
    • Envanter Görüntüleyici'deki özellikleri incelemek için doğrudan bağlantılar içeren örnek öğe kimliklerini (poi_id) genişletmek üzere herhangi bir sorun satırını tıklayın.

3. Öğe sayısı

Alım çalıştırması için öğe düzeyinde envanter delta puan kartları sağlar:

  • Toplam: İşlenen yerel tesislerin toplam sayısı.
  • Eklendi: Kataloğunuza eklenen yeni keşfedilmiş işletme girişlerinin sayısı.
  • Değiştirildi: Özellikleri (ör. ad, adres, koordinatlar veya resimler) güncellenen mevcut özelliklerin sayısı.
  • Kaldırıldı: Önceki feed temel çizgisine kıyasla kaldırılan veya atlanan mülklerin sayısı.

4. Dosyalar

Yüklenen feed dosyasının adını gösterir:

  • Dosya adı: Feed dosyasının adı (örneğin, local_feed.json.gz).

Besleme hatalarını giderme

Besleme Görüntüleyici'de feed'lerle ilgili sorunları giderirken aşağıdaki yönergeleri kullanın:

Belirti Olası Neden Önerilen işlem
Durum, Dosya Hatası ile birlikte Failed Bozuk ZIP/GZIP arşivi, hatalı JSON söz dizimi veya desteklenmeyen dosya kodlaması. Feed Paketleme Kuralları'nı kullanarak feed'inizin doğru şekilde paketlendiğini doğrulayın.
Yüksek Errors sayıda doğrulama Kayıtlarda gerekli şema alanları (ör. poi_id, yapılandırılmış location.address veya WGS84 koordinatları) eksik. Hata veren poi_id'leri belirlemek için genişletilmiş Doğrulamalar akordeonunu inceleyin, ÖY feed ardışık düzenlerinizi düzeltin ve feed'i yeniden içe aktarın.
Sıfır Items işlendi Feed dosyası boş veya kayıtlar kök düzeyinde JSON dizisi ayrıştırma işleminde başarısız oldu. Feed paketi yapınızın VssPoi mesaj spesifikasyonuna uygun olup olmadığını kontrol edin. Feed Paketleme Kuralları'na bakın.