Synup
Crear clave
v1Recursos/Reviews/getListar aprobaciones de respuestas

Listar aprobaciones de respuestas

Lista las solicitudes de aprobación de respuestas. Una aprobación de respuesta es un borrador de respuesta a una reseña que tu agencia envía a uno o más usuarios del portal del cliente para que lo aprueben antes de publicarse. Cuando un usuario del cliente la aprueba, Synup publica exactamente el texto aprobado, incluida su propia edición; también puede programarla para más tarde o pedir cambios. La respuesta incluye la solicitud más reciente de cada reseña, de la más nueva a la más antigua, tomada de un máximo de 200 solicitudes, junto con el número de solicitudes que esperan al cliente y de las devueltas con cambios. Un token restringido a clientes solo ve sus propios clientes.

get/api/v1/reviews/reply-approvals
reviews:read
Parámetros de consulta
clientIdstringopcional
Devolver solo solicitudes de este cliente.
statusstring (pending | changes_requested | approved | scheduled | posted | failed | withdrawn | cancelled)opcional
Devolver solo solicitudes con este estado.
reviewIdsstringopcional
IDs de reseñas separados por comas, hasta 200. Devolver solo solicitudes de estas reseñas.
Respuesta
dataobjectopcional
countsobjectopcional
Totales de los clientes del token, o de clientId cuando lo envías. status y reviewIds no los acotan.
awaitingintegeropcional
Solicitudes que esperan al cliente (pending).
changesRequestedintegeropcional
Solicitudes que el cliente devolvió pidiendo cambios (changes_requested).
requestsarray of objectopcional
La solicitud más reciente de cada reseña que coincide, de la más nueva a la más antigua.
reviewIdstringopcional
La reseña a la que corresponde esta solicitud.
idstringopcional
El ID de la solicitud. Úsalo para leer el historial, enviar un recordatorio o retirar la solicitud.
statusstring (pending | changes_requested | approved | scheduled | posted | failed | withdrawn | cancelled)opcional
En qué punto está la solicitud: pending (espera al cliente), changes_requested (el cliente pidió cambios; sigue abierta, así que aún puede aprobarla o tú puedes enviar una respuesta revisada), approved (aprobada y en proceso de publicación), scheduled (aprobada para publicarse en scheduledFor), posted (la respuesta está publicada), failed (la publicación falló, consulta error), withdrawn (tu agencia la retiró) o cancelled (la reseña recibió respuesta por otra vía o se eliminó).
versionHashstringopcional
Una huella del texto. Cambia cada vez que cambia el texto, y la decisión del cliente solo cuenta para la versión que vio.
textstringopcional
La respuesta de la solicitud. Si un cliente la editó y decidió, es su versión.
notestringopcional
Tu mensaje para los usuarios del cliente, o null.
requestedAtstringopcional
Cuándo se creó la solicitud.
scheduledForstringopcional
Cuándo se publicará una respuesta programada, o null.
errorstringopcional
Por qué falló la publicación, o null.
assigneesarray of objectopcional
Los usuarios del portal del cliente a los que se envió la solicitud.
idstringopcional
El ID del usuario del cliente.
namestringopcional
Su nombre, o su correo electrónico si no tiene nombre.
emailstringopcional
Su correo electrónico.
decidedBystringopcional
El nombre del usuario del cliente que decidió, o null.
seenobjectopcional
Si alguien abrió la solicitud, y dónde.
emailbooleanopcional
true cuando alguien la abrió desde el correo.
portalbooleanopcional
true cuando alguien la vio en el portal.
lastCommentobjectopcional
El comentario más reciente de un usuario del cliente, o null.
bodystringopcional
El texto del comentario.
bystringopcional
El nombre del usuario del cliente que lo escribió.
atstringopcional
Cuándo se escribió.
emailSkippedstringopcional
Por qué no se envió el último correo de notificación, como un código corto (por ejemplo switched_off si la persona desactivó estos correos, o portal_domain_required si la agencia no tiene dominio de portal). null si el correo se envió o aún no se intentó. En cualquier caso, la solicitud sigue esperando en el portal.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/reviews/reply-approvals
Su clave de API
clientId
status
reviewIds
{}

Guías que usan este recurso