メインコンテンツへスキップ
DELETE
delete エンドポイントを使うと、Ayrshare 経由で送信されたコメント、または Ayrshare 外部で送信されたコメントのどちらでも削除できます。 各種 ID の詳細は Comments Overview を参照してください。

Ayrshare から送信されたコメントの削除

Ayrshare 経由で送信された、単一のコメントまたは投稿配下のすべてのコメントを削除します。 詳細は Ayrshare Post IDAyrshare Comment ID を参照してください。 対応プラットフォーム: Bluesky、Facebook、Instagram、LinkedIn、Reddit、TikTok、X/Twitter、YouTube。

Ayrshare 外部で送信されたコメントの削除

Ayrshare 経由で送信されていないコメントを、特定のソーシャルネットワークで返される commentId を使って削除します。 これはソーシャルネットワークからの Social Comment ID であり、Ayrshare の ID ではありません。 対応プラットフォーム: Facebook、Instagram、TikTok、X/Twitter、YouTube。
TikTok — 自作コメントのみ対応。 TikTok の DELETE /comments は、認証済み TikTok アカウント自身が投稿したコメント(例:Ayrshare の reply エンドポイント または TikTok アプリ内から直接投稿した返信)に対してのみ成功します。自分が所有する動画に対して他のユーザーが投稿したコメントを削除しようとしても、Ayrshare code: 328 が返されます。自身の TikTok 動画上の第三者コメントを管理する必要がある場合は、連携アカウントタイプで何が利用可能かをサポートで確認してください。
たとえば、Get Comments エンドポイントで searchPlatformIdtrue に設定して、特定の Instagram 投稿のすべてのコメントを取得します。
返される JSON には各コメントの commentId が含まれ、これを使ってコメントを削除できます。忘れずに searchPlatformIdtrue に設定してください。

Header Parameters

Path Parameters

id
string
必須
Ayrshare から送信されたコメントを削除する場合:
  • Ayrshare Post ID を指定して、Ayrshare 経由で送信されたすべてのコメントを削除します。
  • Ayrshare Comment ID を指定して、単一のコメントを削除します。
Ayrshare 外部で送信されたコメントを削除する場合:
  • ソーシャルネットワークの Social Comment ID を指定して、単一のコメントを削除します。
  • searchPlatformIdtrue に設定してください。

Body Parameters

platforms
array
Ayrshare 経由で送信されたコメントを削除する場合は必須。コメントを削除するプラットフォームを指定します。対応プラットフォーム: bluesky, facebook, instagram, linkedin, reddit, threads, tiktok, twitter, youtube
Deleting comments sent via Ayrshare
platform
string
ソーシャルネットワークの commentId に該当する Social Comment ID を使って削除する場合は必須。対応プラットフォーム: bluesky, facebook, instagram, threads, tiktok, twitter, youtube。一度に指定できるプラットフォームは 1 つのみです。
searchPlatformId
boolean
デフォルト:false
ソーシャルネットワークの commentId に該当する Social Comment ID を使って削除する場合、true に設定する必要があります。
Deleting comments with Social Comment ID
hide
boolean
デフォルト:false
TikTok のみ。videoId と併せて true に設定すると、TikTok コメントを削除する代わりに一般視聴者から非表示にします。成功レスポンスでは action: "hide" が返され、コメントがエコーバックされます。videoId なしで hide=true を送信すると HTTP 400 が返されます。非表示にされたコメントは、動画所有者には TikTok Studio 上で引き続き表示されます。
Hiding a TikTok comment
videoId
string
TikTok コメントを非表示にする場合(hide=true)に必須。コメントが属する TikTok 動画 ID。