chrome.instanceID

คำอธิบาย

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

สิทธิ์

gcm

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

Chrome 44 ขึ้นไป

เมธอด

deleteID()

สัญญา 
chrome.instanceID.deleteID(
  callback?: function,
)

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

พารามิเตอร์

  • Callback

    ไม่บังคับ

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

    () => void

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

  • คำสัญญา<โมฆะ>

    Chrome 96 ขึ้นไป

    รองรับคำสัญญาในไฟล์ Manifest V3 ขึ้นไป แต่จะมี Callback สำหรับ ความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 อย่างในการเรียกใช้ฟังก์ชันเดียวกันได้ จะมีการแก้ไขด้วยประเภทเดียวกันที่ส่งไปยัง Callback

deleteToken()

สัญญา 
chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
)

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

พารามิเตอร์

  • deleteTokenParams

    ออบเจ็กต์

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

    • authorizedEntity

      สตริง

      Chrome 46 ขึ้นไป

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

    • ขอบเขต

      สตริง

      Chrome 46 ขึ้นไป

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

  • Callback

    ไม่บังคับ

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

    () => void

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

  • คำสัญญา<โมฆะ>

    Chrome 96 ขึ้นไป

    รองรับคำสัญญาในไฟล์ Manifest V3 ขึ้นไป แต่จะมี Callback สำหรับ ความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 อย่างในการเรียกใช้ฟังก์ชันเดียวกันได้ จะมีการแก้ไขด้วยประเภทเดียวกันที่ส่งไปยัง Callback

getCreationTime()

สัญญา 
chrome.instanceID.getCreationTime(
  callback?: function,
)

เรียกข้อมูลเวลาที่สร้างอินสแตนซ์ID แล้ว callback จะส่งคืนเวลาที่สร้าง

พารามิเตอร์

  • Callback

    ไม่บังคับ

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

    (creationTime: number) => void

    • creationTime

      ตัวเลข

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

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

  • Promise&lt;number&gt;

    Chrome 96 ขึ้นไป

    รองรับคำสัญญาในไฟล์ Manifest V3 ขึ้นไป แต่จะมี Callback สำหรับ ความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 อย่างในการเรียกใช้ฟังก์ชันเดียวกันได้ จะมีการแก้ไขด้วยประเภทเดียวกันที่ส่งไปยัง Callback

getID()

สัญญา 
chrome.instanceID.getID(
  callback?: function,
)

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

พารามิเตอร์

  • Callback

    ไม่บังคับ

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

    (instanceID: string) => void

    • instanceID

      สตริง

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

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

  • คำมั่นสัญญา<สตริง>

    Chrome 96 ขึ้นไป

    รองรับคำสัญญาในไฟล์ Manifest V3 ขึ้นไป แต่จะมี Callback สำหรับ ความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 อย่างในการเรียกใช้ฟังก์ชันเดียวกันได้ จะมีการแก้ไขด้วยประเภทเดียวกันที่ส่งไปยัง Callback

getToken()

สัญญา 
chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
)

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

พารามิเตอร์

  • getTokenParams

    ออบเจ็กต์

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

    • authorizedEntity

      สตริง

      Chrome 46 ขึ้นไป

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

    • ตัวเลือก

      ออบเจ็กต์ไม่บังคับ

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

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

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

    • ขอบเขต

      สตริง

      Chrome 46 ขึ้นไป

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

  • Callback

    ไม่บังคับ

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

    (token: string) => void

    • โทเค็น

      สตริง

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

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

  • คำมั่นสัญญา<สตริง>

    Chrome 96 ขึ้นไป

    รองรับคำสัญญาในไฟล์ Manifest V3 ขึ้นไป แต่จะมี Callback สำหรับ ความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 อย่างในการเรียกใช้ฟังก์ชันเดียวกันได้ จะมีการแก้ไขด้วยประเภทเดียวกันที่ส่งไปยัง Callback

กิจกรรม

onTokenRefresh

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    () => void