The Instance ID API is deprecated. If you need to access unique app installation identifiers, use the
Firebase installations API. See also
Firebase installations and Instance ID. The Instance ID server-side API will be turned down on September 29, 2027. Please refer to the
FAQ page for migration guidance. New projects will not be able to onboard the Instance ID server-side API after October 1, 2026.
Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。
Instance ID API
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
借助 Instance ID API,您可以将 Instance ID 与 Android 或 iOS 应用集成。Instance ID
为应用的每个实例提供一个唯一标识符,并提供一种对操作进行身份验证和授权的机制。InstanceID 的有效期很长,但可能会因以下原因而过期:
- 设备恢复出厂设置。
- 用户卸载应用。
- 用户在应用中执行“清除数据”操作。
- 设备长时间未使用(时间范围由设备和地区决定)。
- Instance ID 服务检测到滥用或错误,并重置
InstanceID。
- 如果客户端应用需要该功能,则使用服务器端代码。
Instance ID 服务会通过
回调 InstanceIDListenerService 向您的应用通知 InstanceID 重置。如果您的应用收到此通知,则必须调用 getToken() 并检索新的 InstanceID,然后更新其服务器。
使用 getToken 方法证明 InstanceID 的所有权,并允许服务器访问与应用关联的数据或服务。该方法遵循 OAuth2
模式,并且需要 authorizedEntity 和 scope。authorizedEntity 可以是项目 ID 或另一个
InstanceID,它决定了哪些服务有权使用生成的令牌。scope 决定了令牌允许访问的特定服务或数据。
详细了解适用于以下平台的 Instance ID API:
Android
iOS
服务器
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2026-09-12。
[null,null,["最后更新时间 (UTC):2026-09-12。"],[],[]]