这是indexloc提供的服务，不要输入任何密码
Threads API

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メディアコンテナを作成します。

パラメーター

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

  • is_carousel_item — 単一のスレッド投稿の場合、デフォルト値はfalseです。カルーセルに表示される画像または動画を示します。
  • image_url — (画像専用。)画像へのパス。指定されたURLから画像をcURLで取得するため、画像は公開サーバーにある必要があります。
  • media_type — TEXT、IMAGE、またはVIDEOのいずれかに設定してください。現在のメディアタイプを示します。注: タイプCAROUSELは、単一のスレッド投稿には利用できません。
  • video_url — (動画専用。)動画へのパス。指定されたURLから動画をcURLで取得するため、動画は公開サーバーにある必要があります。
  • text — 投稿に関連付けられたテキスト。textフィールド内に含まれる最初のURLが、投稿のリンクプレビューとして使われます。テキストのみの投稿の場合、このパラメーターは必須です。

リクエストの例

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=IMAGE&image_url=https://www.example.com/images/bronz-fonz.jpg&text=#BronzFonz&access_token=<ACCESS_TOKEN>"

応答の例

{
  "id": "1234567" // Threads Media Container ID
}

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

POST /{threads-user-id}/threads_publishエンドポイントを使って、前のステップで返されたコンテナIDを公開します。Metaのサーバーがアップロードを完全に処理する時間を確保するため、Threadsメディアコンテナを公開する前に平均30秒待つことをおすすめします。詳しくは、メディアコンテナステータスエンドポイントをご覧ください。

パラメーター

  • creation_id — /threadsエンドポイントから作成されたThreadsメディアコンテナのID。

リクエストの例

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

応答の例

{
  "id": "1234567" // Threads Media ID
}

カルーセル投稿

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

  1. POST /{threads-user-id}/threadsエンドポイントを使って、カルーセルに表示される各画像と動画の個々のアイテムコンテナを作成します。
  2. もう一度POST /{threads-user-id}/threadsエンドポイントを使って、これらのアイテムのカルーセルコンテナを1つ作成します。
  3. カルーセルコンテナを公開するには、POST /{threads-user-id}/threads_publishエンドポイントを使います。

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

制限

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

ステップ1: アイテムコンテナの作成

カルーセルに表示する画像または動画のアイテムコンテナを作成するには、POST /{threads-user-id}/threadsエンドポイントを使います。

パラメーター

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

  • is_carousel_item — trueに設定します。画像または動画がカルーセルに表示されることを示します。
  • image_url — (画像専用。)画像へのパス。渡されたURLを使用して画像にcURLが付けられるため、公開サーバー上のパスでなければなりません。
  • media_type — IMAGEまたはVIDEOに設定します。メディアが画像か動画であることを示します。
  • video_url — (動画専用。)動画へのパス。渡されたURLを使用して動画にcURLが付けられるため、このパスは公開サーバー上のパスでなければなりません。

注: カルーセル投稿ではtextフィールドは任意ですが、textフィールド内に含まれる最初のURLが投稿のリンクプレビューとして使われます。

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

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

リクエストの例

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?image_url=https%3A%2F%2Fsol...&is_carousel_item=true&access_token=<ACCESS_TOKEN>"

応答の例

{
  "id": "1234567"
}

ステップ2: カルーセルコンテナの作成

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

パラメーター

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

  • media_type — CAROUSELに設定されます。コンテナがカルーセル用であることを示します。
  • children — 公開されるカルーセルに表示する各画像および/または動画のコンテナIDを、最大20個までカンマ区切りで指定します。カルーセルには最低2つ、最大20個までの画像や動画、またはその組み合わせを含めることができます。
  • text— (任意。)投稿に関連付けられたテキスト。

リクエストの例

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

応答の例

{
  "id": "1234567"
}

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

カルーセル投稿を公開するには、POST /{threads-user-id}/threads_publishエンドポイントを使います。プロフィールは24時間以内に公開できる投稿数が250件に制限されています。カルーセルの公開は1件の投稿としてカウントされます。

パラメーター

以下のパラメーターは必須です。

  • creation_id — カルーセルコンテナID。

操作が成功した場合、APIはカルーセルアルバムのThreadsメディアIDを返します。

リクエストの例

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

応答の例

{
  "id": "1234567" // Threads Media ID
}

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

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

トピックタグ

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

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

注: トピックタグでは次の文字は使用できません。

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

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

注: この方法はおすすめしませんが、既存機種との互換性を確保するために残されています。

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

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

  • 有効なタグはハッシュ記号(#)で始まります。
  • テキストはアプリ内でハッシュ記号なしでも設定されています。
  • ハッシュ記号に続く整数(例: #1)はタグとして変換されません。この場合、#が番号記号を示しているとみなされるためです。
  • Threads APIでテキスト内タグを使う際、以下の文字は使えません。そのため、ハッシュ記号で始まるテキスト内タグはこれらの文字の直前で終了します。
    • スペース、タブ、改行文字
    • ピリオド (.)
    • アンパーサンド(&)
    • アットマーク (@)
    • 感嘆符 (!)
    • 疑問符 (?)
    • カンマ (,)
    • セミコロン (;)
    • コロン (:)

リンク

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

制限

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

公開

リンクは、POST /threadsエンドポイントへのリクエスト時にメディアオブジェクトを作成する際に添付できます。APIリクエストには必ず以下のパラメーターを含めてください。

  • link_attachment — (テキスト投稿のみ。)Threads投稿に添付され、リンクプレビューとして表示されるURL。これは有効で、公開されているURLでなければなりません。
リクエストの例
curl -i -X POST \  
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=TEXT&text=Link&access_token=<ACCESS_TOKEN>" 
  -d link_attachment=https://developers.facebook.com/
応答の例
{
  "id": "1234567" // Threads Media Container ID
}

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

メディアの取得

リンク添付用URLの値は、GET /threadsまたは GET /{threads\_media\_id}エンドポイントにリクエストを送り、メディアオブジェクトを取得する際に取得できます。APIリクエストには必ず以下のフィールドを含めてください。

  • link_attachment_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": "12312312312123",
   "link_attachment_url": "https://developers.facebook.com/",
}

メディア仕様

画像の仕様

  • フォーマット: 公式にサポートされる画像投稿のフォーマットは、画像タイプ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。