Daftar sumber ulasan untuk suatu lokasi

Mengembalikan pengaturan sumber ulasan untuk satu lokasi. Setiap entri dalam siteSettings adalah platform yang didukung oleh paket akun tersebut. Nilai url yang bukan null berarti platform tersebut terhubung dan Listings API sedang mengambil ulasan dari URL tersebut; null url (seperti yang ditunjukkan di atas untuk lokasi aktif Jenny Home, yang belum memiliki sumber pihak ketiga yang terhubung) berarti platform tersebut tersedia tetapi belum dikonfigurasi.

Kasus penggunaan: menemukan sumber yang masih memerlukan URL

Ambil daftar ini dan filter berdasarkan url: null untuk menyusun daftar platform yang masih perlu dihubungkan oleh pemilik lokasi. Sumber ulasan ditambahkan secara otomatis setelah profil Google dan Facebook lokasi tersebut terhubung; hubungkan akun-akun tersebut untuk mengisi URL yang belum tersedia:

{ "name": "yelp.com", "url": "https://www.yelp.com/biz/your-listing" }

Setelah pengeditan, platform yang sama dikembalikan dengan url yang telah terisi, bukan lagi null.

Kasus penggunaan: mengaudit sumber yang terhubung di seluruh kumpulan lokasi

Lakukan iterasi pada lokasi Anda (dari Daftar semua lokasi) dan panggil endpoint ini untuk setiap lokasi guna melaporkan cakupan sumber ulasan. Karena diperlukan satu permintaan per lokasi, patuhi batas laju permintaan akun, beri jeda antar-panggilan, dan saat menerima 429, coba lagi setelah waktu tunggu yang ditentukan dalam header Retry-After, alih-alih terus mengirim permintaan secara bertubi-tubi.

Google dan Facebook yang dihubungkan melalui OAuth secara otomatis ditampilkan sebagai terhubung dan tidak dapat ditimpa melalui endpoint pengeditan. Gunakan Daftar sumber ulasan untuk suatu akun yang mencakup seluruh akun untuk melihat semua platform yang dapat didukung oleh paket tersebut.