Referensi atribut interaksi

Objek interaksi dikembalikan oleh Daftar interaksi untuk lokasi, Dapatkan interaksi agregat, dan Dapatkan interaksi berdasarkan ID. Kedua endpoint dengan paginasi membungkus objek tersebut dalam koneksi bergaya Relay: data.interactions (per lokasi) dan data.rollupInteractions (agregat dalam satu akun) masing-masing memuat edges[].node, pageInfo, dan totalCount. Pengambilan berdasarkan ID tidak menggunakan paginasi; data.interactionDetails adalah objek { "interactions": [ ... ] } biasa tanpa edges, pageInfo, atau totalCount.

Field interaksi

Field	Tipe	Deskripsi
id	String	UUID interaksi. Berikan sebagai `interactionId` saat memberikan respons
interactionId	String	UUID yang sama dengan `id`
source	String	Nama host situs ulasan/media sosial (e.g, `maps.google.com`, `yelp.com`)
title	String	Judul interaksi, jika disediakan oleh sumber
content	String	Teks isi ulasan atau postingan
authorName	String	Nama tampilan penulis
rating	Integer	Peringkat bintang, 1–5 (hanya ulasan)
date	String	Stempel waktu interaksi dalam format ISO 8601
permalink	String	Tautan langsung ke interaksi di situs sumber
category	String	Kelompok tingkat atas, e.g, `Review` atau `Social`
type	String	Tipe interaksi spesifik, `Review`, `Question`, `Comment`, `Recommendation`, `Post`, `Photo`, `Message`, `Response`
responded	Boolean	Apakah terdapat respons dari pemilik
notes	String	Catatan pribadi pemilik akun
responses	Array	Respons pemilik yang terkait dengan interaksi ini (lihat di bawah)
responseCount	Integer	Jumlah respons yang terkait
canRespond	Boolean	Apakah respons dapat diposting melalui Listings API untuk sumber ini
locationId	Integer	ID numerik dalam basis data untuk lokasi pemilik interaksi
flaggedReason	String	Alasan interaksi ditandai, jika ada

Field objek respons

Setiap item dalam array responses pada interaksi (dan objek yang dikembalikan oleh Berikan respons terhadap interaksi):

Field	Tipe	Deskripsi
id	String	ID respons unik (berikan sebagai `responseId` saat mengedit atau mengarsipkan)
interactionId	String	ID interaksi yang terkait dengan respons ini
content	String	Teks respons
authorName	String	Nama yang ditampilkan sebagai pemberi respons
date	String	Stempel waktu pembuatan respons
respondedWith	String	ID templat respons yang digunakan, jika ada
respondedBy	Integer	ID pengguna Listings API yang mengirimkan respons
interactionStatus	String	Status siklus hidup, `CREATED`, `FAILED`, `COMPLETED`, atau `CONFIRMED`
editedResponse	Boolean	Apakah respons ini telah diedit sejak pertama kali diposting
remarks	String	Keterangan sistem (e.g, detail kegagalan)

Alur status respons

Field interactionStatus melacak respons selama proses posting ke situs sumber:

CREATED → COMPLETED: diposting ke platform publikasi; konfirmasi kedua tidak tersedia di platform tersebut
CREATED → COMPLETED → CONFIRMED: diposting lalu dikonfirmasi oleh platform publikasi
CREATED → FAILED: pengiriman ke platform publikasi tidak berhasil; lihat remarks

Enum filter

Endpoint dengan paginasi menerima nilai enum berikut sebagai filter:

responseStatus: RESPONDED, PENDING
sortOrder: NEWEST_FIRST, OLDEST_FIRST, LAST_RESPONDED
category: REVIEW (dan kelompok tingkat atas lainnya yang tersedia per akun)