v1Recursos/Reviews/postResponder a una reseña

Responder a una reseña

Publica la respuesta del propietario a una reseña o la reemplaza: una reseña tiene una sola respuesta, así que una segunda llamada edita la primera (Google la actualiza; en Facebook se edita nuestro comentario de respuesta). pushed: false significa que la respuesta aún no está publicada: o la plataforma la aceptó y todavía la está publicando (status pending), o la plataforma no tiene API de respuestas y solo se guardó en Synup. Falla con 422 si no se puede responder a la reseña o la plataforma la rechazó; retryable indica si volver a intentarlo puede funcionar.

post/api/v1/reviews/reply
reviews:write
Cuerpo de la solicitud
reviewIdstringobligatorio
La reseña a la que responder. Obligatorio.
textstringobligatorio
El texto de la respuesta a publicar. Obligatorio.
Respuesta
dataobjectopcional
okbooleanopcional
Si la respuesta fue aceptada.
pushedbooleanopcional
Si la respuesta está publicada en la plataforma de origen. False mientras la plataforma todavía la publica (status pending), o cuando la plataforma no tiene API de respuestas y la respuesta solo se guarda en Synup.
statusstring (posted | pending | failed | draft)opcional
Uno de: posted, pending, failed, draft.
externalReplyIdstringopcional
El id de la respuesta en la plataforma de origen, o null.
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.
404El recurso no se encontró, o no pertenece a su agencia.
422A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/reviews/reply
Su clave de API
Cuerpo de la solicitud*
{
  "data": {
    "ok": true,
    "pushed": true,
    "status": "posted",
    "externalReplyId": "ext_reply_123",
    "retryable": null
  }
}

Guías que usan este endpoint