Elenca i suggerimenti di collegamento

Restituisce gli abbinamenti suggeriti tra le sedi di Listings API e le schede di Google Business Profile o Facebook rilevati eseguendo i trigger di corrispondenza sull'account collegato. Ogni record mostra sia i dettagli della sede di Listings API sia la scheda corrispondente sulla piattaforma di pubblicazione, in modo che un operatore possa confrontarli prima di confermare.

I suggerimenti vengono generati in modo asincrono da POST /connected-accounts/trigger-matches. Se hai appena collegato un account, chiama prima trigger-matches, altrimenti records è vuoto e pageInfo.totalRecords è 0. (Quando viene eseguito su un account reale appena collegato per il quale non ci sono ancora corrispondenze, questo endpoint restituisce {"data":{"connectionSuggestionsForAccount":{"pageInfo":{"hasNextPage":false,"hasPreviousPage":false,"totalPages":0,"totalRecords":0},"records":[]}}}.) L'esempio sopra mostra la struttura di un record popolato.

Caso d'uso: flusso di verifica prima della conferma. Dopo aver importato l'account Google di un cliente, interroga periodicamente questo endpoint per visualizzare ogni corrispondenza suggerita nella tua interfaccia di verifica. Un operatore approva gli abbinamenti corretti e tu passi gli ID dei record approvati a POST /connected-accounts/confirm-matches.

Identificazione di un record. Un record di suggerimento non ha un campo id. Il suo identificatore è matchedDataDatabaseId, la chiave primaria del record di corrispondenza sottostante; accountType indica di quale tipo di record di corrispondenza si tratta (GMB, FB o APPLE). Conferma le corrispondenze richiede entrambi i valori per costruire l'id che accetta, quindi mantieni insieme la coppia quando prepari i suggerimenti per la verifica.

Paginazione e limiti di frequenza. Usa i parametri di query non annidati page e perPage per la paginazione (ad esempio ?page=2&perPage=50) e tieni d'occhio pageInfo.hasNextPage. Non esistono parametri pageInfo, filters, sortBy o accountId: l'account collegato è ricavato dal percorso, l'ordinamento è fisso e crescente in base alle informazioni sulla sede e qualsiasi altro parametro che invii viene ignorato anziché rifiutato. Questo endpoint è soggetto a limiti di frequenza come gli altri endpoint di elenco; quando ricevi 429, rallenta e riprova dopo l'intervallo indicato dal valore dell'header Retry-After, anziché aumentare la frequenza delle interrogazioni.