Listings APIListings API
Anmelden
DELETE/api/v4/posts/{postId}

Beitrag löschen

Löscht eine Social-Media-Beitragskampagne dauerhaft und entfernt sie von jeder Website, auf der sie veröffentlicht wurde.

Erfordert einen API-Schlüssel. Format des Headers und Schlüsselrotation finden Sie unter Authentifizierung.

Parameter

Pfad

NameTypErforderlichBeschreibung
postIdstringerforderlichBase64-encoded social post ID to delete (the `id` from a posts list or the create response).

Body

NameTypErforderlichBeschreibung
clientMutationIdstringoptionalOptional client-supplied token returned unchanged in the response, for correlating the request.

Beispielanfrage

Body zum direkten Einfügen. Ersetzen Sie Platzhalter-IDs und -Werte durch Ihre eigenen.

Request body
{  "clientMutationId": "delete-44122-req-1"}

Antworten

200Post deleted. `socialPostId` returns the deleted post's ID.
Response
{  "data": {    "deleteSocialPost": {      "success": true,      "socialPostId": "U29jaWFsUG9zdDo0NDEyMg=="    }  }}
401Unauthenticated, missing or invalid API key.

Löscht die angegebene Beitragskampagne. Dies ist endgültig: Der Beitrag wird aus der Listings API entfernt und auf jeder Website, auf der er veröffentlicht wurde (Google, Facebook), zurückgezogen. Wenn Sie einen veröffentlichten Beitrag löschen, wird er von den verbundenen Profilen entfernt; dies lässt sich nicht rückgängig machen.

Anwendungsfall: eine fehlerhafte Ankündigung zurückziehen. Wenn eine Ankündigung mit falschen Öffnungszeiten veröffentlicht wurde, löschen Sie sie mit DELETE /posts/{postId} (unter Verwendung der id aus der Beitragsliste), bestätigen Sie success: true und veröffentlichen Sie anschließend eine korrigierte Ankündigung mit POST /posts. Um eine Kampagne gleichzeitig aus allen Filialen zu entfernen, löschen Sie stattdessen die Massenkampagne anhand ihrer Massen-ID.

Hinweise.

  • Der Request-Body ist optional. Senden Sie clientMutationId nur, wenn Sie den Wert zur Zuordnung der Anfrage unverändert zurückerhalten möchten; das generierte Codebeispiel enthält ihn als Beispiel.
  • Ein Beitrag, dessen geplanter Veröffentlichungszeitraum bereits abgelaufen ist, meldet möglicherweise status: EXPIRED und ist auf den jeweiligen Websites nicht mehr veröffentlicht. Durch das Löschen wird er dennoch aus der Listings API entfernt.
  • Beim Löschen eines bereits gelöschten oder unbekannten Beitrags wird eine Fehlerantwort ({"data":null,"errors":[...]}) anstelle von success: true zurückgegeben.

Schreiboperation: nicht im Live-Konto ausgeführt. Die gezeigte Anfrage und Antwort wurden anhand des API-Schemas erstellt.

Request
curl -X DELETE 'https://listingsapi.com/api/v4/posts/<postId>' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "clientMutationId": "delete-44122-req-1"  }'
Run in playground