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

Hapus postingan

Menghapus kampanye postingan media sosial secara permanen dan menghapusnya dari setiap situs tempat kampanye tersebut dipublikasikan.

Memerlukan kunci API. Lihat Autentikasi untuk format header dan rotasi kunci.

Parameter

Path

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

Body

NamaTipeWajibDeskripsi
clientMutationIdstringopsionalOptional client-supplied token returned unchanged in the response, for correlating the request.

Contoh permintaan

Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.

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

Respons

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

Menghapus kampanye postingan yang ditentukan. Tindakan ini bersifat permanen: postingan dihapus dari Listings API dan ditarik dari setiap situs tempat postingan tersebut dipublikasikan (Google, Facebook). Menghapus postingan yang masih tayang akan menghapusnya dari profil yang terhubung; tindakan ini tidak dapat dibatalkan.

Kasus penggunaan: menarik pengumuman yang keliru. Jika pengumuman telah dipublikasikan dengan jam operasional yang salah, hapus pengumuman tersebut dengan DELETE /posts/{postId} (menggunakan id dari daftar postingan), konfirmasikan success: true, lalu publikasikan pengumuman yang telah diperbaiki dengan POST /posts. Untuk menghapus kampanye dari setiap toko sekaligus, hapus kampanye massal menggunakan ID massalnya.

Catatan.

  • Isi permintaan bersifat opsional. Kirim clientMutationId hanya jika Anda ingin nilainya dikembalikan tanpa perubahan untuk korelasi permintaan; cuplikan kode yang dihasilkan menyertakannya sebagai contoh.
  • Postingan yang periode tayang terjadwalnya telah berakhir mungkin melaporkan status: EXPIRED dan tidak lagi tayang di setiap situs, tetapi menghapusnya tetap akan menghilangkannya dari Listings API.
  • Menghapus postingan yang sudah dihapus atau tidak dikenal akan mengembalikan respons kesalahan ({"data":null,"errors":[...]}), bukan success: true.

Operasi tulis: tidak dijalankan pada akun aktif. Permintaan dan respons yang ditampilkan dibuat berdasarkan skema API.

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