说明
使用 chrome.instanceID
访问实例 ID 服务。
权限
gcm
可用性
方法
deleteID()
chrome.instanceID.deleteID(
callback?: function,
)
重置应用实例标识符并撤消与其关联的所有令牌。
参数
-
callback
函数(可选)
callback
参数如下所示:() => void
返回
-
承诺<void>
Chrome 96 及更高版本只有 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
deleteToken()
chrome.instanceID.deleteToken(
deleteTokenParams: object,
callback?: function,
)
撤消已授予的令牌。
参数
-
deleteTokenParams
对象
deleteToken 的参数。
-
authorizedEntity
字符串
Chrome 46 及更高版本用于获取令牌的授权实体。
-
范围
字符串
Chrome 46 及更高版本用于获取令牌的范围。
-
-
callback
函数(可选)
callback
参数如下所示:() => void
返回
-
承诺<void>
Chrome 96 及更高版本只有 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
getCreationTime()
chrome.instanceID.getCreationTime(
callback?: function,
)
检索 InstanceID 的生成时间。创建时间将由 callback
返回。
参数
-
callback
函数(可选)
callback
参数如下所示:(creationTime: number) => void
-
creationTime
number
实例 ID 的生成时间,以从公元纪年开始计算的毫秒数表示。
-
返回
-
Promise<number>
Chrome 96 及更高版本只有 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
getID()
chrome.instanceID.getID(
callback?: function,
)
检索应用实例的标识符。callback
将返回实例 ID。只要应用身份没有被撤消或过期,系统就会返回相同的 ID。
参数
-
callback
函数(可选)
callback
参数如下所示:(instanceID: string) => void
-
instanceID
字符串
分配给应用实例的实例 ID。
-
返回
-
承诺<字符串>
Chrome 96 及更高版本只有 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
getToken()
chrome.instanceID.getToken(
getTokenParams: object,
callback?: function,
)
返回一个令牌,该令牌允许授权实体访问按范围定义的服务。
参数
-
getTokenParams
对象
getToken 的参数。
-
authorizedEntity
字符串
Chrome 46 及更高版本标识有权访问与此实例 ID 关联的资源的实体。它可以是 Google 开发者控制台中的项目 ID。
-
选项
对象(可选)
Chrome 46 及更高版本 自 Chrome 89 起弃用选项已被弃用,将被忽略。
允许包含将与令牌关联且可用于处理请求的少量字符串键值对。
-
范围
字符串
Chrome 46 及更高版本用于标识已获授权实体可执行的授权操作。例如:若要发送 GCM 消息,应使用
GCM
范围。
-
-
callback
函数(可选)
callback
参数如下所示:(token: string) => void
-
token
字符串
由请求的服务分配的令牌。
-
返回
-
承诺<字符串>
Chrome 96 及更高版本只有 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
事件
onTokenRefresh
chrome.instanceID.onTokenRefresh.addListener(
callback: function,
)
在授予的所有令牌都需要刷新时触发。
参数
-
callback
函数
callback
参数如下所示:() => void