Etkileşim öznitelikleri başvuru kılavuzu

Etkileşim nesneleri, Bir konumun etkileşimlerini listeleme, Toplu etkileşimleri alma ve Etkileşimleri kimliklerine göre alma tarafından döndürülür. Sayfalama kullanan iki endpoint, bu nesneleri Relay tarzı bir bağlantı yapısıyla sarmalar: data.interactions (konum başına) ve data.rollupInteractions (hesap genelindeki toplu sonuçlar) yapılarının her biri edges[].node, pageInfo ve totalCount içerir. Kimliklere göre getirme işleminde sayfalama kullanılmaz; data.interactionDetails, edges, pageInfo veya totalCount içermeyen düz bir { "interactions": [ ... ] } nesnesidir.

Etkileşim alanları

Alan	Tür	Açıklama
id	String	Etkileşimin UUID'si. Yanıt verirken `interactionId` olarak iletin
interactionId	String	`id` ile aynı UUID
source	String	Yorum sitesinin veya sosyal sitenin ana makine adı (e.g. `maps.google.com`, `yelp.com`)
title	String	Kaynak tarafından sağlanıyorsa etkileşim başlığı
content	String	Yorumun veya gönderinin gövde metni
authorName	String	Yazarın görünen adı
rating	Integer	Yıldız puanı, 1–5 (yalnızca yorumlar için)
date	String	Etkileşimin ISO 8601 biçimindeki zaman damgası
permalink	String	Kaynak sitedeki etkileşime doğrudan bağlantı
category	String	Üst düzey kategori, e.g. `Review` veya `Social`
type	String	Belirli etkileşim türü, `Review`, `Question`, `Comment`, `Recommendation`, `Post`, `Photo`, `Message`, `Response`
responded	Boolean	İşletme sahibinin yanıtının bulunup bulunmadığı
notes	String	Hesap sahibinin özel notları
responses	Array	Bu etkileşime eklenen işletme sahibi yanıtları (aşağıya bakın)
responseCount	Integer	Eklenen yanıtların sayısı
canRespond	Boolean	Bu kaynak için Listings API üzerinden yanıt yayımlanıp yayımlanamayacağı
locationId	Integer	Etkileşimin ait olduğu konumun sayısal veritabanı kimliği
flaggedReason	String	Varsa, etkileşimin işaretlenme nedeni

Yanıt nesnesinin alanları

Bir etkileşimin responses dizisindeki her öğe (ve Bir etkileşime yanıt verme tarafından döndürülen nesne):

Alan	Tür	Açıklama
id	String	Benzersiz yanıt kimliği (düzenlerken veya arşivlerken `responseId` olarak iletin)
interactionId	String	Bu yanıtın ait olduğu etkileşimin kimliği
content	String	Yanıtın metni
authorName	String	Yanıtlayan olarak gösterilen ad
date	String	Yanıtın oluşturulduğu anın zaman damgası
respondedWith	String	Varsa, kullanılan yanıt şablonunun kimliği
respondedBy	Integer	Yanıtı gönderen Listings API kullanıcısının kimliği
interactionStatus	String	Yaşam döngüsü durumu, `CREATED`, `FAILED`, `COMPLETED` veya `CONFIRMED`
editedResponse	Boolean	Bu yanıtın ilk yayımlandığından bu yana düzenlenip düzenlenmediği
remarks	String	Sistem açıklamaları (e.g. hata ayrıntısı)

Yanıt durumu akışı

interactionStatus alanı, kaynak siteye yayımlanma süreci boyunca yanıtı takip eder:

CREATED → COMPLETED: yayın platformunda yayımlandı; bu platformda ikinci bir doğrulama yapılamaz
CREATED → COMPLETED → CONFIRMED: yayımlandı ve ardından yayın platformu tarafından doğrulandı
CREATED → FAILED: yayın platformuna gönderim başarılı olmadı; remarks alanına bakın

Filtre enum değerleri

Sayfalama kullanan endpoint'ler şu enum değerlerini filtre olarak kabul eder:

responseStatus: RESPONDED, PENDING
sortOrder: NEWEST_FIRST, OLDEST_FIRST, LAST_RESPONDED
category: REVIEW (ve her hesap için sunulan diğer üst düzey kategoriler)