2023年前半に、LIFFアプリに対するトークルームの内部識別子(1対1トークID、グループID、トークルームID)の提供廃止を予定しています。
LIFFアプリの機能について見直しを行った結果、LIFFアプリに対するトークルームの内部識別子の提供を廃止する判断となりました。この仕様変更は、LIFFのバージョニングポリシーとは関係なく、すべてのLIFF SDKに適用されます。LINEミニアプリはLIFFで提供される仕組みを利用しているため、LINEミニアプリについても同様です。
# 提供廃止の影響
LIFFアプリに対するトークルームの内部識別子の提供廃止による影響は、以下のとおりです。
# 影響1. liff.getContext()の戻り値
liff.getContext()
は、LIFFアプリが起動された画面(1対1のトーク、グループトーク、複数人トーク、または外部ブラウザ)に関する情報を取得するためのメソッドです。
仕様変更後は、このliff.getContext()
の戻り値に、以下の内部識別子を返すプロパティが含まれなくなります。
- 1対1トークID(
utouId
) - グループID(
groupId
) - トークルームID(
roomId
)
詳しくは、『LIFF APIリファレンス』の「liff.getContext()
」を参照してください。
# 影響2. LINEログインでアクセストークンを発行、更新、検証するAPIの戻り値
LIFFアプリの動作に必要なスコープとして、chat_message.write
を選択していた場合、以下のエンドポイントでレスポンスのスコープ(scope
)に1対1トークID(utouId
)が含まれていました。
仕様変更後は、このレスポンスのスコープに、1対1トークID(utouId
)が含まれなくなります。
変更前(現在) | 変更後 |
---|---|
chat_message.write:UU29e6eb36812f484... | chat_message.write |
詳しくは、『LINEログイン v2.1 APIリファレンス』の「アクセストークンを発行する」、「アクセストークンを更新する」、「アクセストークンの有効性を検証する」を参照してください。
# 代替方法
現在、「提供廃止の影響」で示した内部識別子に依存したLIFFアプリを提供している場合、以下のような代替方法を検討してください。
# トークルームの内部識別子の代わりに独自に発行したIDを使用する
ユーザーがアクセスするLIFF URL(https://liff.line.me/{liffId}
)に対して、トークルームごとにサービスが独自に発行したIDを付与することで、サービス側からトークルームの判別を行うようにしてください。
例:https://liff.line.me/{liffId}/?talk_id={サービスが独自に発行したID}
現在の実装例 | 代替方法 |
---|---|
|
|
なおLIFF URLの扱いについては、「LIFFアプリ開発ガイドライン」に従ってください。
詳しくは、『LIFFドキュメント』の「2次リダイレクト先URLを作成する」を参照してください。
# Webhookイベントに含まれるグループIDやトークルームIDを使用する
LIFFアプリのliff.getContext()
で戻り値からグループIDやトークルームIDを取得していた場合は、Messaging APIのWebhookイベントから取得する形での代替が可能です。
現在の実装例 | 代替方法 |
---|---|
|
|
詳しくは、『Messaging APIドキュメント』の「1対1のトークまたはグループトークや複数人トークでのWebhookイベント」および『Messaging APIリファレンス』の「Webhookイベントオブジェクト」を参照してください。
# 仕様変更予定日
2023年前半
なお、この仕様変更の内容および日時は、予告なく変更される可能性があります。仕様変更の日時は決まり次第、追ってお知らせします。
LINEは今後もお客様への一層のサービス向上に取り組んでまいります。何卒ご理解を賜りますよう、よろしくお願い申し上げます。