予約投稿をキャンセルする

公開待ちの投稿をキャンセルします。投稿はARCHIVEDに移行し、公開パイプラインの処理対象から除外されます。下書きも同じ方法でキャンセルできますが、公開済みの投稿はキャンセルできません。

ユースケース：クライアントが直前にキャンペーンを取りやめる場合。 カレンダーに予約投稿が表示されている状態でクライアントが方針を変更したため、自社のUIからその投稿をキャンセルします。ブランドの投稿一覧から投稿のidをそのまま取得し、このエンドポイントを呼び出すと、その行はARCHIVEDに移行し、次回の読み取り時には{"status":["SCHEDULED"]}フィルターの結果から除外されます。

ユースケース：チャネルの接続を解除する前に投稿を整理する場合。 接続を解除しても、その接続にすでにキュー登録されている投稿はキャンセルされません。代わりに、公開時にSY95045で失敗します。先に予約投稿をキャンセルしてから接続を解除すれば、顧客に失敗が表示されることはありません。

注意事項。

• リクエストボディはinputオブジェクトでラップする必要があります。
• HTTPステータスではなく、successを確認してください。 投稿が公開済み、またはキャンセル済みの場合は、success: falseを伴うHTTP 200が返されます。
• この操作は削除ではありません。 どのプラットフォームからも何も削除されません。公開済みの投稿は公開されたままとなり、この呼び出しではその投稿についてsuccess: falseを報告するだけです。ソーシャル投稿を非公開にするエンドポイントはありません。削除はプラットフォーム上で直接行います。
• キャンセルは、投稿のすべてのチャネルに対して一括で適用されます。あるプラットフォームで予約投稿をキャンセルしながら、別のプラットフォームでは公開させることはできないため、そのような操作が必要な場合は投稿を個別に作成してください。
• キャンセル後もGET /social/posts/{postId}で投稿を読み取ることができ、post.statusはARCHIVEDになります。

書き込み操作：実際のアカウントに対しては実行していません。表示されているリクエストとレスポンスは、APIスキーマから作成したものです。