Tampilan Inventaris

Ringkasan

Inventory Viewer di Actions Center memberikan visibilitas ke kondisi penyerapan, status pencocokan tempat, dan kelayakan penayangan inventaris lokal Tempat Menarik (POI) Anda.

Penampil ini menampilkan masalah yang tidak bergantung pada penyerapan individual—masalah stateful yang mewakili status penayangan aktif setiap penyedia layanan yang menggabungkan kemungkinan mode kegagalan (kebijakan, peringatan, error, dll.) yang mungkin terjadi.

Gunakan fitur ini untuk:

• Telusuri dan periksa semua penyedia layanan yang diserap dan status penayangan live-nya.
• Mendiagnosis error validasi data dan pelanggaran kebijakan konten.
• Mengajukan dan melacak banding untuk setiap pelanggaran kebijakan.
• Memeriksa diagnostik pencocokan penyedia layanan dan mengirimkan proposal pencocokan manual.
• Tinjau payload JSON mentah dari penyerapan feed terbaru Anda.

Kolom Tabel Inventaris

Tampilan daftar menampilkan semua penyedia layanan yang diupload dari feed Tempat Menarik (POI) Anda, yang diatur secara hierarkis menurut entitas. Anda dapat memfilter menurut ID POI Lokal, Status Pencocokan, Integrasi, dan Platform.

Kolom Tabel Ringkasan	Deskripsi
ID POI Lokal	ID unik untuk properti lokal yang diberikan dalam feed (poi_id).
Nama POI Lokal	Nama yang dilokalkan dari properti lokal yang diekstrak dari feed.
Status Pencocokan	Menunjukkan apakah POI telah dicocokkan dengan listingan Google Maps: • Ya (Badge hijau): Berhasil dicocokkan dengan tempat di Google Maps. • Tidak (Badge merah): Tidak cocok; memerlukan peninjauan atau usulan kecocokan.
Integrasi	Ini adalah integrasi Unit Agregator Lokal.
Permukaan	Platform penayangan target (misalnya, Penelusuran).
Status Penayangan	Status kelayakan penayangan real-time: • Diaktifkan (Indikator hijau): Memenuhi syarat dan dapat ditayangkan secara aktif di platform Google. • Dinonaktifkan (Indikator merah): Diblokir dari penayangan karena error validasi, pelanggaran kebijakan, atau status tidak cocok.
Error	Jumlah masalah aktif dengan tingkat keparahan Error. Adanya error untuk properti berarti properti tersebut tidak akan memenuhi syarat untuk ditayangkan di platform mana pun.
Peringatan	Jumlah masalah aktif dengan tingkat keparahan Peringatan. Properti dengan peringatan masih memenuhi syarat untuk ditayangkan.
Info Pertandingan	Berisi tombol Edit kecocokan, yang membuka panel perbaikan kecocokan interaktif.

Catatan: Penyebaran data melalui pipeline penyerapan biasanya memerlukan waktu rata-rata 24–48 jam. POI yang baru diserap atau diperbarui mungkin memerlukan waktu lebih lama untuk mencerminkan status kecocokan dan penayangan penuh.

Tampilan Detail POI

Mengklik ID POI di tampilan daftar akan mengarahkan ke halaman detail khusus entity.

Tampilan detail terdiri dari empat bagian yang dapat diperluas:

1. Info Dasar

Merangkum metadata entity tingkat tinggi:

• Nama POI: Nama tempat usaha yang diuraikan dari data[].name.localizations.
• ID POI: ID entitas partner unik (poi_id).
• Sumber data: Nama file feed persis tempat entitas ini diserap.

2. Status Pelayanan

Menguraikan kelayakan penayangan per integrasi dan platform target:

• Integrasi & Platform: Vertical dan platform target (misalnya, Local Aggregator Unit di Search).
• Status Penayangan: Status Enabled atau Disabled saat ini.
• Masalah: Menampilkan badge masalah untuk semua error atau peringatan aktif (misalnya, Unmatched entity, Policy Violation). Mengklik badge masalah akan membuka Panel Detail Masalah.
• Banding: Menampilkan status penggantian atau banding (Under review, Approved, atau Rejected).

3. Informasi Pencocokan

Menampilkan diagnostik pencocokan tempat:

• Input kecocokan: Alamat fisik yang diformat dan diuraikan dari feed Anda (street_address, locality, region, postal_code, country).
• Jenis pencocokan: Mekanisme resolusi pencocokan (misalnya, Location).
• Namespace pencocokan: Vertical tempat perubahan pencocokan Anda akan diterapkan (misalnya, Local Aggregator Unit).
• Status kecocokan: Yes (Hijau) atau No (Merah).
• Output pencocokan: Nama tempat, alamat, dan ID tempat Google Maps yang diselesaikan.
• Edit kecocokan: Tombol untuk membuka dialog proposal kecocokan.

4. JSON mentah

