/api/v4/locations/{locationId}/voice-assistantsDapatkan profil bisnis pada asisten suara untuk suatu lokasi
Mengembalikan status sinkronisasi profil bisnis pada asisten suara untuk suatu lokasi di Google Assistant, Alexa, Siri, Cortana, dan Bixby.
Parameter
Path
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| locationId | string | wajib | Location ID. Accepts either the base64-encoded node ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or the raw numeric database ID (e.g. `1800289`). |
Respons
200Array of voice assistant listings with per-assistant sync status.
{ "data": { "voiceAssistantsForLocation": [ { "databaseId": "104468723", "voiceIdentifier": "GOOGLE_ASSISTANT", "name": "Google Assistant", "connectedAccountId": null, "syncStatus": "REQUIRING_ACTION", "actionRequired": true, "syncIssue": null, "errors": [] }, { "databaseId": "104468711", "voiceIdentifier": "SIRI", "name": "Siri", "connectedAccountId": null, "syncStatus": "IN_PROGRESS", "actionRequired": false, "syncIssue": null, "errors": [] }, { "databaseId": "104468714", "voiceIdentifier": "ALEXA", "name": "Alexa", "connectedAccountId": null, "syncStatus": "IN_PROGRESS", "actionRequired": false, "syncIssue": null, "errors": [] } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Mengembalikan status profil bisnis pada asisten suara untuk satu lokasi. Listings API menyinkronkan data lokasi ke Google Assistant, Amazon Alexa, Apple Siri, Microsoft Cortana, dan Samsung Bixby agar bisnis muncul dalam hasil penelusuran suara. Segmen path locationId menerima ID node base64 dari respons lokasi mana pun atau ID database numerik mentah; keduanya merujuk ke lokasi yang sama.
Kasus penggunaan: tampilkan profil bisnis pada asisten suara yang "memerlukan tindakan" di dasbor. Tampilkan widget kesiapan penelusuran suara per lokasi dengan menelusuri array dan menandai setiap entri yang nilai actionRequired-nya adalah true atau nilai syncIssue-nya bukan null. Dalam contoh di atas, Google Assistant dan Bixby memerlukan perhatian. Alasan paling umum Google Assistant memerlukan perhatian adalah belum adanya koneksi Google, karena hasilnya berasal dari koneksi Google Business Profile. Tautkan baris-baris tersebut ke Hubungkan Google agar pelanggan dapat menghubungkan akun. Hasil Siri berasal dari profil bisnis lokasi tersebut di Apple Maps.
Nilai status sinkronisasi: IN_PROGRESS (pengiriman sedang berlangsung), REQUIRING_ACTION (masukan pelanggan diperlukan sebelum Listings API dapat menyinkronkan), LIVE (dipublikasikan), dan NOT_SUBMITTED. errors adalah array string kesalahan dari sisi platform publikasi; connectedAccountId mengaitkan asisten dengan akun terhubung yang digunakan untuk sinkronisasi jika berlaku (e.g. Google Assistant melalui koneksi Google).
Endpoint ini diperhitungkan dalam batas laju permintaan akun Anda. Jika Anda memeriksa status asisten suara secara berkala di banyak lokasi, telusuri lokasi-lokasi tersebut halaman demi halaman melalui endpoint daftar lokasi dan beri jeda antar pemanggilan; 429 menyertakan header Retry-After yang memberi tahu Anda kapan harus melanjutkan.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/voice-assistants' \ -H "Authorization: API $LISTINGSAPI_KEY"