/api/v4/connected-accountsBağlı hesapları listeleyin
Listings API hesabınıza bağlı Google ve Facebook hesaplarını, bağlantı sağlığı ve bağlı konum sayılarıyla birlikte döndürür.
Parametreler
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 |
| publisher | string | isteğe bağlı | Narrow to one publisher by account type: `GoogleAccount`, `FacebookAccount`, `AppleAccount`, `YelpAccount`, `TripadvisorAccount`, `LinkedinAccount`, `PinterestAccount`, or `TwitterAccount`. | — |
| status | string | isteğe bağlı | Narrow to one connection status: `Connected`, `NotConnected`, or `ConnectionIssue`. Note the mixed case, and that these are not the values the response's own `status` field uses. | — |
Yanıtlar
200List of connected accounts with pagination metadata.
{ "data": { "connectedAccountsInfo": { "pageInfo": { "hasNextPage": false, "hasPreviousPage": false, "totalPages": 1, "totalRecords": 1 }, "records": [ { "accountId": "12345", "clientName": "owner@brightsmile-dental.com", "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5", "connectedAccountType": "GoogleAccount", "connectedLocationsCount": 0, "connectivityIssue": null, "email": "owner@brightsmile-dental.com", "lastFetchMatchesRequestedAt": "2026-07-06 21:43:07 UTC", "remarks": null, "requestMatches": false, "requestMatchesStatus": "MATCH_COMPLETED", "status": "CONNECTED" } ] } }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Listings API hesabınıza bağlanma yetkisi verilmiş tüm Google Business Profile ve Facebook Pages hesaplarını döndürür. Her kayıt, bağlantı sağlığını (status, connectivityIssue), kaç konumun bağlı olduğunu (connectedLocationsCount) ve son eşleşme getirme işleminin durumunu (requestMatchesStatus) içerir.
Kullanım senaryosu: senkronizasyondan önce bağlantı sağlığını denetleyin. Kimlik bilgilerinin geçerliliği sona ermiş hesapları bulmak için bunu her gece çalışan bir görevin başında çalıştırın. connectivityIssue değeri null olmayan veya status değeri CONNECTED dışında bir değer olan her kayıt için müşterinin bağlantı akışı üzerinden yeniden yetki vermesi gerekir; geçersiz kimlik bilgileri için gereksiz bir trigger-matches çağrısı yapmamak üzere bu kayıtları atlayın.
Kullanım senaryosu: sonraki çağrılar için bir connectedAccountId belirleyin. trigger-matches, fetch-listings, folders ve details uç noktalarının tümü anahtar olarak connectedAccountId kullanır. Hesapları listeleyin, email değeri müşteriyle eşleşen hesabı seçin ve bu hesabın connectedAccountId değerini yeniden kullanın.
Sayfalama ve filtreleme, JSON yerine basit, düz sorgu parametreleri kullanır: page, perPage, publisher ve status. pageInfo, filters veya sort parametresi yoktur ve sıralamayı değiştirmenin bir yolu yoktur: sonuçlar her zaman hesap e-posta adresine göre artan sırada sıralanır. Gönderdiğiniz diğer her şey reddedilmek yerine yok sayılır; bu nedenle JSON biçiminde gönderilen bir pageInfo, herhangi bir uyarı olmadan 1. sayfanın döndürülmesine yol açar.
curl -s 'https://listingsapi.com/api/v4/connected-accounts?page=1&perPage=20&publisher=GoogleAccount&status=Connected' \ -H "Authorization: API $LISTINGSAPI_KEY"status filtresi ile status alanı aynı değer kümesini kullanmaz. Filtre Connected, NotConnected veya ConnectionIssue kabul eder; döndürülen her kayıttaki status ise CONNECTED, MATCH_IN_PROGRESS veya CONNECTIVITY_ISSUE değerindedir. Bir kaydın kendi status değerini filtre olarak geri göndermek, geçersiz bir enum değeri göndermek anlamına gelir ve 400 döndürülmesine yol açar.
Bir sonraki sayfayı getirip getirmeyeceğinize karar vermek için yanıttaki pageInfo.hasNextPage ve pageInfo.totalPages değerlerini okuyun. Bu uç noktaya yapılan çağrılar, hesap düzeyindeki istek hızı sınırına dahil edilir; bir 429 yanıtı, Retry-After üst bilgisini içerir.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts' \ -H "Authorization: API $LISTINGSAPI_KEY"