Menyediakan penampil kode interaktif dengan nomor baris dan penandaan sintaksis yang menampilkan payload JSON yang diuraikan sepenuhnya (item_proto) untuk proses debug dan verifikasi skema yang cepat. Nilai data yang ditampilkan di sini akan mencerminkan nilai yang diterima dari feed POI.

Alur Kerja Masalah & Triase

Entity yang ditandai dengan masalah akan dinonaktifkan (jika ditandai dengan ERROR) atau diturunkan kualitasnya (jika ditandai dengan WARNING). Masalah entitas dengan peringatan tidak dapat diajukan banding, dan peringatan dapat diselesaikan dengan memperbaiki masalah yang mendasarinya.

Jenis Masalah: Dapat Diajukan Banding versus Tidak Dapat Diajukan Banding

1. Masalah yang Tidak Dapat Diajukan Banding (Validasi Teknis, Kualitas Data, & Peringatan):
   • Disebabkan oleh error skema, kolom wajib diisi yang tidak ada, koordinat tidak valid, URL rusak, ID duplikat, atau peringatan konten yang tidak memblokir (seperti nama bisnis lokal non-default, atau lokalitas apa pun untuk deskripsi, alamat yang ditampilkan, dan kategori tempat usaha).
   • Penyelesaian: Partner harus memperbaiki data pokok di feed sumber mereka dan mengupload file feed yang telah diperbarui.
2. Masalah yang Dapat Diajukan Banding (Konten yang Diblokir & Pelanggaran Kebijakan):
   • Dipicu saat aset teks atau gambar properti yang diperlukan gagal dalam filter keamanan konten otomatis dengan tingkat keparahan ERROR.
   • Penyelesaian: Jika konten mematuhi kebijakan platform, partner dapat mengklik tombol Ajukan banding di samping masalah di Pusat Tindakan untuk mengajukan banding. Partner harus memberikan alasan dan justifikasi, dan tim banding kami akan meninjau dan menyetujui atau menolak permintaan tersebut. Anda akan diberi tahu melalui alat dan email tentang keputusan yang dibuat.

Katalog Masalah Unit Agregator Lokal

Tabel berikut menguraikan kumpulan lengkap error validasi dan kode masalah kebijakan untuk integrasi Unit Agregator Lokal:

