Meninjau semantik feed
Semantik untuk feed ulasan sedikit berbeda:
Untuk feed ulasan snapshot:
- Setiap penyedia layanan dalam feed ulasan, jika saat ini penyedia tersebut tidak ada dalam database penyedia LSA, maka ulasan penyedia tersebut tidak akan diproses.
- Setiap penyedia jasa dan servis dalam feed ulasan, jika penyedia saat ini ada dalam database penyedia LSA, maka ulasan penyedia akan diproses sebagai berikut:
- Untuk setiap ulasan dalam feed, jika ulasan yang sesuai tidak ada di penyimpanan LSA, ulasan tersebut harus dibuat.
- Untuk setiap ulasan di feed, jika ulasan yang sesuai ada di penyimpanan LSA, ulasan tersebut akan diperbarui dengan info baru.
- Untuk ulasan yang tidak ada di feed, jika ulasan yang sesuai ada di penyimpanan LSA, ulasan tersebut akan dihapus.
- Setiap penyedia jasa dan servis yang tidak ada di feed ulasan, jika penyedia saat ini ada di database penyedia LSA, ulasannya akan dihapus dan penyedia akan berhenti menayangkan iklan.
- Perhatikan bahwa penyedia dengan 0 ulasan juga harus memiliki entri (bukan dihapus) di feed ulasan agar dapat ditayangkan (lihat Contoh feed ulasan - listingId 2)
Perhatikan bahwa inkremental tidak didukung untuk feed ulasan. Feed ulasan yang sesuai diperlukan untuk setiap feed profil.
Penanganan error pada ulasan
Jika item feed ulasan tidak valid, kami akan melewati pemrosesan item feed tersebut, dan melanjutkan pemrosesan item feed yang valid lainnya.
Jika feed ulasan tidak valid (misalnya, tidak mematuhi skema), kami akan berhenti memproses seluruh feed ulasan.
Meninjau kolom
| Nama Kolom | Jenis | Deskripsi | Contoh | Wajib | Batasan |
|---|---|---|---|---|---|
| serviceProviderId | angka | ID unik listingan (penyedia layanan) | 12345 | Ya | Harus sesuai dengan int64 |
| ratingCount | bilangan bulat | Jumlah rating konsumen terverifikasi | 10 | Ya | Harus nol atau lebih. |
| author | string | Nama penulis ulasan | “Jack L.” | Tidak | |
| reviewId | string | ID unik ulasan. Jika setiap ulasan tidak dilengkapi dengan ID unik, pihak ketiga perlu membuat ID unik untuk setiap ulasan (misalnya, hash teks ulasan dan pengguna), setidaknya unik di antara semua ulasan dari satu penyedia. | “123” | Ya | |
| reviewText | string | Tinjau teks yang ditulis oleh penulis | “Bagus!” | Tidak | |
| rating | bilangan bulat | Rating (harus berupa bilangan bulat antara 1 dan 5) | 4 | Ya | Harus berupa bilangan bulat antara 1 dan 5. |
| serviceLocationCity | string | Kota tempat layanan dilakukan | “New York” | Tidak | |
| reviewTimestampMicros | bilangan bulat | Stempel waktu saat ulasan ditulis dalam format mikrodetik. | 1,45142E+15 | Tidak | |
| serviceTimestampMicros | bilangan bulat | Stempel waktu saat layanan selesai dalam format mikrodetik. | 1.45132E+15 | Tidak | |
| language | string | Bahasa teks ulasan dalam kode bahasa ISO 639-1 (huruf kecil, 2 huruf). Harus cocok dengan bahasa penargetan penyedia. | “en” | Tidak | Harus cocok dengan bahasa penargetan yang ditentukan untuk penyedia terkait. Jika tidak ditentukan, nilai defaultnya adalah “en”. |
| kategori | objek | struktur kategori | Tidak | ||
| category->categoryId | enum | kategori layanan (dalam Taksonomi LSA) | “garage_door_pro” | Tidak | |
| category->task | enum | Jenis pekerjaan (tugas) layanan (dalam Taksonomi LSA) | “Memperbaiki Pintu Garasi” | Tidak | |
| confirmedCustomer | boolean | Jika ulasan berasal dari pelanggan yang dikonfirmasi (dengan prospek) | TRUE | Tidak |