/api/v4/locations/reviews/respond/archiveأرشفة رد
يؤرشف ردًا موجودًا للمالك، ويزيله من الردود النشطة التي يجري تتبعها للتفاعل.
المعلمات
النص الأساسي
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| responseId | string | مطلوب | ID of the response to archive (the `id` from an interaction's `responses` array). |
مثال على الطلب
نص جاهز للصق. استبدل المعرّفات والقيم النموذجية بقيمك.
{ "responseId": "2090753a-ece6-4837-8336-8494ad308523"}الاستجابات
200Response archived. `data.archiveResponse.status` is `"true"` on success.
{ "data": { "archiveResponse": { "status": "true" } }}401Unauthenticated, missing or invalid API key.
يؤرشف ردًا سبق نشره على تفاعل. الأرشفة هي حذف منطقي من ذاكرة التخزين المؤقت المحلية لدى Listings API، وتزيل الرد من responses الذي يجري تتبعه للتفاعل، لكنها لا تسحبه من المنصة المصدر. تظل الردود المنشورة بالفعل على Google أو Yelp أو Facebook متاحة هناك.
احصل على responseId من responses[].id الخاص بالتفاعل عبر جلب التفاعلات حسب المعرّفات أو عرض قائمة التفاعلات.
حالة استخدام: إزالة مسودة رد استُبدلت بأخرى
إذا أُنشئ رد بالخطأ أو استُبدل قبل نشره، فأرشفه للحفاظ على قائمة responses الخاصة بالتفاعل خالية من الردود غير اللازمة، وعلى دقة علامة responded الخاصة به في لوحة التحكم:
{ "responseId": "2090753a-ece6-4837-8336-8494ad308523"}لتغيير صياغة رد نُشر بالفعل على الموقع المصدر، استخدم تعديل رد بدلًا من ذلك، فالأرشفة لن تزيله من منصة النشر.
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" }'