chrome.instanceID

คำอธิบาย

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

สิทธิ์

gcm

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

Chrome 44 ขึ้นไป

เมธอด

deleteID()

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

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

พารามิเตอร์

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

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

deleteToken()

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

เพิกถอนโทเค็นที่ได้รับ

พารามิเตอร์

  • deleteTokenParams

    ออบเจ็กต์

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

    • authorizedEntity

      สตริง

      Chrome 46 ขึ้นไป

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

    • ขอบเขต

      สตริง

      Chrome 46 ขึ้นไป

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

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

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

getCreationTime()

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

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

พารามิเตอร์

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (creationTime: number) => void

    • creationTime

      ตัวเลข

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

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

  • Promise<number>

    Chrome 96 ขึ้นไป

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

getID()

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

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

พารามิเตอร์

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (instanceID: string) => void

    • instanceID

      สตริง

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

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

  • Promise<string>

    Chrome 96 ขึ้นไป

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

getToken()

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

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

พารามิเตอร์

  • getTokenParams

    ออบเจ็กต์

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

    • authorizedEntity

      สตริง

      Chrome 46 ขึ้นไป

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

    • ตัวเลือก

      object ไม่บังคับ

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

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

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

    • ขอบเขต

      สตริง

      Chrome 46 ขึ้นไป

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

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (token: string) => void

    • โทเค็น

      สตริง

      โทเค็นที่บริการที่ขอเป็นผู้กำหนด

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

  • Promise<string>

    Chrome 96 ขึ้นไป

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

กิจกรรม

onTokenRefresh

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

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

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    () => void