このページでは、Threads予約投稿ツールで発生する可能性のあるエラーメッセージと対処法をまとめています。
トークン・認証関連
「アクセストークンが無効です」
原因: トークンの有効期限が切れた
対処:
- メニュー「🔥 Threads投稿管理」→「初期設定」→「OAuth認証」
- 再度認証を実行
「アクセストークンが設定されていません」
原因: 認証が完了していない
対処:
- 「設定」シートのB3セルを確認
- 空の場合は、OAuth認証を実行
「OAuthException」を含むエラー
原因: Threads API側で認証エラーが発生
対処:
- トークンを再取得(OAuth認証をやり直す)
- アプリの権限設定を確認
「Googleアカウントでログインしてください」
原因: GASの実行権限がない
対処:
- 一度ログアウトして再ログイン
- スプレッドシートを開き直す
投稿関連
「An unexpected error has occurred」
原因: Threads APIの一時的な不調
対処:
- ステータスを「待機中」に戻す
- 時間をおいて再度投稿されるのを待つ
「Rate limit exceeded」
原因: 短時間に投稿しすぎた
対処:
- 時間をおいてから再試行
- 投稿間隔を広げる
「Content policy violation」
原因: 投稿内容がThreadsのポリシーに違反
対処:
- 投稿文を確認・修正
- 禁止されている表現やリンクがないか確認
「Text exceeds maximum length」
原因: 文字数オーバー(500文字上限)
対処:
- 投稿文を500文字以内に短くする
- 長文分割機能を使用する
「投稿公開失敗」
原因: Threadsへの投稿が正常に完了しなかった
対処:
- 投稿内容を確認(禁止ワード、URL形式など)
- 画像URLが有効か確認
- 時間をおいて再試行
「コンテナ作成エラー」
原因: 投稿の下準備(コンテナ作成)でエラー
対処:
- 投稿内容に問題がないか確認
- 画像URLが正しい形式か確認
- Threads API側の一時的な問題の可能性あり
「カルーセルコンテナ作成エラー」
原因: 複数画像投稿の準備でエラー
対処:
- 画像URLが全て有効か確認
- 画像数が2〜10枚の範囲か確認
- 画像形式(JPG, PNG)を確認
「画像〇のコンテナ作成エラー」
原因: カルーセル内の特定画像でエラー
対処:
- エラーメッセージに記載された番号の画像を確認
- 該当画像のURLを再取得または差し替え
「投稿公開エラー」
原因: 投稿の最終公開処理でエラー
対処:
- コンテナは作成済みなので、しばらく待って再試行
- Threads APIのレート制限の可能性
「引用コンテナ作成エラー」/ 「引用投稿公開エラー」
原因: 引用投稿の処理でエラー
対処:
- 引用元の投稿URLが有効か確認
- 引用元が削除されていないか確認
画像関連
「アップロード失敗」
原因: 画像のアップロードに失敗
対処:
- ファイルサイズを確認(大きすぎないか)
- ファイル形式を確認(JPG, PNG, GIF, MP4)
- インターネット接続を確認
「tmpfiles.org アップロード失敗」
原因: 一時ホスティングサービスへのアップロード失敗
対処:
- 時間をおいて再試行
- 別の画像で試す
「URL書き込み失敗」
原因: アップロード後のURL保存でエラー
対処:
- シートの編集権限を確認
- 再度アップロードを試行
「セルが選択されていません」
原因: 画像アップロード時にセルが未選択
対処:
- 画像を挿入したいセルをクリックしてから実行
シート関連
「〇〇シートが見つかりません」
原因: 必要なシートが削除または名前変更された
対処:
- シート名を確認(正確な名前が必要)
- シートが存在しない場合は、マスターからコピーし直す
「並べ替えるデータがありません」
原因: 並べ替え対象のデータが空
対処:
- シートにデータがあるか確認
- ヘッダー行だけでなくデータ行があるか確認
分析関連
「投稿一覧取得エラー」
原因: Threads APIから投稿一覧を取得できなかった
対処:
- トークンが有効か確認
- APIのレート制限に達していないか確認
「メトリクス取得エラー」
原因: 投稿の反応数データを取得できなかった
対処:
- 投稿から6時間以上経過しているか確認
- 投稿が削除されていないか確認
「does not have permission」を含むエラー
原因: 他人の投稿や削除済み投稿のデータを取得しようとした
対処:
- 投稿履歴シートに他人の投稿が混ざっていないか確認
- 該当行を削除して再取得
トリガー関連
「全トリガー設定中にエラー」
原因: トリガーの設定処理でエラー
対処:
- 一度「全トリガーOFF」を実行
- 再度「全トリガーON」を実行
「全トリガー削除中にエラー」
原因: トリガーの削除処理でエラー
対処:
- GASエディタから手動でトリガーを削除
- 拡張機能 → Apps Script → トリガー(時計アイコン)
その他
「長文分割エラー」
原因: 長文の自動分割処理でエラー
対処:
- 投稿内容が極端に長すぎないか確認
- 特殊文字が含まれていないか確認
「メール送信エラー」
原因: エラー通知メールの送信に失敗
対処:
- メールアドレスが正しいか確認
- GASのメール送信上限に達していないか確認
エラーが解決しない場合
- スプレッドシートを開き直す - 一時的な問題が解決することがあります
- 数分待ってから再試行 - API側の一時的な問題の可能性
- トークン再取得 - 認証系のエラーは再認証で解決することが多い
- エラー通知メールを確認 - 詳細なエラー内容が記載されています