Synup
Schlüssel erstellen
v1Ressourcen/Reviews/getAntwortfreigaben auflisten

Antwortfreigaben auflisten

Listet Anfragen zur Freigabe von Antworten auf. Eine Antwortfreigabe ist ein Antwortentwurf auf eine Bewertung, den Ihre Agentur einem oder mehreren Benutzern des Kundenportals zur Freigabe schickt, bevor er live geht. Gibt ein Kundenbenutzer ihn frei, veröffentlicht Synup genau den freigegebenen Text, einschließlich seiner eigenen Änderung; er kann die Antwort auch für später planen oder Änderungen anfordern. Die Antwort enthält die neueste Anfrage je Bewertung, die neueste zuerst, aus höchstens 200 Anfragen, dazu die Anzahl der Anfragen, die auf den Kunden warten, und der Anfragen mit angeforderten Änderungen. Ein auf Kunden beschränktes Token sieht nur seine eigenen Kunden.

get/api/v1/reviews/reply-approvals
reviews:read
Query-Parameter
clientIdstringoptional
Nur Anfragen für diesen Kunden zurückgeben.
statusstring (pending | changes_requested | approved | scheduled | posted | failed | withdrawn | cancelled)optional
Nur Anfragen mit diesem Status zurückgeben.
reviewIdsstringoptional
Kommagetrennte Bewertungs-IDs, höchstens 200. Nur Anfragen für diese Bewertungen zurückgeben.
Antwort
dataobjectoptional
countsobjectoptional
Summen über die Kunden des Tokens oder für clientId, wenn Sie es angeben. status und reviewIds schränken sie nicht ein.
awaitingintegeroptional
Anfragen, die auf den Kunden warten (pending).
changesRequestedintegeroptional
Anfragen, die der Kunde mit der Bitte um Änderungen zurückgeschickt hat (changes_requested).
requestsarray of objectoptional
Die neueste Anfrage je passender Bewertung, die neueste zuerst.
reviewIdstringoptional
Die Bewertung, zu der diese Anfrage gehört.
idstringoptional
Die ID der Anfrage. Damit lesen Sie den Verlauf, senden eine Erinnerung oder ziehen die Anfrage zurück.
statusstring (pending | changes_requested | approved | scheduled | posted | failed | withdrawn | cancelled)optional
Der Stand der Anfrage: pending (wartet auf den Kunden), changes_requested (der Kunde hat Änderungen angefordert; weiter offen, er kann also noch freigeben oder Sie senden eine überarbeitete Antwort), approved (freigegeben, wird veröffentlicht), scheduled (freigegeben zur Veröffentlichung zu scheduledFor), posted (die Antwort ist live), failed (Veröffentlichung fehlgeschlagen, siehe error), withdrawn (Ihre Agentur hat sie zurückgezogen) oder cancelled (die Bewertung wurde auf anderem Weg beantwortet oder entfernt).
versionHashstringoptional
Ein Fingerabdruck des Textes. Er ändert sich mit jeder Textänderung, und eine Entscheidung des Kunden gilt nur für die Version, die er gesehen hat.
textstringoptional
Die Antwort in der Anfrage. Hat ein Kunde sie bearbeitet und entschieden, ist dies seine Version.
notestringoptional
Ihre Nachricht an die Kundenbenutzer oder null.
requestedAtstringoptional
Wann die Anfrage erstellt wurde.
scheduledForstringoptional
Wann eine geplante Antwort veröffentlicht wird, oder null.
errorstringoptional
Warum die Veröffentlichung fehlgeschlagen ist, oder null.
assigneesarray of objectoptional
Die Benutzer des Kundenportals, an die die Anfrage ging.
idstringoptional
Die ID des Kundenbenutzers.
namestringoptional
Sein Name oder seine E-Mail-Adresse, wenn kein Name hinterlegt ist.
emailstringoptional
Seine E-Mail-Adresse.
decidedBystringoptional
Der Name des Kundenbenutzers, der entschieden hat, oder null.
seenobjectoptional
Ob jemand die Anfrage geöffnet hat, und wo.
emailbooleanoptional
true, sobald jemand sie aus der E-Mail geöffnet hat.
portalbooleanoptional
true, sobald jemand sie im Portal angesehen hat.
lastCommentobjectoptional
Der neueste Kommentar eines Kundenbenutzers oder null.
bodystringoptional
Der Text des Kommentars.
bystringoptional
Der Name des Kundenbenutzers, der ihn geschrieben hat.
atstringoptional
Wann er geschrieben wurde.
emailSkippedstringoptional
Warum die letzte Benachrichtigungs-E-Mail nicht gesendet wurde, als kurzer Code (zum Beispiel switched_off, wenn die Person diese E-Mails abgeschaltet hat, oder portal_domain_required, wenn die Agentur keine Portaldomain hat). null, wenn die E-Mail gesendet oder noch nicht versucht wurde. Die Anfrage wartet in jedem Fall im Portal.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/reviews/reply-approvals
Ihr API-Schlüssel
clientId
status
reviewIds
{}

Anleitungen, die diese Ressource verwenden