/api/v4/locations/reviews/respond/archiveArchiver une réponse
Archive une réponse existante du propriétaire et la retire des réponses actives suivies pour une interaction.
Paramètres
Corps
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| responseId | string | obligatoire | ID of the response to archive (the `id` from an interaction's `responses` array). |
Exemple de requête
Corps prêt à coller. Remplacez les identifiants et valeurs d’exemple par les vôtres.
{ "responseId": "2090753a-ece6-4837-8336-8494ad308523"}Réponses
200Response archived. `data.archiveResponse.status` is `"true"` on success.
{ "data": { "archiveResponse": { "status": "true" } }}401Unauthenticated, missing or invalid API key.
Archive une réponse précédemment publiée à une interaction. L’archivage est une suppression logique du cache local de Listings API : il retire la réponse de responses suivi pour l’interaction, mais ne la retire pas de la plateforme source. Les réponses déjà publiées sur Google, Yelp ou Facebook y restent en ligne.
Récupérez responseId dans responses[].id d’une interaction via Obtenir des interactions par identifiants ou Lister les interactions.
Cas d’utilisation : supprimer un brouillon de réponse remplacé
Si une réponse a été créée par erreur ou remplacée avant sa publication, archivez-la pour garder la liste responses de l’interaction en ordre et son indicateur responded exact dans votre tableau de bord :
{ "responseId": "2090753a-ece6-4837-8336-8494ad308523"}Pour modifier la formulation d’une réponse déjà en ligne sur le site source, utilisez plutôt Modifier une réponse : l’archivage ne la supprimera pas de la plateforme de publication.
curl -X POST 'https://listingsapi.com/api/v4/locations/reviews/respond/archive' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "responseId": "2090753a-ece6-4837-8336-8494ad308523" }'