[go: up one dir, main page]
Threads API
日本語に戻す
このドキュメントが更新されました。
日本語への翻訳がまだ完了していません。
英語の最終更新: 10月6日

Threadsの投稿

Threads APIを使って、画像、動画、テキスト、またはカルーセル投稿を公開できます。

このドキュメントでは、以下について説明します。

単一のスレッド投稿

画像、動画、またはテキストの単一投稿の公開は、次の2段階のプロセスです。

  1. POST /{threads-user-id}/threadsエンドポイントを使って、テキストのみ、または公開サーバーでホストされている画像や動画と任意のテキストのメディアコンテナを作成する。
  2. POST /{threads-user-id}/threads_publishエンドポイントを使って、メディアコンテナを公開する。

制限

  • テキスト投稿は500文字までに制限されています。

ステップ1: Threadsメディアコンテナを作成する

POST /{threads-user-id}/threadsエンドポイントを使って、Threadsメディアコンテナを作成します。

パラメーター

名前説明

is_carousel_item

ブーリアン

必須。
画像や動画がカルーセルに表示されることを表します。

値:true、false(単一のスレッド投稿のデフォルト)

media_type

文字列

必須。
現在のメディアタイプを表します。

値:TEXT、IMAGE、VIDEO

注:CAROUSELは単一のスレッド投稿には利用できません。

image_url

URL

任意。media_type=IMAGEには必須。
画像のURLパス。

注: 指定されたURLから画像をcURLで取得するため、画像は公開サーバーにある必要があります。

video_url

URL

任意。media_type=VIDEOには必須。
動画のURLパス。

注: 指定されたURLから動画をcURLで取得するため、動画は公開サーバーにある必要があります。

text

文字列

任意。media_type=TEXTには必須。
投稿に関連するテキスト。URLが含まれている場合、textフィールド内の最初のURLが、投稿のリンクプレビューとして使われます。

追加の対応パラメーターについては、POST /{threads-user-id}/threadsエンドポイントのリファレンスをご覧ください。

リクエストの例

curl -i -X POST \ -d "media_type=IMAGE" \ -d "image_url=<IMAGE_URL>" \ -d "text=<TEXT>" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads"

応答の例

{
  "id": "<THREADS_MEDIA_CONTAINER_ID>"
}

ステップ2: Threadsメディアコンテナを公開する

POST /{threads-user-id}/threads_publishエンドポイントを使って、前のステップで返されたメディアコンテナIDを公開します。

Metaのサーバーがアップロードを完全に処理する時間を確保するため、Threadsメディアコンテナを公開する前に平均30秒待つことをおすすめします。詳しくは、メディアコンテナステータスエンドポイントをご覧ください。

パラメーター

名前説明

creation_id

整数

必須。
ThreadsメディアコンテナのID。

リクエストの例

curl -i -X POST \ -d "creation_id=<MEDIA_CONTAINER_ID>" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publish"

応答の例

{
  "id": "<THREADS_MEDIA_ID>"
}

カルーセル投稿

カルーセル投稿では、最大20枚の画像、動画、またはその組み合わせを公開できます。カルーセルの公開は、3ステップのプロセスです。

  1. POST /{threads-user-id}/threadsエンドポイントを使って、カルーセルに表示される画像や動画ごとに個別のメディアコンテナを作成する。
  2. POST /{threads-user-id}/threadsエンドポイントを使って、メディアコンテナを含む単一のカルーセルコンテナを作成する。
  3. POST /{threads-user-id}/threads_publishエンドポイントを使ってカルーセルコンテナを公開する。

カルーセル投稿は、プロフィールのレート制限において1件の投稿としてカウントされます。

制限

  • カルーセルの画像、動画、またはそれらの組み合わせは20個までに制限されています。
  • カルーセルには最低2つの子要素が必要です。

ステップ1: メディアコンテナを作成する

POST /{threads-user-id}/threadsエンドポイントを使って、カルーセルに表示される個々の画像や動画のメディアコンテナを作成します。

パラメーター

名前説明

is_carousel_item

ブーリアン

必須。
trueに設定されている場合、画像や動画がカルーセルに表示されることを表します。

値:true、false

