公開

Threadsの公開エンドポイントを使うと、Threadsのメディアオブジェクトをアップロードして公開し、そのステータスを確認できます。詳しくは、Threadsへの投稿をご覧ください。

`POST /{threads-user-id}/threads`

メディアをアップロードし、メディアコンテナを作成します。詳しくは、投稿をご覧ください。

パラメーター

名前	説明
`access_token` 文字列	必須。 ThreadsグラフAPIユーザーアクセストークン。
`threads-user-id` 文字列	必須。 ThreadsユーザーIDのパスパラメーター。
`media_type` 文字列	必須。値:`TEXT`、`IMAGE`、`VIDEO`、`CAROUSEL`
`text` 文字列	任意。投稿に関連するテキスト。UTF-8エンコーディングを使います。テキストのみの投稿の場合、このパラメーターは必須です。注: 投稿の文字制限に関して、絵文字はUTF-8バイト数としてカウントされます。
`image_url` 文字列	任意。 `media_type=IMAGE`の場合は必須です。
`video_url` 文字列	任意。 `media_type=VIDEO`の場合は必須です。
`is_carousel_item` ブーリアン	任意。値:`true`、`false` (デフォルト)
`children` 配列	任意。 `media_type=CAROUSEL`の場合は必須です。
`reply_to_id` 文字列	任意。投稿に返信する場合は必須です。
`reply_control` 文字列	任意。投稿に返信できる人を指定するために使用できます。値:`everyone`、`accounts_you_follow`、`mentioned_only`、`parent_post_author_only`、`followers_only`
`allowlisted_country_codes` リスト<string>	任意。このメディアを表示する国を表す、有効なISO 3166-1 alpha-2国コードの文字列リスト。このパラメーターが渡されると、このリストにない国のThreadsプロフィールには当該メディアが表示されません。
`alt_text` 文字列	任意。 Threads投稿内の画像や動画のアクセシビリティ用テキストラベルまたは説明。注:`alt_text`の最大長は1,000文字です。
`link_attachment` 文字列	任意。 Threads投稿に添付されたURL。
`quote_post_id` 文字列	任意。引用する予定の投稿のID。
`poll_attachment` オブジェクト	任意。アンケートを添付した投稿のオプション。
`auto_publish_text` ブーリアン	任意。このオプションのフラグが渡されると、Threadsのメディアコンテナ作成時に、追加の公開ステップを経ずに自動で投稿が公開されます。注意: これはテキスト投稿のみで有効です。
`topic_tag` 文字列	任意。投稿に追加するトピック。注: トピックタグでは以下の文字は使用できません。ピリオド (.) アンパサンド(&)
`is_spoiler_media` ブーリアン	任意。メディアがネタバレになるものかどうかを示します。値:`true`、`false`
`text_entities` オブジェクト	任意。投稿のネタバレ設定。
`text_attachment` オブジェクト	任意。投稿の添付テキスト。
`gif_attachment` オブジェクト	任意。投稿に添付するGIFのIDとGIFプロバイダー。フィールド:`gif_id`、`provider`

`POST /{threads-user-id}/threads_publish`

アップロードされたメディアを、それぞれのメディアコンテナを使って公開します。詳しくは、投稿をご覧ください。

パラメーター

名前	説明
`access_token` 文字列	必須。 ThreadsグラフAPIユーザーアクセストークン。
`threads-user-id` 文字列	必須。 ThreadsユーザーIDのパスパラメーター。
`creation_id` 文字列	必須。 ThreadsメディアコンテナのID。

`GET /{threads-container-id}?fields=status`

Threadsメディアコンテナの公開可能性とステータスを確認します。

パラメーター

名前	説明
`access_token` 文字列	必須。 ThreadsグラフAPIユーザーアクセストークン。
`threads-container-id` 文字列	必須。 ThreadsメディアコンテナIDのパスパラメーター。
`fields` 文字列	任意。返されるフィールドのカンマ区切りリスト。値:`id`(デフォルト)、`status`(デフォルト)、`error_message`

`POST /{threads-media-id}/repost`

以前に公開されたThreads投稿を再投稿します。詳しくは再投稿をご覧ください。

パラメーター

名前	説明
`access_token` 文字列	必須。 ThreadsグラフAPIユーザーアクセストークン。
`threads-media-id` 文字列	必須。 ThreadsメディアIDのパスパラメーター。

`DELETE /{threads-media-id}`

Threads投稿を削除します。詳しくは投稿を削除をご覧ください。

パラメーター

名前	説明
`access_token` 文字列	必須。 ThreadsグラフAPIユーザーアクセストークン。
`threads-media-id` 文字列	必須。 ThreadsメディアIDのパスパラメーター。