این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

chrome.instanceID

توضیحات

برای دسترسی به سرویس Instance ID از chrome.instanceID استفاده کنید.

مجوزها

gcm

در دسترس بودن

Chrome 44+

روش ها

deleteID()

قول بده

chrome.instanceID.deleteID(
  callback?: function,
)

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

پارامترها

پاسخ به تماس
عملکرد اختیاری
پارامتر callback به نظر می رسد:
```
() => void
```

برمی گرداند

قول<باطل>
Chrome 96+
Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

deleteToken()

قول بده

chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
)

توکن اعطایی را باطل می کند.

پارامترها

حذف TokenParams
شی
پارامترهای حذف توکن
- نهاد مجاز
  رشته
  Chrome 46+
  نهاد مجاز که برای دریافت توکن استفاده می شود.
- دامنه
  رشته
  Chrome 46+
  محدوده ای که برای به دست آوردن توکن استفاده می شود.
پاسخ به تماس
عملکرد اختیاری
پارامتر callback به نظر می رسد:
```
() => void
```

برمی گرداند

قول<باطل>
Chrome 96+
Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

getCreationTime()

قول بده

chrome.instanceID.getCreationTime(
  callback?: function,
)

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

پارامترها

پاسخ به تماس
عملکرد اختیاری
پارامتر callback به نظر می رسد:
```
(creationTime: number) => void
```
- زمان خلقت
  شماره
  زمانی که شناسه نمونه تولید شده است، که در میلی ثانیه از آن دوره نشان داده شده است.

برمی گرداند

قول <تعداد>
Chrome 96+
Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

getID()

قول بده

chrome.instanceID.getID(
  callback?: function,
)

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

پارامترها

پاسخ به تماس
عملکرد اختیاری
پارامتر callback به نظر می رسد:
```
(instanceID: string) => void
```
- شناسه نمونه
  رشته
  شناسه نمونه اختصاص داده شده به نمونه برنامه.

برمی گرداند

قول<رشته>
Chrome 96+
Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

getToken()

قول بده

chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
)

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

پارامترها

getTokenParams
شی
پارامترهای getToken.
- نهاد مجاز
  رشته
  Chrome 46+
  نهادی را که مجاز به دسترسی به منابع مرتبط با این Instance ID است را شناسایی می کند. این می تواند یک شناسه پروژه از کنسول توسعه دهنده Google باشد.
- گزینه ها
  شی اختیاری
  Chrome 46+ از Chrome 89 منسوخ شده است
  گزینه ها منسوخ شده اند و نادیده گرفته خواهند شد.
  امکان گنجاندن تعداد کمی جفت کلید/مقدار رشته‌ای را می‌دهد که با نشانه مرتبط هستند و ممکن است در پردازش درخواست استفاده شوند.
- دامنه
  رشته
  Chrome 46+
  اقدامات مجاز را که نهاد مجاز می تواند انجام دهد را شناسایی می کند. به عنوان مثال برای ارسال پیام های GCM، دامنه GCM باید استفاده شود.
پاسخ به تماس
عملکرد اختیاری
پارامتر callback به نظر می رسد:
```
(token: string) => void
```
- نشانه
  رشته
  نشانه ای که توسط سرویس درخواستی اختصاص داده شده است.

برمی گرداند

قول<رشته>
Chrome 96+
Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

رویدادها

onTokenRefresh

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

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

پارامترها

پاسخ به تماس
تابع
پارامتر callback به نظر می رسد:
```
() => void
```