Instance ID API memungkinkan Anda mengintegrasikan Instance ID dengan aplikasi Android atau iOS. Instance ID memberikan ID unik untuk setiap instance aplikasi Anda dan mekanisme untuk mengautentikasi dan memberikan otorisasi tindakan. InstanceID
memiliki masa aktif
yang lama, tetapi dapat berakhir masa berlakunya karena alasan berikut:
- Reset perangkat ke setelan pabrik.
- Pengguna meng-uninstal aplikasi.
- Pengguna melakukan “Hapus Data” di aplikasi.
- Perangkat tidak digunakan selama jangka waktu yang lama (perangkat dan wilayah menentukan jangka waktu).
- Layanan Instance ID mendeteksi penyalahgunaan atau error dan mereset
InstanceID
. - Kode sisi server jika aplikasi klien Anda memerlukan fungsi tersebut.
Layanan Instance ID memberi tahu aplikasi Anda tentang reset InstanceID
melalui
callback ke InstanceIDListenerService
. Jika menerima notifikasi
ini, aplikasi harus memanggil getToken()
dan mengambil InstanceID
baru,
serta mengupdate servernya.
Gunakan metode getToken
untuk membuktikan kepemilikan InstanceID
dan mengizinkan
server mengakses data atau layanan yang terkait dengan aplikasi. Metode ini mengikuti
pola OAuth2, dan memerlukan authorizedEntity
dan scope
. authorizedEntity
dapat berupa project ID atau InstanceID
lain, dan menentukan layanan yang diberi otorisasi untuk menggunakan token yang dihasilkan. scope
menentukan layanan atau data tertentu yang diizinkan token untuk diakses.
Pelajari Instance ID API lebih lanjut untuk: