/api/v4/locations/{locationId}/reviews/settingsListar las fuentes de reseñas de una ubicación
Devuelve las fuentes de reseñas configuradas para una sola ubicación, junto con sus URL de conexión.
Parámetros
Ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| locationId | string | obligatorio | Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID. |
Respuestas
200Review-source sites and their configured URLs for the location.
{ "data": { "interactionsSetting": { "siteSettings": [ { "name": "maps.google.com", "url": null }, { "name": "facebook.com", "url": null }, { "name": "yelp.com", "url": null } ] } }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Devuelve la configuración de las fuentes de reseñas de una ubicación. Cada entrada de siteSettings es una plataforma compatible con el plan de la cuenta. Un valor de url distinto de null significa que esa plataforma está conectada y que Listings API está obteniendo reseñas de esa URL; null url (como se muestra arriba para la ubicación activa Jenny Home, que aún no tiene fuentes de terceros asociadas) significa que la plataforma está disponible, pero aún no está configurada.
Caso de uso: identificar qué fuentes aún necesitan una URL
Obtén esta lista y filtra por url: null para crear la lista de plataformas que el propietario de una ubicación aún debe conectar. Las fuentes de reseñas se asocian automáticamente una vez que se conectan los perfiles de Google y Facebook de la ubicación; conecta esas cuentas para completar las URL que faltan:
{ "name": "yelp.com", "url": "https://www.yelp.com/biz/your-listing" }Después de la edición, se devuelve la misma plataforma con un valor en url en lugar de null.
Caso de uso: auditar las fuentes conectadas en un conjunto de ubicaciones
Recorre tus ubicaciones (obtenidas de Listar todas las ubicaciones) y llama a este endpoint para cada ubicación para generar un informe de cobertura de las fuentes de reseñas. Como se realiza una solicitud por ubicación, respeta el límite de solicitudes de la cuenta, espacia las llamadas y, si recibes 429, vuelve a intentarlo una vez transcurrido el tiempo indicado en el encabezado Retry-After, en lugar de enviar solicitudes sin pausa.
Google y Facebook conectados mediante OAuth aparecen automáticamente como conectados y no se pueden sobrescribir mediante el endpoint de edición. Usa Listar las fuentes de reseñas de una cuenta, cuyo alcance abarca toda la cuenta, para ver el conjunto completo de plataformas que el plan podría admitir.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/reviews/settings' \ -H "Authorization: API $LISTINGSAPI_KEY"