Facebook エラー 190:アクセストークンが無効または期限切れ
Facebook エラー 190 は、アクセストークンがもう有効ではないことを示します。Meta のメッセージは「Invalid OAuth 2.0 Access Token」か、「Error validating access token」で始まり、その後に「Session has expired」などの理由が続きます。対処法は新しいトークンを取得することです。Page の場合、通常はその Page に権限を持つ人が再度サインインすることを意味します。サブコードがある場合は、拒否された理由を示します。
easyCoexistence は、接続された各 Page を専用の Page トークンで呼び出し、6 時間ごとに Page を確認します。
Graph API で、アクセストークンの期限切れを示すコード。Meta が推奨する対処は新しいトークンを取得することです。
人がログアウトまたはパスワードを変更したときに送られるサブコード:「The session is invalid because the user logged out.」
ユーザーが Page に適切な権限を持っていない Page トークンのサブコード。
長期 Page アクセストークンには有効期限がなく、特定の条件下でのみ期限切れまたは無効化されます。
Facebook は、アプリのアクセストークンのいずれかが無効になっても、アプリに通知しません。
Facebook Page でエラー 190 は何を意味しますか?
Meta はリクエスト内のアクセストークンをもう受け付けません。Graph API のエラーガイドは 190 を期限切れのアクセストークンとして挙げ、対処法は新しいアクセストークンの取得の一つだけとしています。Page の写真と動画に関する Meta のリファレンスは、このコードを「Invalid OAuth 2.0 Access Token」と説明し、Messenger メッセージの送信に関するガイドは、新しい Page アクセストークンを生成するよう指示しています。
サブコードは何を意味しますか?
エラーにサブコードが付いている場合、Meta の認証サブコード一覧に、トークンが拒否された理由が示されています。また、トークンデバッグガイドには、一部のサブコードに対応するメッセージが載っています:
- 463、Expired:トークンの期限が切れています。メッセージは「Error validating access token: Session has expired on」で、その後に日付が続きます。
- 467、Invalid Access Token:トークンは期限切れ、取り消し済み、またはその他の理由で無効です。
- 460、Password Changed:「Error validating access token: The session is invalid because the user logged out.」本人がログアウトまたはパスワードを変更したため、再度ログインする必要があります。
- 458、App Not Installed:「Error validating access token: User {user-id} has not authorized application {app-id}.」本人は再認証する必要があります。
- 459、User Checkpointed、および 464、Unconfirmed User:本人は facebook.com にログインして、問題を修正する必要があります。
- 492、Invalid Session:Page トークンを使用している本人が、その Page に適切な権限を持っていません。
Facebook Page トークンは期限切れになりますか?
長期ユーザートークンから取得された場合、定期的に期限切れになるわけではありません。Meta の長期トークンガイドによると、このようなユーザートークンは通常約 60 日間有効です。一方、長期 Page アクセストークンには有効期限がなく、特定の条件下でのみ期限切れになるか無効化されます。Meta のトークンデバッグガイドは、セキュリティ関連のイベントにより、トークンが予定の期限より前に無効化されることがあるとも付け加えています。
どのように修正しますか?
新しいトークンを取得してください。Page の場合、新たにサインインすることで取得されます。Meta は Page トークンを、その Page に権限を持つ人にのみ発行します。そのため、接続した人が退職した、または権限を失った場合は、今も Page を管理している人がかわりにサインインしてください。サブコード 459 または 464 の場合は、まず facebook.com にログインして Facebook が求める内容に対応し、その後に再度サインインしてください。
呼び出しが失敗する前に検出するには?
トークンを定期的に確認してください。Facebook はトークンが機能しなくなってもアプリに知らせないため、Page トークンを使った定期的なリクエスト(例:Page の ID と名前の読み取り)によって、投稿や Messenger の返信がそれに依存する前に 190 を検出できます。Meta の debug_token エンドポイントも、トークンが有効かどうか、いつ期限切れになるか、保持している権限を返します。
curl "https://graph.facebook.com/<PAGE_ID>?fields=id,name&access_token=<PAGE_ACCESS_TOKEN>"
# Valid: the Page comes back
{"id": "<PAGE_ID>", "name": "<PAGE_NAME>"}
# Rejected: code 190, with a subcode when Meta gives one
{"error": {"type": "OAuthException", "code": 190, "error_subcode": 460, "message": "..."}}よくある間違い
- リクエストを再試行すること。拒否されたトークンは拒否されたままで、新しいサインインによる新しいトークンだけがエラーを解消します。
- Page トークンは永久に有効だと思い込むこと。有効期限はありませんが、Meta は特定の条件下でトークンを依然として無効化するため、エラー 190 はその表れです。
- 権限を持たないアカウントで Page を再接続すること。Meta は Page トークンを、その Page に権限を持つ人にのみ発行します。
- 自分で保存した Page トークンのコピーを保持し続けること。再サインイン後も保存されたコピーは拒否されたままなので、代わりに現在のトークンを取得してください。
チェック中または他の呼び出し中に Meta が 190 を返すと、その接続はすぐに再接続が必要な状態としてマークされ、メールが届き、ツールは AI に Page の再接続が必要であることを伝えます。ダッシュボードからサインインすると、同じ接続が新しいトークンで戻ります。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
「Error validating access token」は何を意味しますか?
Meta のエラー 190 のメッセージの始まりです。リクエスト内のトークンはもう有効ではないことを示します。残りのメッセージには、セッションの期限切れやログアウトなどの理由が書かれています。
Facebook のパスワードを変更すると、Page トークンは無効になりますか?
はい。ログアウトまたはパスワードの変更により無効になり、サブコード 460 が付きます。Page に権限を持つ人が再度サインインする必要があります。
サブコード 492 は何を意味しますか?
Page トークンを生成したサインインを行った人が、その Page に適切な権限を持っていません。Page を管理している人が再接続する必要があります。
エラー 190 の後に Page トークンを更新できますか?
いいえ。Meta の対処法は、新しいアクセストークンを取得することです。Page の場合、その Page に権限を持つ人が再度サインインすることで取得されます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日