Deskripsi Masalah	Keparahan	Kode Masalah	Kolom / Argumen yang Terpengaruh	Apakah Keputusan Ini Dapat Diajukan Banding?	Tindakan / Kebijakan yang Relevan
ID POI tidak ada	ERROR	MISSING_REQUIRED_FIELD	poi_id	Tidak	Berikan poi_id yang unik. Lihat Spesifikasi Feed POI.
Lokalitas default tidak ada untuk kolom "name"	ERROR	MISSING_REQUIRED_FIELD	name.default_locale	Tidak	Tentukan kode bahasa BCP 47 yang valid untuk lokalitas default. Lihat Dukungan Multibahasa.
No default localization found for "name" field	ERROR	MISSING_REQUIRED_FIELD	name.localizations	Tidak	Berikan nilai untuk nama yang dilokalkan dari POI yang cocok dengan bahasa default_locale yang dideklarasikan.
Tidak ada lokalitas default untuk kolom "description"	ERROR	MISSING_REQUIRED_FIELD	description.default_locale	Tidak	Tentukan lokalitas default BCP 47 yang valid untuk deskripsi properti.
Tidak ada pelokalan default yang ditemukan untuk kolom "description"	ERROR	MISSING_REQUIRED_FIELD	description.localizations	Tidak	Berikan teks deskripsi yang cocok dengan bahasa default_locale yang dinyatakan.
Lokalitas default tidak ada untuk kolom "display_address"	ERROR	MISSING_REQUIRED_FIELD	display_address.default_locale	Tidak	Tentukan lokalitas default BCP 47 yang valid untuk alamat yang ditampilkan.
Tidak ada pelokalan default yang ditemukan untuk kolom "display_address"	ERROR	MISSING_REQUIRED_FIELD	display_address.localizations	Tidak	Berikan teks alamat berformat yang cocok dengan bahasa default_locale yang dinyatakan.
Melebihi jumlah gambar maksimum	PERINGATAN	EXCEEDED_MAX_COUNT	images	Tidak	Batasi entri gambar hingga maksimum 5 gambar per POI. Gambar yang berlebih akan dihapus.
Koordinat lintang tidak valid	ERROR	INVALID_LATLNG	location.latitude	Tidak	Masukkan lintang yang valid antara -90.0 dan +90.0. Lihat Definisi Koordinat Geografis.
Koordinat bujur tidak valid	ERROR	INVALID_LATLNG	location.longitude	Tidak	Masukkan bujur yang valid antara -180.0 dan +180.0. Lihat Definisi Koordinat Geografis.
Koordinat lintang tidak ada	ERROR	MISSING_REQUIRED_FIELD	location.latitude	Tidak	Berikan nilai lintang untuk melengkapi pasangan koordinat. Lihat Definisi Koordinat Geografis.
Koordinat bujur tidak ada	ERROR	MISSING_REQUIRED_FIELD	location.longitude	Tidak	Berikan nilai bujur untuk melengkapi pasangan koordinat. Lihat Definisi Koordinat Geografis.
Alamat tidak ada atau tidak terstruktur	ERROR	MISSING_REQUIRED_FIELD	location.address	Tidak	Berikan alamat pos terstruktur yang mencakup jalan, lokalitas, kode pos, dan negara.
URL salah format atau tidak valid	ERROR	INVALID_ATTRIBUTE_VALUE	url	Tidak	Pastikan URL halaman landing menggunakan protokol HTTP/HTTPS yang didukung dan sintaksis yang valid.
Gambar tidak valid atau tidak dapat dijangkau	PERINGATAN	INVALID_IMAGE	image.url	Tidak	Pastikan URL gambar dapat dijangkau secara publik dan tidak memerlukan autentikasi atau menampilkan error 4xx/5xx.
ID POI duplikat	ERROR	DUPLICATE_ENTITY	poi_id	Tidak	Pastikan setiap poi_id bersifat unik di seluruh payload feed. Hapus entri duplikat.
Entitas cocok duplikat	ERROR	DUPLICATE_MATCHED_ENTITY	POI	Tidak	Hapus entri duplikat dari feed Anda, atau gunakan alat Pencocokan Entitas POI untuk mencocokkan bisnis yang berbeda dengan listingan Google Maps independennya.
Entitas yang tidak cocok	ERROR	UNMATCHED_ENTITY	POI	Tidak	Cocokkan POI dengan listingan tempat Google Maps menggunakan alat Pencocokan Entitas POI.
Pelanggaran kebijakan gambar	ERROR	SAFE_SEARCH_POLICY_VIOLATION_IMAGE	image	Ya	Hapus atau ganti gambar yang ditandai, atau klik Ajukan banding untuk mengirimkan pembenaran. Lihat Kebijakan konten gambar Google Penelusuran.
Pelanggaran kebijakan teks - Nama Default	ERROR	SAFE_SEARCH_POLICY_VIOLATION_TEXT	name.localizations.*.text	Ya	Hapus atau ganti teks nama yang ditandai, atau klik Ajukan banding. Lihat kebijakan teks konten Google Penelusuran.
Pelanggaran kebijakan teks - Nama Non-Default	PERINGATAN	SAFE_SEARCH_POLICY_VIOLATION_TEXT	name.localizations.*.text	Tidak	Hapus atau ganti teks nama yang ditandai. Lihat kebijakan teks konten Google Penelusuran.
Pelanggaran kebijakan teks - Deskripsi	PERINGATAN	SAFE_SEARCH_POLICY_VIOLATION_TEXT	description.localizations.*.text	Tidak	Hapus atau ganti teks deskripsi yang ditandai. Lihat kebijakan teks konten Google Penelusuran.
Pelanggaran kebijakan teks - Alamat yang Ditampilkan	PERINGATAN	SAFE_SEARCH_POLICY_VIOLATION_TEXT	display_address.localizations.*.text	Tidak	Hapus atau ganti teks alamat tampilan yang ditandai. Lihat kebijakan teks konten Google Penelusuran.
Lokalitas default tidak ada untuk Kategori Tempat Usaha	ERROR	MISSING_REQUIRED_FIELD	local_data.establishment_category.default_locale	Tidak	Berikan nilai untuk kategori tempat yang dilokalkan dari POI yang cocok dengan bahasa default_locale yang dideklarasikan.
Hari buka jam kerja tidak ada	ERROR	MISSING_REQUIRED_FIELD	local_data.business_hours.time_ranges.open_day	Tidak	Berikan hari buka jam buka yang valid.
Waktu buka jam kerja tidak ada	ERROR	MISSING_REQUIRED_FIELD	local_data.business_hours.time_ranges.open_time	Tidak	Berikan jam buka yang valid.
Hari tutup jam buka tidak ada	ERROR	MISSING_REQUIRED_FIELD	local_data.business_hours.time_ranges.close_day	Tidak	Berikan hari tutup jam buka yang valid.
Waktu tutup jam buka tidak ada	ERROR	MISSING_REQUIRED_FIELD	local_data.business_hours.time_ranges.close_time	Tidak	Berikan waktu tutup jam buka yang valid.
Waktu buka jam buka lebih besar dari waktu tutup	ERROR	NOT_LESS_THAN_FIELD	local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time	Tidak	Berikan pasangan waktu buka dan tutup yang valid, serta pastikan waktu buka lebih awal daripada waktu tutup.
Nilai minimum rentang harga lebih besar dari nilai maksimum	ERROR	INVALID_PRICE_RANGE	local_data.price_range.min_price, local_data.price_range.max_price	Tidak	Berikan rentang harga yang valid, dengan harga minimum lebih rendah dari harga maksimum.
ID Merek Tidak Ada	ERROR	MISSING_REQUIRED_FIELD	local_data.brand_landing_pages.brand_id	Tidak	Berikan ID brand yang valid.
ID Brand Duplikat dalam POI	ERROR	DUPLICATE_UNIQUE_PROPERTY	local_data.brand_landing_pages.brand_id	Tidak	Pastikan setiap brand_id bersifat unik di seluruh payload POI. Hapus entri duplikat.
URL default merek tidak ada	ERROR	MISSING_REQUIRED_FIELD	local_data.brand_landing_pages.default_url	Tidak	Berikan URL default merek yang valid.
URL Brand salah format atau tidak valid	ERROR	INVALID_ATTRIBUTE_VALUE	local_data.brand_landing_pages.default_url	Tidak	Pastikan URL default merek menggunakan protokol HTTP/HTTPS yang didukung dan sintaksis yang valid.
URL halaman landing yang dilokalkan untuk merek tidak ada	ERROR	MISSING_REQUIRED_FIELD	local_data.brand_landing_pages.localized_landing_pages.url	Tidak	Berikan URL yang valid untuk halaman landing yang dilokalkan.
URL halaman landing yang dilokalkan untuk merek salah format atau tidak valid	ERROR	INVALID_ATTRIBUTE_VALUE	local_data.brand_landing_pages.localized_landing_pages.url	Tidak	Pastikan URL halaman landing yang dilokalkan menggunakan protokol HTTP/HTTPS yang didukung dan sintaksis yang valid.
URL halaman landing yang dilokalkan untuk merek duplikat	ERROR	DUPLICATE_UNIQUE_PROPERTY	local_data.brand_landing_pages.localized_landing_pages.url	Tidak	Pastikan setiap url bersifat unik di seluruh halaman landing yang dilokalkan untuk POI. Hapus entri duplikat.
Lokalitas halaman landing yang dilokalkan merek tidak ada	ERROR	MISSING_REQUIRED_FIELD	local_data.brand_landing_pages.localized_landing_pages.locales	Tidak	Berikan kumpulan lokalitas yang valid untuk halaman landing yang dilokalkan.
Lokalitas halaman landing yang dilokalkan merek duplikat	ERROR	DUPLICATE_UNIQUE_PROPERTY	local_data.brand_landing_pages.localized_landing_pages.locales	Tidak	Pastikan setiap locale bersifat unik di seluruh halaman landing yang dilokalkan untuk POI. Hapus entri duplikat.
Pelanggaran kebijakan teks - Kategori Tempat Usaha	PERINGATAN	SAFE_SEARCH_POLICY_VIOLATION_TEXT	local_data.establishment_category.localizations.*.text	Tidak	Hapus atau ganti teks kategori tempat usaha yang ditandai. Lihat kebijakan teks konten Google Penelusuran.

