Threads連携
Threads APP_ID・APP_SECRETの取得ガイド
Threadsアカウントの準備からMetaアプリの作成、Threads専用ID・シークレットの確認、テスター招待と連携テストまで順に説明します。
Meta開発者アプリコンソールを開く1. 連携するThreadsアカウントを準備
連携するThreadsプロフィールと、アプリを管理するMeta開発者アカウントを準備します。
- Threadsアプリまたはthreads.comにログインし、連携するプロフィールとユーザーネームを確認します。プロフィールがなければ先に作成します。
- 上記のMeta開発者コンソールにログインします。初回は開発者登録と画面で求められる認証を完了します。
- サービス運営者が管理するアカウントと連絡先メールアドレスを用意し、アプリの管理者権限を確認します。
公式ドキュメント: Threads APIの利用開始
2. 取得する値の一覧
APP_ID・APP_SECRETには以下のThreads専用の値を渡します。ユーザーアクセストークンは認可後に発行される別の値です。
| 受け渡す項目 | コピーする値 | 確認する場所 |
|---|---|---|
| APP_ID | Threads app ID | Use cases > Access the Threads API > Customize > Settings |
| APP_SECRET | 同じアプリのThreads app secret | 同じThreads設定画面のThreads app secret |
| Redirect URI | 開発者が指定した正確なHTTPS復帰先 | Client OAuth Settings > Valid OAuth redirect URIs |
公式ドキュメント: Threadsユースケースの設定
3. 作成前に開発者から受け取るもの
- 開発・本番環境のHTTPS Redirect URI、サービスURL、プライバシーポリシーとデータ削除処理のURLを受け取ります。URLを推測して入力しないでください。
- 投稿公開、返信の取得・管理、インサイトなど必要な機能とアクセス許可を決めます。使う機能に必要な許可だけを追加します。
- 連携解除用のDeauthorize callback URLとデータ削除用のData Deletion Requests URLを開発者に確認します。
4. Threadsアプリの作成とキーの確認
Meta開発者アプリを作成
My Apps > Create Appでアプリ名と連絡先メールアドレスを入力し、Access the Threads APIユースケースを選んで作成します。所有者情報など、コンソールが求める項目も入力します。
Threadsユースケースの設定を開く
Use cases > Access the Threads API > Customizeを開きます。threads_basicを確認し、投稿公開ならthreads_content_publishなど、開発者と決めた許可を追加します。
Threads専用ID・シークレットをコピー
対象ユースケースのSettingsでThreads app IDとThreads app secretの値全体をコピーします。秘密値を表示するための再認証はアカウント所有者が行います。
OAuth復帰先を保存
Client OAuth Settings > Valid OAuth redirect URIsに開発者指定のHTTPSアドレスを入力します。Deauthorize callback URLとData Deletion Requests URLも確認して保存します。
Threadsテスターを招待
Add or Remove Threads Test Users、またはApp roles > Roles > Add Peopleで、テストするThreadsユーザーネームをThreads Testerとして追加します。
公式ドキュメント: Threadsユースケースの設定
5. 復帰先とアクセス許可を確認
- 登録済みRedirect URIとログイン要求のredirect_uriは、プロトコル、ドメイン、パス、末尾のスラッシュまで一致させます。開発・本番のURLを区別します。
- 基本アクセスにはthreads_basic、投稿公開にはthreads_content_publishが必要です。返信取得はthreads_read_replies、返信管理はthreads_manage_replies、インサイトはthreads_manage_insightsを検討します。
- 開発者がThreads認可画面での同意とサーバーでのトークン交換を実装します。APP_SECRETをブラウザーに入れず、期限切れ・更新・再認証の処理も確認します。
公式ドキュメント: アクセストークンとアクセス許可 · 長期トークンと更新
5-1. 機能別API権限と承認要件
外部ユーザーが接続する前に、利用する以下の各権限をMeta App Reviewで承認してもらいます。threads_basicは必須で、その他は提供する機能に応じて追加・申請します。
| 権限 | 機能 | 承認要件 |
|---|---|---|
threads_basic | プロフィール・投稿などの基本アクセス | 外部ユーザー向けにはApp Review承認が必須 |
threads_content_publish | コンテンツの公開 | 投稿公開機能の提供にはApp Review承認が必須 |
threads_read_replies | 返信の取得 | 返信取得機能の提供にはApp Review承認が必須 |
threads_manage_replies | 返信の作成・管理 | 返信管理機能の提供にはApp Review承認が必須 |
threads_manage_insights | インサイトの取得 | 統計機能の提供にはApp Review承認が必須 |
- Use cases > Access the Threads API > Customizeで必要な権限を追加します。権限を追加するだけではMetaの承認は得られません。
- コンソールのApp ReviewまたはPublishの審査項目から利用する各権限を申請します。要求される用途説明、再現手順、デモ資料を提出し、権限ごとの承認状況を確認します。
- 必要な権限がすべて承認されたらアプリの公開要件を完了します。認可時にユーザーの同意を得て、付与されたトークンで機能が動作するか確認します。
公式ドキュメント: Threads APIの利用開始 · Threadsユースケースの設定
6. 招待の承認・連携テスト・公開
- 招待したThreadsアカウントにログインし、Settings > Account > Website permissionsでテスター招待を承認します。
- サービスのThreads連携ボタンからログインしてアクセスを許可します。プロフィール取得と、必要な投稿・返信・インサイト機能を開発者と確認します。
- アプリのロールを持たない外部ユーザー向けには、必要な許可のApp Review承認とアプリ公開が必要です。Publish画面で求められるアプリ情報、ポリシーURL、審査・認証を完了します。
公式ドキュメント: Threads APIの利用開始 · Threadsユースケースの設定
7. 開発者へ渡す項目
- アプリ名、Threads app ID(APP_ID)とThreads app secret(APP_SECRET)の値全体。
- 保存したRedirect URI、連携解除・データ削除処理のURL、開発・本番環境の区別、必要なアクセス許可。
- Threadsユーザーネーム、テスター招待の承認状況、アプリ公開と許可の審査状況。確認用画像は秘密値を隠して共有します。
設定が見つからない・連携に失敗する場合
- キーが見つからない:Access the Threads APIユースケースのSettingsを開いているか、管理者権限があるか確認します。
- テスターの連携失敗:招待したThreadsユーザーネーム、招待承認、ログイン中のアカウントが一致するか確認します。
- 認証・API呼び出しの失敗:同じアプリのThreads専用ID・シークレットか、Redirect URIと許可が正しいか、トークンが期限切れか確認します。
ドキュメント確認日:2026年11月22日。メニュー名や利用できる機能はコンソールのバージョン・言語により異なる場合があります。