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