Kode Masalah

Bagian berikut memberikan penyebab dan langkah-langkah perbaikan yang mendetail untuk setiap kode masalah.

Kolom wajib belum diisi

Kode Masalah: MISSING_REQUIRED_FIELD
Tingkat Keparahan: Error (Memblokir Penayangan)
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui feed POI Anda)

Error ini terjadi jika entitas yang diserap tidak memiliki satu atau beberapa atribut wajib yang diperlukan oleh Spesifikasi Feed Lokasi Menarik.

Periksa panel Detail Masalah untuk mengidentifikasi properti spesifik yang tidak ada, lalu terapkan perbaikan yang sesuai:

1. ID POI tidak ada (poi_id)

• Penyebab: Kolom poi_id kosong, null, atau tidak ada dari objek entity root.
• Perbaikan: Berikan ID string unik yang persisten untuk properti.

{
  "poi_id": "test_restaurant_1"
}

2. Nama yang Dilokalkan atau Lokalitas Default Tidak Ada (name)

• Penyebab: Objek name tidak memiliki string default_locale atau array localizations dengan lokalitas yang cocok.
• Perbaikan: Berikan default_locale dan setidaknya satu entri pelokalan yang cocok dengan lokalitas tersebut.

{
  "name": {
    "localizations": [
      {
        "locale": "en",
        "text": "Tasty Bites Test Restaurant"
      }
    ],
    "default_locale": "en"
  }
}

3. Lokalitas Default atau Alamat yang Dilokalkan Tidak Ada (display_address)

• Penyebab: Objek display_address tidak memiliki string default_locale atau array localizations.
• Perbaikan: Berikan default_locale dan setidaknya satu entri pelokalan yang cocok dengan lokalitas tersebut untuk alamat yang diformat.

{
  "display_address": {
    "localizations": [
      {
        "locale": "en",
        "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
      }
    ],
    "default_locale": "en"
  }
}

4. Lokal Default atau Deskripsi yang Dilokalkan Tidak Ada (description)

• Penyebab: Jika objek description disertakan, default_locale atau pelokalan yang cocok tidak ada.
• Perbaikan: Berikan default_locale dan setidaknya satu entri pelokalan yang cocok dengan lokalitas tersebut untuk deskripsi.

{
  "description": {
    "localizations": [
      {
        "locale": "en",
        "text": "A mock restaurant for testing the POI feed ingestion."
      }
    ],
    "default_locale": "en"
  }
}

5. Koordinat Geografis Tidak Ada (location.latitude / location.longitude)

