Revisa la semántica del feed
La semántica del feed de opiniones es ligeramente matizada:
En el caso de los feeds de opiniones de instantáneas, haz lo siguiente:
- Cualquier proveedor de servicios en el feed de opiniones. Si el proveedor no existe actualmente en la base de datos de proveedores de LSA, no se incorporarán sus opiniones.
- Si el proveedor de servicios se encuentra en el feed de opiniones y existe actualmente en la base de datos de proveedores de LSA, sus opiniones se procesarán de la siguiente manera:
- Para cualquier opinión del feed, si la opinión correspondiente no existe en el almacenamiento de LSA, se debe crear.
- Para cualquier revisión en el feed, si existe la revisión correspondiente en el almacenamiento de LSA, se actualizará con la información nueva.
- En el caso de las opiniones que no estén en el feed, si existe la opinión correspondiente en el almacenamiento de LSA, se borrará.
- Si un proveedor de servicios no se encuentra en el feed de opiniones y existe actualmente en la base de datos de proveedores de LSA, se borrarán sus opiniones y dejará de prestar servicios.
- Ten en cuenta que un proveedor con 0 opiniones también debe tener una entrada (en lugar de omitirse) en los feeds de opiniones para que se muestren (consulta el ejemplo de feed de opiniones, listingId 2).
Ten en cuenta que no se admite el formato incremental para los feeds de opiniones. Se requiere un feed de opiniones correspondiente para cada feed de perfil.
Manejo de errores en las opiniones
Si un elemento del feed de opiniones no es válido, omitiremos su procesamiento y continuaremos con el procesamiento de los elementos del feed válidos restantes.
Si un feed de opiniones no es válido (p.ej., no cumple con el esquema), dejaremos de procesar todo el feed.
Revisa los campos
Nombre del campo | Tipo | Descripción | Ejemplo | Obligatorio | Limitaciones |
---|---|---|---|---|---|
serviceProviderId | número | Identificador único de una ficha (un proveedor de servicios) | 12345 | Sí | Debe caber en int64. |
ratingCount | integer | Cantidad de calificaciones de consumidores verificadas | 10 | Sí | Debe ser cero o más. |
author | string | El nombre del autor de la opinión | "Jack L." | No | |
reviewId | string | Es el ID único de la opinión. Si cada opinión no incluye un ID único, se necesita un tercero para generar un ID único para cada opinión (p. ej., hash del texto de la opinión y el usuario), que sea único al menos entre todas las opiniones de un proveedor. | “123” | Sí | |
reviewText | string | Texto de la opinión escrito por el autor | “¡Buen trabajo!”. | No | |
clasificación | integer | Calificación (debe ser un número entero entre 1 y 5) | 4 | Sí | Debe ser un número entero entre 1 y 5. |
serviceLocationCity | string | Ciudad en la que se realizó el servicio | “Nueva York” | No | |
reviewTimestampMicros | integer | Es la marca de tiempo en la que se escribió la opinión, en formato de microsegundos. | 1.45142E+15 | No | |
serviceTimestampMicros | integer | Es la marca de tiempo en formato de microsegundos en la que finalizó el servicio. | 1.45132E+15 | No | |
idioma | string | Idioma del texto de la opinión en código de idioma ISO 639-1 (minúsculas, 2 letras). Debe coincidir con un idioma de segmentación del proveedor. | “en” | No | Debe coincidir con un idioma de segmentación especificado para el proveedor asociado. El valor predeterminado es “en” si no se especifica. |
categoría | objeto | estructura de categorías | No | ||
category->categoryId | enum | categoría del servicio (en la taxonomía de LSA) | "garage_door_pro" | No | |
category->task | enum | Tipo de trabajo (tarea) del servicio (en la taxonomía de LSA) | "Reparar una puerta de cochera" | No | |
confirmedCustomer | booleano | Si la opinión proviene de un cliente confirmado (con un cliente potencial) | TRUE | No |