chrome.instanceID

คำอธิบาย

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

สิทธิ์

gcm

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

Chrome 44 ขึ้นไป

วิธีการ

deleteID()

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

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

พารามิเตอร์

  • Callback

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

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

    ()=>void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

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

deleteToken()

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

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

พารามิเตอร์

  • deleteTokenParams

    ออบเจ็กต์

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

    • authorizedEntity

      string

      Chrome 46 ขึ้นไป

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

    • ขอบเขต

      string

      Chrome 46 ขึ้นไป

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

  • Callback

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

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

    ()=>void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

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

getCreationTime()

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

เรียกข้อมูลเวลาที่สร้าง InstanceID callback จะส่งคืนเวลาที่สร้าง

พารามิเตอร์

  • Callback

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

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

    (creationTime: number)=>void

    • creationTime

      ตัวเลข

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

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

  • คำมั่นสัญญา<number>

    Chrome 96 ขึ้นไป

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

getID()

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

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

พารามิเตอร์

  • Callback

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

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

    (instanceID: string)=>void

    • instanceID

      string

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

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

  • คำสัญญา<string>

    Chrome 96 ขึ้นไป

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

getToken()

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

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

พารามิเตอร์

  • getTokenParams

    ออบเจ็กต์

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

    • authorizedEntity

      string

      Chrome 46 ขึ้นไป

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

    • ตัวเลือก

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

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

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

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

    • ขอบเขต

      string

      Chrome 46 ขึ้นไป

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

  • Callback

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

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

    (token: string)=>void

    • โทเค็น

      string

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

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

  • คำสัญญา<string>

    Chrome 96 ขึ้นไป

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

กิจกรรม

onTokenRefresh

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    ()=>void