media_type

文字列

必須。
現在のメディアタイプを表します。

値:IMAGE、VIDEO

注:CAROUSELは単一のスレッド投稿には利用できません。

image_url

URL

任意。media_type=IMAGEには必須。
画像のURLパス。

注: 指定されたURLから画像をcURLで取得するため、画像は公開サーバーにある必要があります。

video_url

URL

任意。media_type=VIDEOには必須。
動画のURLパス。

注: 指定されたURLから動画をcURLで取得するため、動画は公開サーバーにある必要があります。

text

文字列

任意。
投稿に関連するテキスト。URLが含まれている場合、textフィールド内の最初のURLが、投稿のリンクプレビューとして使われます。

追加の対応パラメーターについては、POST /{threads-user-id}/threadsエンドポイントのリファレンスをご覧ください。

リクエストの例

curl -i -X POST \ -d "image_url=<IMAGE_URL>" \ -d "is_carousel_item=true" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads"

応答の例

{
  "id": "<THREADS_MEDIA_CONTAINER_ID>"
}

処理が成功すると、APIからメディアコンテナIDが返されます。カルーセルコンテナ作成時にそれを使うことができます。

カルーセルに表示される画像や動画ごとに、この処理を繰り返します。

ステップ2: カルーセルコンテナを作成する

POST /{threads-user-id}/threadsエンドポイントを使って、カルーセルコンテナを作成します。

パラメーター

名前説明

media_type

文字列

必須。
現在のメディアタイプを表します。

値:CAROUSEL

children

リスト<int>

必須。
公開したカルーセルに表示される画像や動画のメディアコンテナIDのコンマ区切りリスト。

注: カルーセルには最低2つ、最大20個までの画像や動画、またはその組み合わせを含める必要があります。

text

文字列

任意。
投稿に関連するテキスト。

追加の対応パラメーターについては、POST /{threads-user-id}/threadsエンドポイントのリファレンスをご覧ください。

リクエストの例

curl -i -X POST \ -d "media_type=CAROUSEL" \ -d "children=<MEDIA_ID_1>,<MEDIA_ID_2>,<MEDIA_ID_3>,..." \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads"

応答の例

{
  "id": "<THREADS_CAROUSEL_CONTAINER_ID>"
}

ステップ3: カルーセルコンテナを公開する

カルーセル投稿を公開するには、POST /{threads-user-id}/threads_publishエンドポイントを使います。

注: プロフィールは24時間以内に公開できる投稿数が250件に制限されています。カルーセルの公開は1件の投稿としてカウントされます。

パラメーター

名前説明

creation_id

整数

必須。
ThreadsカルーセルコンテナのID。

リクエストの例

curl -i -X POST \ -d "creation_id=<MEDIA_CONTAINER_ID>" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publish"

応答の例

{
  "id": "<THREADS_MEDIA_ID>"
}

処理が成功すると、APIからカルーセルアルバムのThreadsメディアIDが返されます。

投稿内のトピックタグとリンク

トピックやリンクは、投稿のエンゲージメントを促す形で表示されます。

トピックタグ

トピックは、中心となる話題を作り出し、投稿をよりソーシャルなものにします。topic_tagパラメーターを使うか投稿のテキストにトピックを含めることで、投稿にトピックを含められます。

topic_tagパラメーターを使用する

注: トピックタグは1～50文字で指定する必要があります。次の文字は使用できません。

  • ピリオド(.)
  • アンパサンド(&)
curl -i -X POST \ -d "media_type=TEXT" \ -d "text=<Text>" \ -d "access_token=<ACCESS_TOKEN>" \ -d "topic_tag=<TAG>" \ "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads"

テキスト内トピックタグを使用する

これはおすすめの方法ではありませんが、後方互換性を確保するために残されています。

投稿のテキスト内にトピックをインラインで含めることで、投稿に添付することもできます。1件の投稿に使えるトピックタグは1つだけであり、API経由で投稿されたあらゆるタイプ(テキストのみ、画像、動画、カルーセル)の中で最初に有効なタグが、その投稿のタグとして扱われます。

