LINEのメディア取得:Get Contentの202と外部コンテンツを切り分ける
LINEのメディアWebhookを受信しても、ファイル本体を取得したことにはなりません。画像・動画・音声では、まず message.contentProvider.type を確認します。line なら公式のGet content、external なら通知された元コンテンツのURLを使います。動画や音声の準備中に返る 202 はダウンロード完了ではありません。LINEは保存期間を保証していないため、処理する権限のあるコンテンツは速やかに保存し、メッセージIDを永続的なアーカイブと考えないでください。
要点
- メディアの種類だけでなく、コンテンツの提供元で取得方法を分けます。
- Get contentのドメインは
api-data.line.meであり、通常のapi.line.meとは異なります。 - Webhookの受信、メディアの準備完了、保存完了は別々の状態です。
- プレビューは元ファイルではありません。接続方式を変えても、削除された内容は復元できません。
LINEメディアの取得元を確認する
LINE Messaging APIリファレンスは、画像・動画・音声についてLINE側のコンテンツと外部コンテンツを区別しています。
| 受信した内容 | 取得方法 | 注意点 |
|---|---|---|
contentProvider.type: line の画像・動画・音声 | message.id でGet contentを呼ぶ | Webhook内にあるのはメタデータであり、ファイル本体ではない |
contentProvider.type: external の画像・動画・音声 | contentProvider.originalContentUrl を使う | Get contentでは外部ファイルを取得できない |
| ファイルメッセージ | メッセージIDでGet contentを呼ぶ | ファイルのメタデータを保持し、すべてのメッセージに contentProvider があると仮定しない |
| テキスト | Webhook内のテキストを保存する | 後から同じテキストを再取得するAPIはない |
共通受信箱を実装する際は、最後の2行が重要です。画像用の分岐が要求する contentProvider がないという理由でファイルを拒否したり、テキストのIDをバイナリ取得処理に渡したりしないでください。
LINE側のメディアは、api-data.line.me に対する GET /v2/bot/message/{messageId}/content で取得し、チャネルアクセストークンで認証します。トークンはバックエンドだけで管理します。IDには、そのチャネルに対応する署名検証済みイベントのメッセージIDを使います。ユーザーID、reply token、イベントIDではありません。
メッセージ受信ガイドには、画像と動画のプレビュー取得も記載されています。読み込み中の画面には使えますが、元ファイルを取得・保存できた証拠にはなりません。
再試行の前にレスポンスを切り分ける
Get contentの仕様では、成功時の 200 はバイナリを返し、形式はレスポンスの Content-Type が示します。大きな動画や音声は準備に時間がかかり、途中で取得すると 202 が返る場合があります。
| 観測した状態 | 推奨する対応 |
|---|---|
200 とバイナリを受信 | 管理下のストレージへストリーミング保存し、検査と保存が成功してから完了にする |
動画・音声の取得で 202 | ジョブを保留し、準備状態を確認してから後続の取得を行う |
404 または 410 | メッセージID、チャネル、提供元の分岐、エラー内容を確認する。無限の再試行で復元できるとは考えない |
| 外部URLの取得に失敗 | 外部ホストとURLの有効性を調べる。LINEのコンテンツAPIは代替取得先ではない |
| サムネイルはあるが元ファイルがない | プレビューと元ファイルを別々に管理し、添付全体を保存済みにしない |
準備状態の確認は GET /v2/bot/message/{messageId}/content/transcoding です。APIリファレンスにある、このエンドポイント固有のドメインとレスポンス仕様に従ってください。バイナリ取得用ドメインをすべてのリクエストへ流用しないことが重要です。
ポーリング間隔や試行回数には、アプリケーション側で上限を設けることを推奨します。これは運用設計であり、LINEによる完了時間の保証ではありません。成功系HTTPステータスをすべてファイルとみなし、準備中のレスポンスを画像デコーダーや文字起こしサービスに渡さないでください。
速やかな保存と送信取消への対応を両立する
LINEは一定期間後にコンテンツを自動削除し、保存期間を保証しないと説明しています。IDを保存したことと、将来バイナリを取得できることは別です。
推奨する処理順序は次のとおりです。
- 署名を検証してイベントを永続化し、チャネルとメッセージの対応を保持する。
- 受信記録とともに、再開可能なメディア取得ジョブを作成する。LINEの複数イベント受信ガイドでは、リクエストの一部だけ保存して成功を返してはいけない理由を説明しています。
- 提供元に合った経路で元ファイルを取得し、担当者やAIへ渡す前に容量、タイムアウト、内容を検査する。
- 自社管理の保存先への参照を保持し、会話単位のアクセス権で保護する。ファイル名と申告されたメディア形式を無条件に信用しない。
- 取得できなければ「添付ファイルを利用できません」と明示し、必要に応じて権限を確認したうえで再送を依頼する。
外部URLの取得では、接続先とリダイレクトを検査し、プライベートネットワークへの接続を除外してください。LINEのチャネルアクセストークンを外部ホストへ転送してはいけません。トークンや署名付きURLのクエリ文字列を一般ログに残さないことも推奨します。これらはワーカー側の対策であり、LINEが代わりに実施するという意味ではありません。
保存したコピーには削除処理も必要です。LINEの送信取消に伴うクリーンアップに従い、取得結果を公開する前に削除状態を再確認してください。取消後に完了したダウンロードが、受信箱へ添付を復活させてはいけません。
UnifyPortの添付仕様とは分けて扱う
UnifyPortの非公式インターフェースは、LINEネイティブのメッセージオブジェクトではなく、正規化された message.received イベントを届けます。メディアは data.message.attachments[] に入り、標準イベント仕様が一時的な署名付きOSS URL、添付の種類、メディアのメタデータを定義しています。
正規化されたメッセージIDをLINE Get contentへ渡したり、contentProvider があると仮定したりしないでください。届いた添付URLを保存方針に従って処理し、URLがなければ制約として記録します。推測でURLを組み立てないでください。公開仕様には添付URLの更新エンドポイントや、未受信メッセージの再配信保証はありません。
この独立した受信経路では signing_secret を設定し、Webhook配信仕様に従って生のリクエスト本文のHMAC-SHA256を検証し、受信内容を永続化します。有効な署名は配信元を検証するもので、添付が現在も取得可能であることや安全性までは証明しません。
LINE公式アカウントの識別情報とネイティブなコンテンツ仕様が必要なら、公式Messaging APIを使い続けてください。UnifyPortは取得不能になった公式アカウントの添付を復元するサービスではありません。
FAQ
202はファイル取得成功を意味しますか?
いいえ。動画や音声の準備中には、バイナリなしで 202 が返ることがあります。準備状態を確認し、再試行方針に従って後から取得します。
Get contentでexternalの画像を取得できますか?
できません。contentProvider.type: external では contentProvider.originalContentUrl を、安全な取得制御とともに使います。
LINEは何日間保存しますか?
期間は保証されていません。サポート画面で「何日以内なら必ず復元可能」と約束しないでください。
次のステップと出典
LINE側の画像、外部画像、準備中の動画・音声、取得不能な内容、取得中の送信取消をテストしてください。これは推奨テストであり、実施済みの結果ではありません。正規化イベントの受信は message.received仕様から確認できます。
公式情報の確認日:2026-11-17。
メッセージ連携を安定したプロダクトパイプラインへ。
まずは 1 つの API で送信を始め、標準イベントですべての inbound メッセージを業務システムへ戻しましょう。