• Penyebab: Objek location tidak memiliki nilai numerik latitude atau longitude.
• Perbaikan: Berikan latitude dan longitude sebagai angka floating point dalam derajat desimal WGS84 standar.

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

6. Alamat Pos Terstruktur Tidak Ada (location.address)

• Penyebab: Objek location.address tidak memiliki komponen alamat wajib (country, locality, atau postal_code).
• Perbaikan: Isi objek alamat pos terstruktur sesuai standar ISO.

{
  "location": {
    "address": {
      "country": "US",
      "locality": "Mountain View",
      "postal_code": "94043",
      "street_address": "1600 Amphitheatre Pkwy"
    }
  }
}

7. Lokalitas Default untuk Kategori Tempat Usaha Tidak Ada (local_data.establishment_category.default_locale)

• Penyebab: Objek local_data.establishment_category ada, tetapi default_locale tidak ada, kosong, atau tidak cocok dengan entri apa pun dalam array localizations.
• Perbaikan: Tentukan tag bahasa BCP 47 yang valid untuk default_locale dan berikan setidaknya satu string yang dilokalkan yang cocok dengan lokalitas tersebut.

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        }
      ]
    }
  }
}

8. Hari Buka Jam Kerja Tidak Ada (local_data.business_hours.time_ranges.open_day)

• Penyebab: Entri di local_data.business_hours.time_ranges tidak memiliki open_day atau ditetapkan ke DAY_OF_WEEK_UNSPECIFIED.
• Perbaikan: Berikan string hari dalam seminggu yang valid (misalnya, "MONDAY", "TUESDAY", dll.).

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

9. Waktu Buka Jam Kerja Tidak Ada (local_data.business_hours.time_ranges.open_time)

• Penyebab: Entri di local_data.business_hours.time_ranges tidak memiliki objek open_time.
• Perbaikan: Tentukan open_time dengan hours (0–23) dan minutes (0–59).

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

10. Hari Tutup Jam Kerja Tidak Ada (local_data.business_hours.time_ranges.close_day)

• Penyebab: Entri di local_data.business_hours.time_ranges tidak memiliki close_day atau ditetapkan ke DAY_OF_WEEK_UNSPECIFIED.
• Perbaikan: Berikan string hari dalam seminggu yang valid (misalnya, "MONDAY", "TUESDAY", dll.).

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

11. Waktu Tutup Jam Kerja Tidak Ada (local_data.business_hours.time_ranges.close_time)

• Penyebab: Entri di local_data.business_hours.time_ranges tidak memiliki objek close_time.
• Perbaikan: Tentukan close_time dengan hours (0–23) dan minutes (0–59).

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

12. ID Brand tidak ada (local_data.brand_landing_pages.brand_id)

• Penyebab: Entri di local_data.brand_landing_pages memiliki brand_id yang kosong, null, atau tidak ada.
• Perbaikan: Berikan ID string yang tidak kosong yang cocok dengan konfigurasi merek partner terdaftar Anda.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

13. URL Default Merek tidak ada (local_data.brand_landing_pages.default_url)

• Penyebab: Entri di local_data.brand_landing_pages tidak memiliki default_url atau merupakan string kosong.
• Perbaikan: Berikan URL halaman landing HTTP/HTTPS pengganti yang valid untuk pengguna yang lokalitasnya tidak cocok dengan URL yang dilokalkan.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

14. URL Halaman Landing yang Dilokalkan untuk Brand Tidak Ada (local_data.brand_landing_pages.localized_landing_pages.url)

• Penyebab: Item di dalam localized_landing_pages tidak memiliki kolom url atau kolom tersebut kosong.
• Perbaikan: Berikan URL HTTP/HTTPS yang valid dan sepenuhnya memenuhi syarat untuk halaman landing yang dilokalkan.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

15. Lokalitas Halaman Landing Brand yang Dilokalkan Tidak Ada (local_data.brand_landing_pages.localized_landing_pages.locales)

• Penyebab: Item di dalam localized_landing_pages tidak memiliki array locales atau array tersebut kosong.
• Perbaikan: Berikan setidaknya satu kode bahasa atau lokalitas BCP 47 yang valid (misalnya, ["en-US"]) dalam array locales.

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

Melebihi jumlah gambar maksimum

Kode Masalah: EXCEEDED_MAX_COUNT
Tingkat Keparahan: Peringatan
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)

Error ini terjadi jika payload entity POI berisi lebih dari 5 objek gambar dalam array images.

Perbaikan:

• Pangkas array images agar berisi maksimal 5 foto properti lokal yang berkualitas tinggi dan representatif.
• Gambar yang melebihi batas 5 akan dihapus.

Koordinat geografis tidak valid

Kode Masalah: INVALID_LATLNG
Tingkat Keparahan: Error (Memblokir Penayangan)
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)

Error ini terjadi jika koordinat geografis yang diberikan di location.latitude atau location.longitude berada di luar batas bola yang valid atau mewakili koordinat null yang tidak terisi.