テキスト内タグを使って投稿にトピックを追加する際は、以下の点に注意してください。

  • 有効なタグはハッシュ記号(#)で始まります。
  • テキストはアプリ内でハッシュ記号なしでも設定されています。
  • トピックは1～50文字で指定する必要があります。
  • ハッシュ記号に続く整数(例: #1)はタグとして変換されません。この場合、#が番号記号を示しているとみなされるためです。

  • Threads APIでテキスト内タグを使う際、以下の文字は使えません。そのため、ハッシュ記号で始まるテキスト内タグはこれらの文字の直前で終了します。

    • スペース、タブ、改行文字
    • ピリオド(.)
    • アンパサンド(&)
    • アットマーク (@)
    • 感嘆符 (!)
    • 疑問符 (?)
    • カンマ (,)
    • セミコロン (;)
    • コロン (:)

リンク

投稿にリンクを添付するには、メディアコンテナの作成時にlink_attachmentパラメーターを使います。link_attachmentパラメーターが指定されない場合、API経由のテキストのみの投稿で最初に含まれるリンクがリンク添付として設定され、プレビューカードとして表示されます。これにより、ユーザーがより簡単に反応したりクリックしたりできるようになります。

制限

  • この機能はテキストのみの投稿でのみ利用可能です。画像、動画、カルーセル投稿では機能しません。

公開

リンクは、POST /threadsエンドポイントにAPI呼び出しをしてメディアコンテナを作成する際に添付できます。

名前説明

link_attachment

URL

任意。
Threadsの投稿に添付され、リンクプレビューとして表示されるURL。これは公開されている有効なURLであることが必要です。

注: media_type=TEXTの投稿でのみ使用できます。

リクエストの例
curl -i -X POST \ -d "media_type=TEXT" \ -d "text=<TEXT>" \ -d "access_token=<ACCESS_TOKEN>" \ -d "link_attachment=<URL> \ "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads"
応答の例
{
  "id": "<THREADS_MEDIA_CONTAINER_ID>"
}

上記のリクエストでThreadsメディアコンテナが作成され、公開されるとメディアにリンクプレビューが添付されます。

メディアの取得

link_attachmentのURLの値は、GET /threadsまたはGET /{threads_media_id}エンドポイントにリクエストを送り、メディアオブジェクトを取得することで取得できます。

名前説明

link_attachment_url

URL

Threads投稿に添付されたURL。

リクエストの例
curl -s -X GET \ "https://graph.threads.net/v1.0/<THREADS_MEDIA_ID>?fields=id,link_attachment_url&access_token=<ACCESS_TOKEN>"
応答の例
{
   "id": "<THREADS_MEDIA_ID>",
   "link_attachment_url": "<LINK_ATTACHMENT_URL>",
}

メディア仕様

画像の仕様

  • フォーマット: 公式にサポートされる画像投稿のフォーマットは、画像タイプJPEGおよびPNGです。
  • ファイルサイズ: 最大8 MB。
  • アスペクト比制限: 10:1
  • 最小幅: 320 (必要な場合、この最小幅まで拡大されます)
  • 最大幅: 1440 (必要な場合、この最大幅まで縮小されます)
  • 高さ: (幅やアスペクト比に応じて)可変
  • 色空間: sRGB。画像で他の色空間を使っている場合は、sRGBに変換されます。

動画の仕様

  • コンテナ: MOVまたはMP4 (MPEG-4 Part 14)、編集リストなし、ファイルの先頭にmoov atom。
  • 音声コーデック: AAC、最大サンプルレート48 kHz、1または2チャンネル(モノラルまたはステレオ)。
  • 動画コーデック: HEVCまたはH264、プログレッシブスキャン、クローズドGOP、クロマサブサンプリング4:2:0。
  • フレームレート: 23-60 FPS
  • 写真サイズ:
    • 最大カラム(水平ピクセル数): 1920
    • 必須アスペクト比は0.01:1～10:1ですが、トリミングや余白を避けるため9:16にすることをおすすめします。
  • 動画ビットレート: VBR、最大100 Mbps。
  • 音声ビットレート: 128 kbps。
  • 長さ: 最大300秒(5分)、最小0秒以上。
  • ファイルサイズ: 最大1 GB。

関連項目