chrome.instanceID

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

ใช้ chrome.instanceID เพื่อเข้าถึงบริการรหัสอินสแตนซ์

สิทธิ์

gcm

ความพร้อมใช้งาน

Chrome 44 ขึ้นไป

เมธอด

deleteID()

Promise

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

รีเซ็ตตัวระบุอินสแตนซ์ของแอปและเพิกถอนโทเค็นทั้งหมดที่เชื่อมโยงกับตัวระบุดังกล่าว

พารามิเตอร์

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

การคืนสินค้า

• Promise<void>

  Chrome 96 ขึ้นไป

  ระบบจะแก้ไขเมื่อการลบเสร็จสมบูรณ์ ระบบจะเพิกถอนตัวระบุอินสแตนซ์เรียบร้อยแล้วหาก Promise ไม่ปฏิเสธ

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

deleteToken()

Promise

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

เพิกถอนโทเค็นที่ให้สิทธิ์

พารามิเตอร์

• deleteTokenParams

  ออบเจ็กต์

  พารามิเตอร์สำหรับ deleteToken

  • authorizedEntity

    สตริง

    Chrome 46 ขึ้นไป

    หน่วยงานที่ได้รับอนุญาตซึ่งใช้เพื่อรับโทเค็น

  • ขอบเขต

    สตริง

    Chrome 46 ขึ้นไป

    ขอบเขตที่ใช้เพื่อรับโทเค็น

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

การคืนสินค้า

• Promise<void>

  Chrome 96 ขึ้นไป

  แก้ไขเมื่อการลบโทเค็นเสร็จสมบูรณ์ ระบบจะเพิกถอนโทเค็นเรียบร้อยแล้วหาก Promise ไม่ปฏิเสธ

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

getCreationTime()

Promise

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

ดึงข้อมูลเวลาที่สร้าง InstanceID callback จะแสดงเวลาที่สร้าง

พารามิเตอร์

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (creationTime: number) => void

  • creationTime

    ตัวเลข

    เวลาที่สร้างรหัสอินสแตนซ์ โดยแสดงเป็นมิลลิวินาทีนับตั้งแต่ Epoch

การคืนสินค้า

• Promise<number>

  Chrome 96 ขึ้นไป

  แก้ไขเมื่อการดึงข้อมูลเสร็จสมบูรณ์

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

getID()

Promise

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

ดึงข้อมูลตัวระบุสำหรับอินสแตนซ์ของแอป callback จะแสดงรหัสอินสแตนซ์ ระบบจะแสดงรหัสเดิมตราบใดที่ข้อมูลประจำตัวของแอปพลิเคชันยังไม่ถูกเพิกถอนหรือหมดอายุ

พารามิเตอร์

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (instanceID: string) => void

  • instanceID

    สตริง

    รหัสอินสแตนซ์ที่กำหนดให้กับอินสแตนซ์ของแอป

การคืนสินค้า

• Promise<string>

  Chrome 96 ขึ้นไป

  แก้ไขเมื่อการดึงข้อมูลเสร็จสมบูรณ์

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

getToken()

Promise

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

แสดงผลโทเค็นที่อนุญาตให้หน่วยงานที่ได้รับอนุญาตเข้าถึงบริการที่กำหนดโดยขอบเขต

พารามิเตอร์

• getTokenParams

  ออบเจ็กต์

  พารามิเตอร์สำหรับ getToken

  • authorizedEntity

    สตริง

    Chrome 46 ขึ้นไป

    ระบุเอนทิตีที่ได้รับอนุญาตให้เข้าถึงทรัพยากรที่เชื่อมโยงกับรหัสอินสแตนซ์นี้ ซึ่งอาจเป็นรหัสโปรเจ็กต์จากGoogle Developers

  • ตัวเลือก

    object ไม่บังคับ

    Chrome 46 ขึ้นไป เลิกใช้งานตั้งแต่ Chrome 89

    ตัวเลือกเลิกใช้งานแล้วและระบบจะไม่สนใจ

    อนุญาตให้รวมคู่คีย์/ค่าสตริงจำนวนเล็กน้อยที่จะเชื่อมโยงกับโทเค็นและอาจใช้ในการประมวลผลคำขอ

  • ขอบเขต

    สตริง

    Chrome 46 ขึ้นไป

    ระบุการดำเนินการที่ได้รับอนุญาตซึ่งหน่วยงานที่ได้รับอนุญาตสามารถทำได้ เช่น สำหรับการส่งข้อความ GCM ควรใช้ขอบเขต GCM

• callback

  function ไม่บังคับ

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (token: string) => void

  • โทเค็น

    สตริง

    โทเค็นที่กำหนดโดยบริการที่ขอ

การคืนสินค้า

• Promise<string>

  Chrome 96 ขึ้นไป

  แก้ไขเมื่อการดึงข้อมูลเสร็จสมบูรณ์

  ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

กิจกรรม

onTokenRefresh

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

เริ่มทำงานเมื่อต้องรีเฟรชโทเค็นที่ได้รับทั้งหมด

พารามิเตอร์

• callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void