Penyebab Umum & Perbaikan:

• Garis Lintang di Luar Batas: Garis lintang harus berupa angka floating point antara -90.0 dan 90.0 inklusif.
• Bujur di Luar Batas: Bujur harus berupa angka floating point antara -180.0 dan 180.0 inklusif.
• Null Island (0,0): Mengirimkan 0.0, 0.0 atau bilangan bulat placeholder (seperti 999, 999) akan memicu penolakan koordinat.
• Koordinat Tertukar: Pastikan lintang dan bujur tidak terbalik dalam pipeline serialisasi Anda.

Contoh Payload yang Valid:

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

URL salah format atau tidak valid

Kode Masalah: INVALID_ATTRIBUTE_VALUE
Tingkat Keparahan: Error (Memblokir Penayangan)
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)

Error ini terjadi jika nilai atribut gagal dalam validasi skema, paling sering saat URL halaman landing atau URL gambar partner tidak valid secara sintaksis.

Persyaratan:

• Protokol: URL harus secara eksplisit menentukan http:// atau https:// (HTTPS sangat direkomendasikan).
• Encoding: URL yang berisi karakter khusus, spasi, atau karakter non-ASCII harus dienkode persen dengan benar (RFC 3986).
• Domain Kanonis: Pastikan domain sepenuhnya memenuhi syarat (misalnya, https://example.com/local/123, bukan example.com/local/123 atau www.example).

Contoh Payload yang Valid:

{
  "url": "https://www.tastybitestest.com/en"
}

Gambar tidak valid atau tidak dapat dijangkau

Kode Masalah: INVALID_IMAGE
Tingkat Keparahan: Peringatan
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)

Peringatan ini terjadi selama tahap pengambilan gambar asinkron saat crawler Google tidak dapat mendownload, mendekode, atau memverifikasi aset media dari image.url. Meskipun gambar yang tidak valid dihilangkan, properti tetap memenuhi syarat untuk ditayangkan.

Penyebab Umum & Perbaikan:

• Error HTTP (404 / 403 / 500): URL gambar menampilkan kode status HTTP selain 200. Pastikan gambar dapat diakses secara publik tanpa autentikasi, cookie wall, atau batasan daftar yang diizinkan IP.
• Pemblokiran Robots.txt: Pastikan Jaringan Penayangan Konten (CDN) Anda mengizinkan agen pengguna Googlebot dan Googlebot-Image.
• Format File Tidak Didukung: Gambar harus dalam format raster standar (JPEG, PNG, WebP). GIF animasi, SVG, dan format kamera mentah tidak didukung. Lihat pedoman gambar kami untuk mengetahui detail selengkapnya.
• Kegagalan Sertifikat SSL: Pastikan server host gambar memiliki rantai sertifikat SSL yang valid.

ID POI duplikat

Kode Masalah: DUPLICATE_ENTITY
Tingkat Keparahan: Error (Memblokir Penayangan)
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)

Error ini terjadi jika string poi_id yang sama muncul lebih dari sekali dalam satu set file feed.

Perbaikan:

• Pastikan setiap listingan lokal di feed Anda memiliki poi_id yang unik dan deterministik.
• Jika properti lokal memiliki beberapa jenis atau tarif kamar, gabungkan semuanya dalam satu entity POI root, bukan membuat data entity duplikat dengan ID yang sama.

Entitas duplikat yang cocok

Kode Masalah: DUPLICATE_MATCHED_ENTITY
Tingkat Keparahan: Error (Memblokir Penayangan)
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed atau menggunakan alat Pencocokan Entitas POI)

Error ini terjadi jika dua atau beberapa entri poi_id yang berbeda di feed Anda cocok dengan listingan tempat Google Maps kanonis yang sama. Jika beberapa bisnis dipetakan ke entitas Google yang sama, semua entri yang bertabrakan akan diblokir dari penayangan hingga duplikasi diselesaikan.

Cara Mengatasi:

1. Identifikasi properti yang bertabrakan: Buka Ingestion Viewer (Ingestion > History), pilih proses penyerapan terbaru, dan luaskan panel Validations. Klik baris DUPLICATE_MATCHED_ENTITY yang memiliki ID grup Issue Info yang sama untuk melihat semua kumpulan data poi_id yang cocok dengan entity Google yang sama.
2. Hapus listingan duplikat dari feed Anda: Jika entri poi_id yang bertabrakan mewakili lokasi bisnis fisik yang sama, hapus entri duplikat dari feed Anda sehingga hanya satu poi_id yang dikirimkan untuk tempat usaha tersebut.
3. Sesuaikan kecocokan yang salah untuk bisnis independen: Jika entri poi_id yang bertabrakan mewakili bisnis terpisah dan independen yang salah dicocokkan dengan entitas Google yang sama, buka bisnis yang salah dicocokkan di Tampilan Inventaris, lalu klik Edit kecocokan untuk memilih atau mengusulkan listingan tempat Google Maps khusus. Petunjuk mendetail tersedia di panduan Pencocokan Entity POI.

Entitas yang tidak cocok

Kode Masalah: UNMATCHED_ENTITY
Tingkat Keparahan: Error (Memblokir Penayangan)
Dapat Diajukan Banding: Tidak (Gunakan alat Pencocokan Entitas POI atau perbaiki metadata entitas)

Masalah ini menunjukkan bahwa pipeline pencocokan Google tidak dapat merekonsiliasi listingan lokal Anda dengan tempat kanonis di Google Maps.

Cara Mengatasi:

1. Verifikasi Atribut Inti: Pastikan name, display_address, location.address, url, telephone, dan location.latitude/location.longitude lokal mencerminkan lokasi properti fisik dengan tepat.
2. Periksa Informasi Pencocokan: Lihat kolom Info Pencocokan di Tampilan Inventaris untuk melihat tempat kandidat.
3. Gunakan Alat Perbaikan Kecocokan POI: Klik Edit Kecocokan di Actions Center untuk menelusuri dan mengonfirmasi ID Tempat Google yang benar secara manual. Petunjuk mendetail tersedia di panduan Pencocokan Entity POI.

Pelanggaran kebijakan Gambar Google Penelusuran

Kode Masalah: SAFE_SEARCH_POLICY_VIOLATION_IMAGE
Tingkat Keparahan: ERROR (Memblokir Penayangan)
Dapat Diajukan Banding: Ya

Lihat Kode Masalah Kebijakan yang Relevan di Sini: Kebijakan konten gambar Google Penelusuran

Jika Anda yakin bahwa gambar tersebut salah ditandai (positif palsu), klik Create Appeal di panel Issue Details.

Pelanggaran kebijakan Teks Konten Google Penelusuran - Nama

Kode Masalah: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Tingkat Keparahan: Tingkat keparahan bervariasi per kolom (lihat detail berikut)
Kolom yang Terpengaruh: name.localizations.*.text
Dapat Diajukan Banding: Ya (Khusus ERROR lokalitas default); Tidak (Peringatan lokalitas non-default)

• Lokalitas default (name.default_locale): ERROR (Memblokir Penayangan). Seluruh POI diblokir agar tidak ditayangkan. Jika Anda yakin bahwa teks nama lokalitas default ditandai karena kesalahan (positif palsu), klik Ajukan Banding di panel Detail Masalah.
• Lokalitas non-default: Peringatan (Tidak Memblokir Penayangan). Hanya pelokalan yang ditandai yang akan dihilangkan, sedangkan POI tetap memenuhi syarat untuk ditayangkan. Peringatan tentang lokalitas non-default tidak dapat diajukan banding dan dapat diselesaikan dengan memperbarui payload feed Anda.

Lihat Kode Masalah Kebijakan yang Relevan di Sini: Kebijakan konten teks Google Penelusuran

Pelanggaran kebijakan Teks Konten Google Penelusuran - Deskripsi

Kode Masalah: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Tingkat Keparahan: Peringatan (Tidak Memblokir Penayangan)
Kolom yang Terpengaruh: description.localizations.*.text
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)

Peringatan ini muncul saat teks di description.localizations ditandai karena melanggar kebijakan teks konten Google Penelusuran. Meskipun pelokalan deskripsi yang ditandai (atau seluruh kolom description jika lokalitas default ditandai) dihilangkan, POI tetap memenuhi syarat untuk ditayangkan.

Lihat Kode Masalah Kebijakan yang Relevan di Sini: Kebijakan konten teks Google Penelusuran

Pelanggaran kebijakan Teks Konten Google Penelusuran - Alamat Tampilan

Kode Masalah: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Tingkat Keparahan: Peringatan (Tidak Memblokir Penayangan)
Kolom yang Terpengaruh: display_address.localizations.*.text
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)

Peringatan ini muncul jika teks alamat yang diformat di display_address.localizations berisi konten yang dilarang dalam kebijakan teks konten Google Penelusuran. Meskipun pelokalan alamat yang ditandai (atau seluruh kolom display_address jika lokalitas default ditandai) dihilangkan, POI tetap memenuhi syarat untuk ditayangkan.

Lihat Kode Masalah Kebijakan yang Relevan di Sini: Kebijakan konten teks Google Penelusuran

Waktu buka jam kerja lebih besar daripada waktu tutup

Kode Masalah: NOT_LESS_THAN_FIELD
Tingkat Keparahan: Error (Memblokir Penayangan)
Kolom yang Terpengaruh: local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)

Error ini terjadi jika jam buka open_time lebih lambat dari atau sama dengan close_time untuk interval hari yang sama.

Penyebab Umum & Perbaikan:

• Inversi Hari yang Sama: Pastikan open_time lebih awal daripada close_time (misalnya, 09.00 hingga 17.00).
• Shift Malam: Jika suatu tempat buka pada satu hari dan tutup setelah tengah malam pada hari berikutnya (misalnya, 21.00 hingga 02.00), tetapkan close_day ke hari berikutnya (misalnya, open_day: "FRIDAY", close_day: "SATURDAY").

