/api/v4/connected-accounts/trigger-matchesIniciar la búsqueda de coincidencias de ubicaciones
Obtiene los perfiles de Google y Facebook de las cuentas conectadas y busca coincidencias con tus ubicaciones de Listings API.
Parámetros
Cuerpo
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| input | object | obligatorio | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountIds | array of strings | obligatorio | UUIDs of the connected accounts to trigger matches for. Taken from `GET /connected-accounts`. |
Solicitud de ejemplo
Cuerpo listo para pegar. Sustituye los ID y valores de ejemplo por los tuyos.
{ "input": { "connectedAccountIds": [ "4f712c17-4f95-42dd-90f4-97171a2e67b5" ] }}Respuestas
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.
Inicia el proceso asíncrono que recupera todos los perfiles de Google Business Profile y Facebook a los que pueden acceder las cuentas conectadas especificadas y busca coincidencias con tus ubicaciones de Listings API. Una respuesta success: true significa que el proceso se ha puesto en cola; la búsqueda de coincidencias se ejecuta en segundo plano.
Estructura de la solicitud. El cuerpo debe estar dentro de un objeto input que contenga connectedAccountIds, un array de las cuentas conectadas para las que se buscarán coincidencias. Si se envía un cuerpo plano, sin ese objeto contenedor, la solicitud se rechaza con un estado HTTP 400. Obtén los ID de las cuentas de GET /connected-accounts. Cuando una o más cuentas no se pueden poner en cola, sus ID se devuelven en failedIds y success es false.
Caso de uso: actualizar las sugerencias después de conectar una cuenta nueva. Inmediatamente después de que un cliente complete el flujo de conexión con Google, llama a trigger-matches con el connectedAccountId de esa cuenta. Esto genera las coincidencias de ubicaciones sugeridas para que tu interfaz de incorporación pueda mostrar "hemos encontrado N de tus fichas" sin que el cliente tenga que esperar a una sincronización programada.
Caso de uso: volver a buscar coincidencias después de añadir ubicaciones. Cuando crees en bloque nuevas ubicaciones de Listings API para una cuenta conectada existente, inicia una nueva búsqueda de coincidencias para que las nuevas ubicaciones se emparejen con sus fichas existentes de Google/Facebook.
Como el trabajo es asíncrono, no interpretes 200 como "búsqueda de coincidencias finalizada". Consulta periódicamente el endpoint de detalles de la cuenta conectada y espera a que requestMatchesStatus alcance el valor MATCH_COMPLETED; después, lee los resultados del endpoint connection-suggestions antes de llamar a confirm-matches o connect-listing.
Este endpoint pone en cola una consulta en tiempo real a Google/Facebook. La estructura de la solicitud y la respuesta de ejemplo anteriores están documentadas a partir de la especificación de la API; la llamada no se ejecuta sobre datos de producción.
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" ] } }'