LINE用户
在 LINE 平台中,开发者可以通过多种方式获取用户的个人资料信息。这些信息包括用户的基本资料(如昵称、头像、状态消息)、扩展资料(如性别、生日、邮箱、地址、电话号码等),具体可获取的信息类型取决于使用的接口方式以及是否具备相应的权限或服务授权。
什么是用户个人资料
用户可以在 LINE 应用中通过「设定 > 个人资料」设置自己的基本信息,如名称、头像等。此外,LINE 还提供了更丰富的资料类型以供企业和服务方调用:
在构建基于 LINE 平台的服务时,获取用户的基本资料信息是至关重要的一环。LINE 提供了多种方式来访问用户资料,包括 Messaging API、LINE Login、LIFF(LINE Front-end Framework)以及 LINE MINI App 等。不同的方式能够获取的用户信息种类不同,有些信息需要额外申请权限或签署合同才能访问,例如邮箱地址、电话号码或邮寄地址。接下来我们将系统地介绍 LINE 用户资料信息的种类、设置方式、获取方法及注意事项,帮助开发者清晰了解如何在合法合规的前提下获取并使用这些信息,以优化产品体验和服务流程。
- Common Profile(通用资料):用户可通过 LINE 或 Yahoo! JAPAN 注册的资料创建通用资料,可在 Account Center 设置。
- LINE Profile+:除常规信息外,用户还可填写如性别、生日、手机号、邮箱、地址等资料。
这些资料帮助用户在使用 LINE 相关服务时自动填写信息,提升用户体验,避免重复输入。一、什么是用户资料信息
获取用户资料的方式
LINE 平台提供以下七种方式来获取用户的个人资料:用户资料信息是指用户在使用 LINE 应用时所设置或提供的基本身份信息。用户可在 LINE App 中通过“设置 > 个人资料”来编辑姓名、头像、状态信息等基本内容。
- Messaging API:Get profile 端点
- LINE Login:Get user information 端点
- LINE Login:Get user profile 端点
- LINE Login:从 ID token 的 payload 获取
- LIFF:使用
liff.getProfile()
方法 - LIFF:使用
liff.getDecodedIDToken()
方法获取 payload - LINE MINI App:通过 Quick-fill 功能获取 Common Profile
前六种方法可获取 LINE 个人资料与 LINE Profile+ 信息;第七种方法可用于获取 Common Profile 信息。1. Common Profile
Common Profile(通用资料)是用户在 LINE 或 Yahoo! JAPAN 注册的信息基础上合成的统一资料档案。用户可以在“帐户中心”中管理自己的通用资料。
各方法支持的信息类型
以下是每种方法可获取的资料类型对照表:此资料类型主要用于 LINE MINI App 的 Quick-fill 自动填充功能,可在用户使用外部服务时快速填写姓名、地址等内容,从而简化流程。
信息类型 | 方法1 | 方法2 | 方法3 | 方法4 | 方法5 | 方法6 | 方法7 |
---|---|---|---|---|---|---|---|
用户 ID | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
显示名称 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
头像 URL | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
状态消息 | ✅ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
语言 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
邮箱地址 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
姓名 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
性别 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
生日 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
地址 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
电话号码 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
⚠️ 注意事项:
- 要通过方法 4 和 6 获取邮箱,需用户授权访问。
- 若要访问 LINE Profile+ 中的详细信息(如性别、地址、电话等),企业必须申请加入 LINE Profile+ 企业服务。
- 若要使用 Quick-fill 功能(方法7),也需提交申请,该功能适用于希望简化用户资料填写流程的企业用户。
企业开发建议
对于希望整合用户资料的服务,建议:
- 使用 LINE Login 实现精准认证和获取用户资料;
- 若需扩展资料,优先引导用户授权并申请 LINE Profile+ 服务;
- 使用 LIFF 或 LINE MINI App 可实现更丰富的交互体验。
更多详细开发说明可参考:
获取用户资料的主要方式
开发者可以通过以下七种方式获取用户资料信息。每种方式能获取的信息种类、场景适用性有所不同:
方法一:Messaging API 的 Get profile 接口
用于通过用户发送的消息中提取基本资料,如用户 ID、显示名称、头像、状态信息和语言。
方法二 & 三:LINE Login 的 Get user information / Get user profile 接口
在用户完成 LINE 登录认证后,通过这些端点可获取类似 Messaging API 提供的基本资料。
方法四 & 六:ID Token / liff.getDecodedIDToken()
当用户通过 LINE Login 或 LIFF 完成授权登录后,开发者可以从 ID Token 中解析用户资料。若申请了相关权限,还可获取邮箱、姓名、性别、生日、电话等更敏感信息。
方法五:LIFF 的 liff.getProfile()
LIFF 应用中最常用的方式之一,可获取显示名称、头像、状态信息和用户 ID。
方法七:Quick-fill(LINE MINI App 专属)
可从 Common Profile 获取用户姓名、地址等信息。该方式适用于需要简化表单填写流程的服务场景,需额外申请 Quick-fill 功能许可。
LINE用户 可获取的信息种类明细
不同方式获取的用户资料信息范围如下表所示:
信息类型 | 方法1 | 方法2 | 方法3 | 方法4 | 方法5 | 方法6 | 方法7 |
---|---|---|---|---|---|---|---|
用户ID | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
显示名称 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
头像 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
状态信息 | ✅ | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
语言 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
邮箱地址 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
姓名 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
性别 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
生日 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
地址 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
电话号码 | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ✅ |
⚠️ 注意:使用方法 4、6 获取敏感信息(如邮箱、地址等)需先获得用户授权,并在 LINE Developers 控台中配置相应 scope。方法 7 需额外申请 Quick-fill 使用许可。
LINE用户 :申请权限与注意事项
为了保护用户隐私,LINE 平台对某些信息的访问有明确限制:
- 邮箱、姓名、电话、生日等信息:必须通过 LINE Login 的 scope 授权请求,并明确告知用户。
- LINE Profile+ 和 Quick-fill:需作为企业账号申请相关功能开通,提交审核资料,并遵守数据使用政策。
- ID Token 解码:必须验证签名并根据 OpenID Connect 标准解析,避免安全隐患。
详细的授权机制说明与使用范例,请参考 LINE Login 文档 与 LINE Profile+ 企业用户说明。
适用场景与实践建议
以下是不同资料获取方式的典型使用场景建议:
- 用户展示昵称与头像:推荐使用 Messaging API 或 LIFF 的
liff.getProfile()
。 - 用户注册/填写表单时快速获取基本资料:推荐使用 LINE Login 并结合 LINE Profile+。
- 电商平台或订阅服务需要收集地址信息:申请 Quick-fill,结合 MINI App 使用。
- 企业 CRM 系统对接:使用 ID Token 提取用户信息,并结合 OAuth 安全机制。
构建高质量用户体验
LINE 平台为开发者提供了多种方式获取用户资料信息,从基本的昵称头像到完整的用户档案(如地址、电话),覆盖不同场景的需求。然而,出于隐私保护的考虑,大多数敏感资料需要通过用户授权和企业申请方可获取。
理解各获取方式的功能边界、权限要求及场景匹配,是构建高质量用户体验的前提。建议开发者在产品设计初期就规划好所需资料类型,提前完成授权和功能申请流程,以便顺利推进后续开发和服务上线。