رابط برنامهنویسی کاربردی Instance ID به شما امکان میدهد Instance ID را با برنامه اندروید یا iOS خود ادغام کنید. Instance ID یک شناسه منحصر به فرد برای هر نمونه از برنامه شما و مکانیزمی برای احراز هویت و مجوزدهی اقدامات ارائه میدهد. InstanceID عمر طولانی دارد، اما ممکن است به دلایل زیر منقضی شود:
- تنظیم مجدد کارخانه دستگاه.
- کاربر برنامه را حذف نصب میکند.
- کاربر «پاک کردن دادهها» را در برنامه انجام میدهد.
- دستگاه برای مدت طولانی استفاده نشده باشد (دستگاه و منطقه، مدت زمان را تعیین میکنند).
- سرویس Instance ID سوءاستفاده یا خطاها را تشخیص داده و
InstanceIDرا مجدداً تنظیم میکند. - کد سمت سرور اگر برنامه کلاینت شما به آن قابلیت نیاز دارد.
سرویس Instance ID از طریق فراخوانی InstanceIDListenerService ، برنامه شما را از تنظیم مجدد InstanceID مطلع میکند. اگر برنامه شما این اعلان را دریافت کند، باید getToken() فراخوانی کرده و InstanceID جدید را بازیابی کند و سرورهای خود را بهروزرسانی کند.
از متد getToken برای اثبات مالکیت InstanceID و اجازه دادن به سرورها برای دسترسی به دادهها یا سرویسهای مرتبط با برنامه استفاده کنید. این متد از الگوهای OAuth2 پیروی میکند و به یک authorizedEntity و scope نیاز دارد. authorizedEntity میتواند یک project ID یا یک InstanceID دیگر باشد و سرویسهایی را که مجاز به استفاده از توکن تولید شده هستند، تعیین میکند. scope سرویس یا دادههای خاصی را که توکن اجازه دسترسی به آنها را میدهد، تعیین میکند.
درباره API مربوط به Instance ID برای موارد زیر بیشتر بدانید: