chrome.instanceID

refresh date: 2026-09-25 robots: noindex

תיאור

משתמשים ב-chrome.instanceID כדי לגשת לשירות Instance ID.

הרשאות

gcm

זמינות

‫Chrome מגרסה 44 ואילך

Methods

deleteID()

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

מאפס את המזהה של מופע האפליקציה ומבטל את כל הטוקנים שמשויכים אליו.

פרמטרים

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    הבעיה נפתרת כשהמחיקה מסתיימת. אם ה-promise לא נדחה, מזהה המכונה בוטל בהצלחה.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

deleteToken()

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

מבטל טוקן שהוקצה.

פרמטרים

  • deleteTokenParams

    אובייקט

    פרמטרים של deleteToken.

    • authorizedEntity

      מחרוזת

      ‫Chrome מגרסה 46 ואילך

      הישות המורשית שמשמשת לקבלת האסימון.

    • היקף

      מחרוזת

      Chrome 46 ואילך

      היקף ההרשאות שמשמש לקבלת האסימון.

  • callback

    function optional

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 96 ואילך

    הפעולה מסתיימת כשמחיקת האסימון מסתיימת. אם ה-promise לא נדחה, סימן שהאסימון בוטל בהצלחה.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

getCreationTime()

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

מאחזר את השעה שבה נוצר ה-InstanceID. זמן היצירה יוחזר על ידי callback.

פרמטרים

  • callback

    function optional

    הפרמטר callback נראה כך: 

    (creationTime: number) => void

    • creationTime

      number

      הזמן שבו נוצר מזהה המכונה, מיוצג באלפיות השנייה מאז ראשית הזמן.

החזרות

  • Promise<number>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתקיימת כשהשליפה מסתיימת.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

getID()

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

מאחזר מזהה של מופע האפליקציה. מזהה המכונה יוחזר על ידי callback. אותו מזהה יוחזר כל עוד זהות האפליקציה לא בוטלה או פג תוקפה.

פרמטרים

  • callback

    function optional

    הפרמטר callback נראה כך: 

    (instanceID: string) => void

    • instanceID

      מחרוזת

      מזהה מופע שמוקצה למופע של האפליקציה.

החזרות

  • Promise<string>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתקיימת כשהשליפה מסתיימת.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

getToken()

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

החזרת טוקן שמאפשר לגורם המוסמך לגשת לשירות שמוגדר בהיקף ההרשאות.

פרמטרים

  • getTokenParams

    אובייקט

    פרמטרים של getToken.

    • authorizedEntity

      מחרוזת

      ‫Chrome מגרסה 46 ואילך

      מזהה את הישות שמורשית לגשת למשאבים שמשויכים למזהה המכונה הזה. זה יכול להיות מזהה פרויקט מ-Google Developer Console.

    • אפשרויות

      object optional

      Chrome 46 ואילך הוצא משימוש בגרסה Chrome 89

      האפשרויות האלה הוצאו משימוש והמערכת תתעלם מהן.

      מאפשר לכלול מספר קטן של צמדי מפתח/ערך של מחרוזות שישויכו לאסימון, ואולי ישמשו לעיבוד הבקשה.

    • היקף

      מחרוזת

      Chrome 46 ואילך

      מזהה פעולות מורשות שהגורם המוסמך יכול לבצע. לדוגמה, כדי לשלוח הודעות GCM, צריך להשתמש בהיקף ההרשאות GCM.

  • callback

    function optional

    הפרמטר callback נראה כך: 

    (token: string) => void

    • token

      מחרוזת

      אסימון שהוקצה על ידי השירות המבוקש.

החזרות

  • Promise<string>

    ‫Chrome מגרסה 96 ואילך

    ההבטחה מתקיימת כשהשליפה מסתיימת.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

אירועים

onTokenRefresh

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

מופעל כשצריך לרענן את כל הטוקנים שהוקצו.

פרמטרים

  • callback

    פונקציה

    הפרמטר callback נראה כך: 

    () => void