v1Recursos/Social Listening/patchUpdate a listening topic
Update a listening topic
Edits a topic, or turns it on or off with status. Turning a topic on schedules its first collection for the next monthly update; it does not start one now. A client needs a connected social account before a topic can be turned on.
patch
listening:write/api/v1/listening/topics/{id}Parámetros de consulta
idstringobligatorio
The topic's id.
Cuerpo de la solicitud
clientIdstringobligatorio
The client (business) this concerns.
namestringopcional
The topic's name, up to 80 characters.
descriptionstringopcional
An optional note, up to 255 characters. Send null to clear it.
queryobjectopcional
A replacement query, in the same shape as when creating a topic.
sourcesarray of stringopcional
The networks to follow.
languagesarray of stringopcional
Up to five two-letter language codes.
statusstring (active | paused | suggested)opcional
active collects, paused stops, suggested keeps it as an idea.
Respuesta
dataobjectopcional
topicobjectopcional
The topic after the change.
collectsNextstringopcional
When an active topic will next be collected, as a date-time. Present only when the change turned a topic on.
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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
patch/api/v1/listening/topics/{id}
Su clave de API
id *
Cuerpo de la solicitud*
{}