/api/v4/connected-accounts/{connectedAccountId}/connection-suggestionsBağlantı önerilerini listeleme
Bağlı bir hesap için Listings API konumları ile Google Business Profile veya Facebook işletme kayıtları arasında önerilen eşleşmeleri döndürür.
Parametreler
Yol
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| connectedAccountId | string | zorunlu | UUID of the connected account to list suggestions for. |
Sorgu
| Ad | Tür | Zorunlu | Açıklama | Varsayılan |
|---|---|---|---|---|
| page | integer | isteğe bağlı | 1-based page number. | 1 |
| perPage | integer | isteğe bağlı | Records per page. | 20 |
Yanıtlar
200Paginated list of connection suggestions.
{ "data": { "connectionSuggestionsForAccount": { "pageInfo": { "hasNextPage": false, "hasPreviousPage": false, "totalPages": 1, "totalRecords": 2 }, "records": [ { "accountEmail": "contact@brightsmile-dental.com", "accountType": "GMB", "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5", "locationId": "73415", "matchedDataDatabaseId": "0d5e306f-0da0-46e3-929f-fd3c67ccd8cc", "locationInfo": { "name": "My Business", "city": "Lincoln", "stateIso": "NE" }, "suggestedLocationInfo": { "locationInfo": { "name": "My Business", "city": "Lincoln" } } } ] } }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Bağlı hesapta eşleştirme tetikleyicileri çalıştırılarak tespit edilen, Listings API konumları ile Google Business Profile veya Facebook işletme kayıtları arasında önerilen eşleşmeleri döndürür. Her kayıt, bir operatörün onaylamadan önce karşılaştırabilmesi için hem Listings API konum ayrıntılarını hem de eşleşen yayın platformu işletme kaydını gösterir.
Öneriler, POST /connected-accounts/trigger-matches tarafından eşzamansız olarak oluşturulur. Bir hesabı yeni bağladıysanız önce trigger-matches çağrısını yapın; aksi takdirde records boş olur ve pageInfo.totalRecords değeri 0 olur. (Henüz eşleşmesi olmayan, yeni bağlanmış bir hesap için canlı ortamda çağrıldığında bu uç nokta {"data":{"connectionSuggestionsForAccount":{"pageInfo":{"hasNextPage":false,"hasPreviousPage":false,"totalPages":0,"totalRecords":0},"records":[]}}} döndürür.) Yukarıdaki örnek, içeriği doldurulmuş bir kaydın yapısını gösterir.
Kullanım senaryosu: onay öncesi inceleme iş akışı. Bir müşterinin Google hesabını içe aktardıktan sonra, önerilen her eşleşmeyi kendi inceleme arayüzünüzde görüntülemek için bu uç noktayı düzenli aralıklarla sorgulayın. Bir operatör doğru eşleşmeleri onaylar ve siz de onaylanan kayıtların kimliklerini POST /connected-accounts/confirm-matches öğesine iletirsiniz.
Bir kaydı tanımlama. Bir öneri kaydında id alanı bulunmaz. Kaydın tanımlayıcısı, temelindeki eşleşme kaydının birincil anahtarı olan matchedDataDatabaseId değeridir; accountType ise bunun hangi tür eşleşme kaydı olduğunu (GMB, FB veya APPLE) belirtir. Eşleşmeleri onaylama, aldığı id değerini oluşturmak için her iki değere de ihtiyaç duyar; bu nedenle önerileri incelemeye hazırlarken bu iki değeri bir arada tutun.
Sayfalama ve istek hızı sınırları. Düz yapıdaki page ve perPage sorgu parametreleriyle (örneğin ?page=2&perPage=50) sayfalama yapın ve pageInfo.hasNextPage değerini takip edin. pageInfo, filters, sortBy veya accountId parametresi yoktur: bağlı hesap yoldan belirlenir, sıralama konum bilgilerine göre artan olarak sabitlenmiştir ve gönderdiğiniz diğer tüm parametreler reddedilmek yerine yok sayılır. Diğer listeleme uç noktaları gibi bu uç nokta da istek hızı sınırına tabidir; 429 durumunda sorgulama sıklığınızı artırmak yerine istekleri yavaşlatın ve Retry-After başlığının değerinde belirtilen süre geçtikten sonra yeniden deneyin.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/connection-suggestions' \ -H "Authorization: API $LISTINGSAPI_KEY"