chrome.instanceID

refresh date: 2026-09-25 robots: noindex

說明

使用 chrome.instanceID 存取 Instance ID 服務。

權限

gcm

可用性

Chrome 44 以上版本

方法

deleteID()

Promise 
chrome.instanceID.deleteID(
  callback?: function,
): Promise<void>

重設應用程式執行個體 ID，並撤銷與其相關聯的所有權杖。

參數

  • callback

    函式 選填

    callback 參數如下： 

    () => void

傳回

  • 承諾<void>

    Chrome 96 以上版本

    刪除完成後，系統會解析。如果 Promise 未拒絕，表示執行個體 ID 已成功撤銷。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

deleteToken()

Promise 
chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
): Promise<void>

撤銷已授予的權杖。

參數

  • deleteTokenParams

    物件

    deleteToken 的參數。

    • authorizedEntity

      字串

      Chrome 46 以上版本

      用於取得權杖的獲得授權的實體。

    • 範圍

      字串

      Chrome 46 以上版本

      用於取得權杖的範圍。

  • callback

    函式 選填

    callback 參數如下： 

    () => void

傳回

  • 承諾<void>

    Chrome 96 以上版本

    權杖刪除完成後，系統會解析。如果 Promise 未拒絕，表示權杖已成功撤銷。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getCreationTime()

Promise 
chrome.instanceID.getCreationTime(
  callback?: function,
): Promise<number>

擷取 InstanceID 的產生時間。callback 會傳回建立時間。

參數

  • callback

    函式 選填

    callback 參數如下： 

    (creationTime: number) => void

    • creationTime

      數字

      執行個體 ID 的產生時間，以從 Epoch 紀元時間算起的毫秒數表示。

傳回

  • Promise<number>

    Chrome 96 以上版本

    擷取完成後，系統會解析。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getID()

Promise 
chrome.instanceID.getID(
  callback?: function,
): Promise<string>

擷取應用程式執行個體的 ID。callback 會傳回執行個體 ID。只要應用程式身分未撤銷或過期，系統就會傳回相同的 ID。

參數

  • callback

    函式 選填

    callback 參數如下： 

    (instanceID: string) => void

    • instanceID

      字串

      指派給應用程式執行個體的執行個體 ID。

傳回

  • Promise<string>

    Chrome 96 以上版本

    擷取完成後，系統會解析。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getToken()

Promise 
chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
): Promise<string>

傳回權杖，允許獲得授權的實體存取範圍定義的服務。

參數

  • getTokenParams

    物件

    getToken 的參數。

    • authorizedEntity

      字串

      Chrome 46 以上版本

      識別有權存取與這個執行個體 ID 相關聯資源的實體。可以是 Google 開發人員控制台中的專案 ID。

    • 選項

      物件 選填

      Chrome 46 以上版本 自 Chrome 89 起淘汰

      選項已淘汰，系統會忽略。

      允許加入少量與權杖相關聯的字串鍵/值組合，可用於處理要求。

    • 範圍

      字串

      Chrome 46 以上版本

      識別獲得授權的實體可採取的授權動作。例如，如要傳送 GCM 訊息，應使用 GCM 範圍。

  • callback

    函式 選填

    callback 參數如下： 

    (token: string) => void

    • token

      字串

      由所要求服務指派的權杖。

傳回

  • Promise<string>

    Chrome 96 以上版本

    擷取完成後，系統會解析。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

事件

onTokenRefresh

chrome.instanceID.onTokenRefresh.addListener(
  callback: function,
)

當所有已授予的權杖都需要重新整理時，系統會觸發這個事件。

參數

  • callback

    函式

    callback 參數如下： 

    () => void