/api/v4/connected-accounts/trigger-matchesPicu pencocokan lokasi
Mengambil profil Google dan Facebook untuk akun yang terhubung dan mencocokkannya dengan lokasi Listings API Anda.
Parameter
Body
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| input | object | wajib | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountIds | array of strings | wajib | UUIDs of the connected accounts to trigger matches for. Taken from `GET /connected-accounts`. |
Contoh permintaan
Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.
{ "input": { "connectedAccountIds": [ "4f712c17-4f95-42dd-90f4-97171a2e67b5" ] }}Respons
200Request accepted. `success` is `true` when the fetch-and-match job was queued for every account; accounts that could not be queued are returned in `failedIds` and `success` is `false`.
{ "data": { "connectedAccountsTriggerMatches": { "failedIds": null, "success": true } }}400Bad request, the body was not wrapped in `input` (error message: `Variable "$input" of required type "ConnectedAccountsTriggerMatchesInput!" was not provided`).
401Unauthenticated, missing or invalid API key.
Memulai tugas asinkron yang mengambil setiap Google Business Profile dan profil Facebook yang dapat diakses oleh akun terhubung yang ditentukan, lalu mencocokkannya dengan lokasi Listings API Anda. Respons success: true berarti tugas telah dimasukkan ke dalam antrean; proses pencocokannya sendiri berjalan di latar belakang.
Struktur permintaan. Isi permintaan harus dibungkus dalam objek input yang berisi connectedAccountIds, yaitu array akun terhubung yang akan dicocokkan. Pengiriman isi permintaan datar tanpa pembungkus ditolak dengan HTTP 400. Dapatkan ID akun dari GET /connected-accounts. Jika satu atau beberapa akun tidak dapat dimasukkan ke dalam antrean, ID akun tersebut dikembalikan dalam failedIds dan nilai success adalah false.
Kasus penggunaan: perbarui saran setelah menghubungkan akun baru. Segera setelah pelanggan menyelesaikan alur penghubungan Google, panggil trigger-matches dengan connectedAccountId akun tersebut. Tindakan ini mengisi saran kecocokan lokasi sehingga antarmuka orientasi Anda dapat menampilkan "kami menemukan N profil bisnis Anda" tanpa pelanggan harus menunggu sinkronisasi terjadwal.
Kasus penggunaan: jalankan ulang pencocokan setelah menambahkan lokasi. Saat Anda membuat lokasi Listings API baru secara massal untuk akun yang sudah terhubung, picu proses pencocokan baru agar lokasi baru tersebut dipasangkan dengan profil bisnis Google/Facebook yang sudah ada.
Karena proses ini bersifat asinkron, jangan menganggap 200 sebagai tanda bahwa "pencocokan telah selesai." Periksa endpoint detail connected-account secara berkala dan tunggu hingga requestMatchesStatus mencapai MATCH_COMPLETED, lalu baca hasilnya dari endpoint connection-suggestions sebelum memanggil confirm-matches atau connect-listing.
Endpoint ini memasukkan pengambilan data langsung dari Google/Facebook ke dalam antrean. Struktur permintaan dan contoh respons di atas didokumentasikan berdasarkan spesifikasi API; panggilan tersebut tidak dijalankan terhadap data produksi.
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/trigger-matches' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "connectedAccountIds": [ "4f712c17-4f95-42dd-90f4-97171a2e67b5" ] } }'