chrome.instanceID

Mô tả

Sử dụng chrome.instanceID để truy cập vào dịch vụ mã phiên bản.

Quyền

gcm

Phạm vi cung cấp

Chrome 44 trở lên

Phương thức

deleteID()

Lời hứa 
chrome.instanceID.deleteID(
  callback?: function,
)

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

Tham số

  • số gọi lại

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

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

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 96 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

deleteToken()

Lời hứa 
chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
)

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

Tham số

  • deleteTokenParams

    đối tượng

    Các thông số cho deleteToken.

    • authorizedEntity

      string

      Chrome 46 trở lên

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

    • phạm vi

      string

      Chrome 46 trở lên

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

  • số gọi lại

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

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

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 96 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

getCreationTime()

Lời hứa 
chrome.instanceID.getCreationTime(
  callback?: function,
)

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

Tham số

  • số gọi lại

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

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

    (creationTime: number) => void

    • creationTime

      số

      Thời điểm mã phiên bản được tạo, đượ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&lt;number&gt;

    Chrome 96 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

getID()

Lời hứa 
chrome.instanceID.getID(
  callback?: function,
)

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

Tham số

  • số gọi lại

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

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

    (instanceID: string) => void

    • instanceID

      string

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

Giá trị trả về

  • Cam kết<string>

    Chrome 96 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

getToken()

Lời hứa 
chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
)

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

Tham số

  • getTokenParams

    đối tượng

    Các thông số cho getToken.

    • authorizedEntity

      string

      Chrome 46 trở lên

      Xác định thực thể được phép truy cập vào các tài nguyên liên kết với mã thực thể này. Đó có thể là mã dự án trong Google Developer Console.

    • tùy chọn

      đối tượng không bắt buộc

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

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

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

    • phạm vi

      string

      Chrome 46 trở lên

      Xác định những thao tác được uỷ quyền mà pháp nhân được uỷ quyền có thể thực hiện. Ví dụ: để gửi tin nhắn GCM, bạn nên dùng GCM phạm vi.

  • số gọi lại

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

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

    (token: string) => void

    • mã thông báo

      string

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

Giá trị trả về

  • Cam kết<string>

    Chrome 96 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

Sự kiện

onTokenRefresh

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

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

Tham số

  • số gọi lại

    hàm

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

    () => void