browser.instanceID

شرح

برای دسترسی به سرویس «شناسه نمونه»، از chrome.instanceID استفاده کنید.

اجازه‌ها

gcm

دردسترس بودن

Chrome نسخه ۴۴ و بالاتر browser.* از Chrome نسخه ۱۴۸

روش‌ها

deleteID()

browser.instanceID.deleteID(): Promise<void>

شناسه نمونه برنامه را بازنشانی می‌کند و همه کدهای مرتبط با آن را لغو می‌کند.

بازگشتی‌ها

  • Promise<void>

    Chrome نسخه ۹۶ و بالاتر browser.* از Chrome نسخه ۱۴۸

    وقتی حذف تکمیل شود، مشکل برطرف می‌شود. اگر وعده رد نشود، شناسه نمونه با موفقیت لغو می‌شود.

deleteToken()

browser.instanceID.deleteToken(
  deleteTokenParams: object,
): Promise<void>

کد اعطاشده را باطل می‌کند.

پارامترها

  • deleteTokenParams

    شیء

    پارامترهای deleteToken.

    • authorizedEntity

      رشته

      Chrome نسخه ۴۶ و بالاتر browser.* ‎ از Chrome نسخه ۱۴۸

      نهاد مجاز که برای دریافت کردن توکن استفاده می‌شود.

    • محدوده

      رشته

      Chrome نسخه ۴۶ و بالاتر browser.* ‎ از Chrome نسخه ۱۴۸

      دامنه‌ای که برای دریافت کد استفاده می‌شود.

بازگشتی‌ها

  • Promise<void>

    Chrome نسخه ۹۶ و بالاتر browser.* از Chrome نسخه ۱۴۸

    وقتی حذف کردن کد به‌پایان برسد، حل می‌شود. اگر وعده رد نشود، توکن با موفقیت لغو می‌شود.

getCreationTime()

browser.instanceID.getCreationTime(): Promise<number>

زمانی را که InstanceID تولید شده است بازیابی می‌کند. زمان ایجاد توسط callback برگردانده خواهد شد.

بازگشتی‌ها

  • Promise<number>

    Chrome نسخه ۹۶ و بالاتر browser.* از Chrome نسخه ۱۴۸

    وقتی بازیابی تکمیل شود، مشکل برطرف می‌شود.

getID()

browser.instanceID.getID(): Promise<string>

شناسه‌ای را برای نمونه برنامه بازیابی می‌کند. شناسه نمونه توسط callback برگردانده خواهد شد. تا زمانی که هویت برنامه لغو یا منقضی نشده باشد، همان شناسه برگردانده خواهد شد.

بازگشتی‌ها

  • Promise<string>

    Chrome نسخه ۹۶ و بالاتر browser.* از Chrome نسخه ۱۴۸

    وقتی بازیابی تکمیل شود، مشکل برطرف می‌شود.

getToken()

browser.instanceID.getToken(
  getTokenParams: object,
): Promise<string>

کدی را برمی‌گرداند که به نهاد مجاز اجازه می‌دهد به سرویس تعریف‌شده توسط دامنه دسترسی پیدا کند.

پارامترها

  • getTokenParams

    شیء

    پارامترهای getToken.

    • authorizedEntity

      رشته

      Chrome نسخه ۴۶ و بالاتر browser.* ‎ از Chrome نسخه ۱۴۸

      نهادی را که برای دسترسی به منابع مرتبط با این «شناسه نمونه» مجاز است شناسایی می‌کند. می‌تواند شناسه پروژه از کنسول توسعه‌دهنده Google باشد.

    • گزینه‌ها

      شیء اختیاری

      Chrome نسخه ۴۶ و بالاتر browser.* ‎ از Chrome نسخه ۱۴۸ منسوخ‌شده از Chrome نسخه ۸۹

      گزینه‌ها منسوخ شده‌اند و نادیده گرفته خواهند شد.

      امکان گنجاندن تعداد کمی جفت کلید/مقدار رشته‌ای را که با کد مرتبط خواهد بود و ممکن است در پردازش درخواست استفاده شود فراهم می‌کند.

    • محدوده

      رشته

      Chrome نسخه ۴۶ و بالاتر browser.* ‎ از Chrome نسخه ۱۴۸

      کنش‌های مجاز را که نهاد مجاز می‌تواند انجام دهد شناسایی می‌کند. برای مثال، برای ارسال پیام‌های GCM، باید از گستره GCM استفاده شود.

بازگشتی‌ها

  • Promise<string>

    Chrome نسخه ۹۶ و بالاتر browser.* از Chrome نسخه ۱۴۸

    وقتی بازیابی تکمیل شود، مشکل برطرف می‌شود.

رویدادها

onTokenRefresh

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

وقتی همه کدهای اعطاشده باید بازآوری شوند، فعال می‌شود.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    () => void