Telegram Session+Json とは何ですか?またその使用方法は?完全なガイド
"Telegram セッションファイル (.session) は、認証キー、サーバーアドレス、ユーザーデータを含む認証情報を保存する SQLite データベースです。app_id、app_hash、電話番号を含む JSON メタデータファイルと組み合わせることで、MTProto を介した完全な API アクセスが可能になります。" — Telegram API ドキュメントリファレンス。
毎時間500の Telegram グループをチェックする必要があるパーサーを作成したとします。または、SaaS 製品の通知ボットを構築しているとします。あなたと動作するコードの間に立ちはだかる唯一のものは、.session ファイルです。
Telethon や Pyrogram のような Python ライブラリは、.session ファイルを通じてのみ認証を行います。このガイドでは、Session+Json とは何か、スクリプトでの読み込み方法、アカウントが禁止される原因(とその回避方法)を説明します。
Telegram Session+Json とは何ですか?
Session+Json は、MTProto API を介して Telegram アカウントを認証するために必要なすべてを保存する2ファイル形式です。Tdata(Telegram Desktop で動作)とは異なり、Session+Json はコードベースの自動化向けに設計されています。
- .session ファイル — 認証キー、サーバーソルト、接続状態を保持する SQLite データベース。Telethon と Pyrogram はこのファイルを読み取り、ログインコードなしで中断したところから続行します。
- .json メタデータファイル —
app_id、app_hash、電話番号、およびオプションの 2FA パスワードを含むプレーンテキスト JSON。MTProto クライアントを初期化するにはこれらの値が必要です。
自動化において Session+Json が Tdata より優れている理由
Session+Json アカウントは GUI レベルではなく、API レベルで動作します。Session+Json アカウントを持つ Telethon スクリプトは、数行の Python でメッセージの送信、グループへの参加、メンバーの収集、チャンネルの管理ができます。デスクトップクライアントや GUI 自動化は必要ありません。スクリーンスクレイピングも不要です。追加のデスクトップを起動することなく、単一の VPS で何百ものセッションを実行できます。
形式を比較している場合は、デスクトップアプローチに関する Tdata ガイドをご覧ください。
Telegram Session+Json アカウントの使用方法(ステップバイステップ)
- Telethon または Pyrogram をインストールします。 Python 環境で
pip install telethonまたはpip install pyrogram tgcryptoを実行します。 - ファイルを配置します。
.sessionファイルと.jsonファイルをスクリプトの隣のプロジェクトディレクトリに置きます。 - コードでセッションを読み込みます。 クライアントを作成するときにセッションファイル名(拡張子なし)を使用します。JSON メタデータが API 認証情報を提供します。
# Telethon example from telethon import TelegramClient import json with open('account.json') as f: meta = json.load(f) client = TelegramClient('account', meta['app_id'], meta['app_hash']) client.start(phone=meta['phone']) # Session is active. You can call any API method now. - スクリプトを実行します。 Telethon と Pyrogram は起動時に既存の
.sessionファイルを読み取ります。QR コードや SMS は必要ありません。
Session+Json vs Tdata:どちらの形式を選ぶべき?
| 要素 | Session+Json | Tdata |
|---|---|---|
| 最適な用途 | Python スクリプト、API 自動化、チャットボット | デスクトップ GUI、Telegram Portable |
| プロトコル | MTProto API(直接 Telegram プロトコル) | ローカルデスクトップキャッシュ(間接) |
| 同時セッション | 無制限(1つの VPS で数千実行可能) | デスクトップリソースによって制限 |
| API アクセス | 完全な MTProto API(メッセージ、チャンネル、連絡先) | Telegram Desktop が公開するもののみ |
| セットアップ時間 | 30秒(pip install + ファイル配置) | 2分(Portable ダウンロード + フォルダ設定) |
一般的な Session+Json の問題のトラブルシューティング
- セッションが取り消されました(エラー401)。 アカウントがリモートでログアウトされました。Telegram は動きが速すぎるアカウントにフラグを立てます。再試行する前にアカウントを24時間休ませてください。
- フラッド待機エラー。 API レート制限に達しています。アクション間にランダムな遅延(5〜15秒)を追加し、同じメッセージを複数のチャットに連続して送信しないようにしてください。
- 電話番号が無効です。 .json ファイルの電話番号がセッションと一致しません。メタデータがセッションファイルと同じアカウントからのものであることを確認してください。
Session+Json アカウントの禁止防止ルール
Session+Json アカウントは生の Telegram API を使用するため、Telegram の不正使用検出に対してより可視性が高くなります。以下のルールはアカウントをより長くアクティブに保つのに役立ちます:
| ルール | 説明 | 推奨 |
|---|---|---|
| プロキシの一致 | プロキシの GEO がアカウントの登録国と一致する必要があります。 | モバイル SOCKS5 プロキシが最も効果的です。 |
| セッションファイル | .session ファイルはそのままにしてください。編集や再生成は認証を破壊します。 | バックアップは安全なディレクトリに保存してください。 |
| レート制限 | Telegram のメソッドごとのレート制限内に収めてください。 | アカウントあたり毎秒30メッセージ未満を維持してください。 |
| ウォームアップ | 新しいセッションで自動化を実行しないでください。 | 最初のログイン後12〜24時間待ってください。 |
| 2FA | 二要素認証パスワードは購入後もアカウントを安全に保ちます。 | .json メタデータファイルに追加してください。 |
Telegram Session+Json アカウントの購入先
accs.tg では、米国、英国、ウクライナ、ロシアなどの国向けの Session+Json アカウントを提供しています。各注文には .session ファイルと、app_id および app_hash を含む .json メタデータが含まれます。配信は5秒未満です。アカウントは実際のモバイルデバイスを通じてクリーンな IP プールで登録され、高い信頼レベルを維持します。
各アカウントには、数分で自動化を開始するために必要なすべてが揃っています。
完全なカタログは accs.tg/services でご覧いただくか、大量注文には API をご利用ください。デスクトップ形式をご希望の場合は、Tdata ガイドをお読みください。