ソーシャル投稿を作成

1つのブランドの接続済みソーシャルアカウント（1つ以上）に向けて、投稿を1件作成します。同じ呼び出しで、DRAFTの保存、SCHEDULEのキューへの追加、即時のPUBLISHという3つのライフサイクルすべてに対応します。

ユースケース：独自のカレンダーからキャンペーンを予約する。 アプリには、クライアントが何をいつ発信したいかがすでに登録されています。各枠について、action: "SCHEDULE"と、scheduledAtまたはscheduleDate + scheduleTimeのいずれかを指定してこのエンドポイントを呼び出し、返されたUUIDを保存せずに照合できるように、独自の枠の識別子をclientReferenceとして渡します。GET /social/posts/{postId}ですべてのチャネルでの公開が確認できるまでは、その項目を保留中として表示し、POST /social/posts/cancelを呼び出すキャンセルボタンを用意します。

公開は非同期で行われます

action: "PUBLISH"は、応答を返す前に公開を行うことはありません。この呼び出しは投稿を受け付け、socialPostIdを返して、投稿を公開パイプラインに渡します。実際の結果を確認するには、GET /social/posts/{postId}をポーリングし、チャネルごとのchannels[]配列を読み取ります。各要素のstatusが、そのプラットフォームの結果を示します。同じリクエストでも、Instagramでは投稿に成功し、LinkedInでは失敗する場合があるため、channels[]が実際の結果を示し、投稿レベルのstatusはその概要を示します。

スケジュールの選択

action: "SCHEDULE"には、次の2つの形式のうち必ずどちらか1つを指定する必要があり、両方を指定することはできません。

両方を送信した場合、scheduleDateをscheduleTimeなしで送信した場合、またはオフセットのないscheduledAtを送信した場合は、SY95046で拒否されます。DRAFTとPUBLISHには、スケジュールを一切含めてはいけません。

注意事項。

• リクエストボディはinputオブジェクトでラップする必要があります。
• HTTPステータスではなく、successを確認してください。 検証に失敗すると、HTTP 200が返され、success: falseと、問題ごとに1つの要素を持つerror配列が含まれます。successがfalseの場合、何も作成されません。
• ブランドはボディ内のsocialProfileIdで識別します。brandIdはURLパスのトークンとしてのみ使用され、ボディのフィールドとして使用されることはありません。
• platforms内のすべてのプラットフォームが、そのブランドですでに接続されている必要があります。 有効なチャネルがないプラットフォームはSY95045で失敗するため、まずブランドの接続を確認し、未接続のものについては接続リンクを通じてユーザーに接続してもらいます。
• プラットフォームの値は、大文字の列挙名FACEBOOK、INSTAGRAM、TWITTER、LINKEDIN、PINTERESTです。TWITTERはXを指し、値には旧名称が維持されており、小文字の値は拒否されます。
• InstagramとPinterestはテキストのみの投稿を受け付けないため、どちらかがplatformsに含まれる場合は、mediaUrlsの要素を少なくとも1つ指定してください。
• 投稿IDは通常のUUIDであり、拠点の投稿で使用するBase64のrelay IDではありません。
• 一度に数件を超える投稿を扱う場合は、同じ行形式を受け取り、バッチ全体を事前に検証するPOST /social/bulk-postsを使用してください。

書き込み操作：実際のアカウントに対しては実行していません。表示されているリクエストとレスポンスはAPIスキーマに基づいて作成されたものであり、実行すると実際のソーシャルアカウントに投稿が公開されます。