Contoh Payload yang Valid:

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 9, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 17, "minutes": 0 }
        }
      ]
    }
  }
}

Nilai minimum rentang harga lebih besar dari nilai maksimum

Kode Masalah: INVALID_PRICE_RANGE
Tingkat Keparahan: Error (Memblokir Penayangan)
Kolom yang Terpengaruh: local_data.price_range.min_price, local_data.price_range.max_price
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)

Error ini terjadi jika nilai min_price melebihi max_price, atau jika min_price dan max_price menentukan kode mata uang yang berbeda.

Penyebab Umum & Perbaikan:

• Nilai Terbalik: Pastikan min_price lebih rendah dari atau sama dengan max_price.
• Ketidakcocokan Mata Uang: Pastikan min_price.currency_code dan max_price.currency_code cocok dengan kode mata uang tiga huruf ISO 4217 yang sama (misalnya, "USD").

Contoh Payload yang Valid:

{
  "local_data": {
    "price_range": {
      "min_price": {
        "currency_code": "USD",
        "units": 15,
        "nanos": 0
      },
      "max_price": {
        "currency_code": "USD",
        "units": 45,
        "nanos": 0
      }
    }
  }
}

Properti unik duplikat dalam POI

Kode Masalah: DUPLICATE_UNIQUE_PROPERTY
Tingkat Keparahan: Error (Memblokir Penayangan)
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)

Error ini terjadi jika kolom atau sub-elemen yang harus unik di satu entitas POI berisi entri duplikat.

Periksa panel Detail Masalah untuk mengidentifikasi properti yang melanggar keunikan:

1. ID Brand Duplikat dalam POI (local_data.brand_landing_pages.brand_id)

• Penyebab: String brand_id yang sama muncul di beberapa entri brand_landing_pages untuk satu POI.
• Perbaikan: Gabungkan semua halaman landing untuk brand tersebut ke dalam satu objek brand_landing_pages.

Contoh Payload yang Valid:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722"
      },
      {
        "brand_id": "brand_opentable",
        "default_url": "https://www.opentable.com/r/287722"
      }
    ]
  }
}

2. URL Halaman Landing yang Dilokalkan untuk Merek Duplikat (local_data.brand_landing_pages.localized_landing_pages.url)

• Penyebab: URL halaman landing yang sama persis ditentukan beberapa kali di bagian localized_landing_pages untuk merek yang sama.
• Perbaikan: Pastikan setiap entri URL berbeda, atau kaitkan beberapa lokalitas di array locales entri URL tunggal.

Contoh Payload yang Valid:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

3. Lokalitas Halaman Landing yang Dilokalkan untuk Merek Duplikat (local_data.brand_landing_pages.localized_landing_pages.locales)

• Penyebab: Kode lokalitas yang sama (misalnya, "en-US") diulang di beberapa entri di localized_landing_pages untuk merek yang sama.
• Perbaikan: Tetapkan setiap tag lokalitas ke tepat satu halaman landing yang dilokalkan.

Contoh Payload yang Valid:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US", "en-GB"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

URL Merek salah format atau tidak valid

Kode Masalah: INVALID_ATTRIBUTE_VALUE
Tingkat Keparahan: Error (Memblokir Penayangan)
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)
Kolom yang Terpengaruh: local_data.brand_landing_pages.default_url, local_data.brand_landing_pages.localized_landing_pages.url

Error ini terjadi jika URL default merek atau URL halaman landing yang dilokalkan gagal dalam validasi sintaksis URI.

Persyaratan:

• Protokol: Harus secara eksplisit menentukan http:// atau https:// (https:// diperlukan untuk penyaluran produksi).
• Sintaksis: Harus berupa URL yang valid, dienkode persen, dan mematuhi RFC 3986 dengan nama domain yang sepenuhnya memenuhi syarat.

Contoh Payload yang Valid:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com/en",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en/reservation",
            "locales": ["en-US"]
          }
        ]
      }
    ]
  }
}

Pelanggaran kebijakan Teks Konten Google Penelusuran - Kategori Tempat Usaha

Kode Masalah: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Tingkat Keparahan: Peringatan (Tidak Memblokir Penayangan)
Dapat Diajukan Banding: Tidak (Selesaikan dengan memperbarui payload feed)
Kolom yang Terpengaruh: local_data.establishment_category.localizations.*.text

Peringatan ini terjadi jika teks kategori tempat usaha yang dilokalkan gagal dalam filter konten SafeSearch otomatis. Meskipun pelokalan kategori tempat usaha yang ditandai (atau seluruh kolom establishment_category jika lokalitas default ditandai) dihilangkan, POI tetap memenuhi syarat untuk ditayangkan.

Perbaikan:

• Kepatuhan terhadap Kebijakan: Hapus atau ganti teks kategori tempat usaha yang ditandai dengan istilah kategori bisnis standar yang mematuhi kebijakan teks konten Google Penelusuran

Contoh Payload yang Valid:

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        },
        {
          "locale": "fr",
          "text": "Restaurant gastronomique"
        }
      ]
    }
  }
}