/api/v4/locations/{locationId}/voice-assistantsBir konumun sesli asistan işletme kayıtlarını alın
Bir konumun Google Assistant, Alexa, Siri, Cortana ve Bixby üzerindeki sesli asistan işletme kayıtlarının senkronizasyon durumunu döndürür.
Parametreler
Yol
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| locationId | string | zorunlu | Location ID. Accepts either the base64-encoded node ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or the raw numeric database ID (e.g. `1800289`). |
Yanıtlar
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.
Tek bir konumun sesli asistan işletme kayıtlarının durumunu döndürür. Listings API, işletmenin sesli arama sonuçlarında görünmesi için konum verilerini Google Assistant, Amazon Alexa, Apple Siri, Microsoft Cortana ve Samsung Bixby ile senkronize eder. locationId yol segmenti, herhangi bir konum yanıtındaki base64 node ID değerini veya ham sayısal veritabanı kimliğini kabul eder; her ikisi de aynı konumu belirtir.
Kullanım senaryosu: kontrol panelinde "işlem gerekli" durumundaki sesli asistan işletme kayıtlarını gösterme. Diziyi yineleyerek ve actionRequired değeri true olan veya syncIssue değeri null olmayan her öğeyi işaretleyerek konum başına sesli aramaya hazırlık durumunu gösteren bir bileşen oluşturun. Yukarıdaki örnekte Google Assistant ve Bixby için işlem yapılması gerekir. Google Assistant için işlem gerekmesinin en yaygın nedeni, sonuçları Google Business Profile bağlantısından geldiği için Google bağlantısının eksik olmasıdır. Müşterinin hesabı bağlayabilmesi için bu satırları Google'ı bağlayın sayfasına bağlayın. Siri sonuçları, konumun Apple Maps işletme kaydından gelir.
Senkronizasyon durumu değerleri: IN_PROGRESS (gönderim sürüyor), REQUIRING_ACTION (Listings API'nin senkronizasyon yapabilmesi için müşterinin bilgi sağlaması gerekiyor), LIVE (yayınlandı) ve NOT_SUBMITTED. errors, yayın platformu tarafındaki hata dizelerinden oluşan bir dizidir; connectedAccountId, ilgili bir bağlı hesap varsa asistanı senkronizasyonu sağlayan bu hesapla ilişkilendirir (e.g. Google bağlantısı üzerinden Google Assistant).
Bu endpoint'e yapılan çağrılar, hesabınızın istek hızı sınırına dahil edilir. Çok sayıda konumun sesli asistan durumunu düzenli olarak sorguluyorsanız konum listesi endpoint'ini kullanarak konumları sayfa sayfa alın ve çağrılar arasında zaman bırakın; 429 yanıtı, ne zaman devam edebileceğinizi belirten bir Retry-After başlığı içerir.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/voice-assistants' \ -H "Authorization: API $LISTINGSAPI_KEY"