chrome.instanceID

refresh date: 2026-09-25 robots: noindex

Mô tả

Sử dụng chrome.instanceID để truy cập vào dịch vụ Mã nhận dạng thực thể.

Quyền

gcm

Phạm vi cung cấp

Chrome 44 trở lên

Phương thức

deleteID()

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

Đặt lại giá trị nhận dạng thực thể ứng dụng và thu hồi tất cả mã thông báo liên kết với giá trị nhận dạng đó.

Thông số

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 96 trở lên

    Giải quyết khi quá trình xoá hoàn tất. Giá trị nhận dạng thực thể đã được thu hồi thành công nếu lời hứa không từ chối.

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

deleteToken()

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

Thu hồi mã thông báo đã cấp.

Thông số

  • deleteTokenParams

    đối tượng

    Tham số cho deleteToken.

    • authorizedEntity

      chuỗi

      Chrome 46 trở lên

      Pháp nhân được uỷ quyền dùng để lấy mã thông báo.

    • phạm vi

      chuỗi

      Chrome 46 trở lên

      Phạm vi được dùng để lấy mã thông báo.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 96 trở lên

    Giải quyết khi quá trình xoá mã thông báo hoàn tất. Mã thông báo đã được thu hồi thành công nếu lời hứa không từ chối.

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getCreationTime()

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

Truy xuất thời điểm tạo InstanceID. Thời gian tạo sẽ được callback trả về.

Thông số

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (creationTime: number) => void

    • creationTime

      số

      Thời điểm tạo Mã phiên bản, được biểu thị bằng mili giây kể từ thời gian bắt đầu của hệ thống.

Giá trị trả về

  • Promise<number>

    Chrome 96 trở lên

    Giải quyết khi quá trình truy xuất hoàn tất.

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getID()

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

Truy xuất giá trị nhận dạng cho phiên bản ứng dụng. callback sẽ trả về mã nhận dạng thực thể. Hệ thống sẽ trả về cùng một mã nhận dạng miễn là danh tính của ứng dụng chưa bị thu hồi hoặc hết hạn.

Thông số

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (instanceID: string) => void

    • instanceID

      chuỗi

      Mã nhận dạng phiên bản được chỉ định cho phiên bản ứng dụng.

Giá trị trả về

  • <string> hứa hẹn

    Chrome 96 trở lên

    Giải quyết khi quá trình truy xuất hoàn tất.

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getToken()

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

Trả về một mã thông báo cho phép pháp nhân được uỷ quyền truy cập vào dịch vụ được xác định theo phạm vi.

Thông số

  • getTokenParams

    đối tượng

    Tham số cho getToken.

    • authorizedEntity

      chuỗi

      Chrome 46 trở lên

      Xác định thực thể được uỷ quyền truy cập vào các tài nguyên liên kết với Mã phiên bản này. Đây có thể là mã dự án trong Google Developer Console.

    • tùy chọn

      object không bắt buộc

      Chrome 46 trở lên Không dùng nữa kể từ Chrome 89

      không còn được dùng nữa và sẽ bị bỏ qua.

      Cho phép thêm một số ít cặp khoá/giá trị chuỗi sẽ được liên kết với mã thông báo và có thể được dùng trong quá trình xử lý yêu cầu.

    • phạm vi

      chuỗi

      Chrome 46 trở lên

      Xác định các hành động được uỷ quyền mà pháp nhân được uỷ quyền có thể thực hiện. Ví dụ: để gửi thông báo GCM, bạn nên sử dụng phạm vi GCM.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (token: string) => void

    • mã thông báo

      chuỗi

      Mã thông báo do dịch vụ được yêu cầu chỉ định.

Giá trị trả về

  • <string> hứa hẹn

    Chrome 96 trở lên

    Giải quyết khi quá trình truy xuất hoàn tất.

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onTokenRefresh

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

Được kích hoạt khi tất cả mã thông báo đã cấp cần được làm mới.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    () => void