Instance ID API dapat digunakan untuk mengintegrasikan ID Instance dengan aplikasi Android atau iOS. ID Instance menyediakan ID unik untuk setiap instance aplikasi dan mekanisme untuk mengautentikasi serta memberi otorisasi tindakan. InstanceID
berlaku dalam waktu lama, tetapi dapat habis masa berlakunya karena alasan berikut:
- Reset perangkat ke setelan pabrik.
- Pengguna meng-uninstal aplikasi.
- Pengguna melakukan “Hapus Data” di aplikasi.
- Perangkat tidak digunakan dalam jangka waktu yang lama (perangkat dan region menentukan rentang waktu).
- Layanan ID instance mendeteksi penyalahgunaan atau error dan mereset
InstanceID
. - Kode sisi server jika aplikasi klien Anda memerlukan fungsi tersebut.
Layanan ID Instance memberi tahu aplikasi Anda tentang reset InstanceID
melalui callback ke InstanceIDListenerService
. Jika menerima notifikasi
ini, aplikasi Anda harus memanggil getToken()
dan mengambil InstanceID
baru,
serta mengupdate servernya.
Gunakan metode getToken
untuk membuktikan kepemilikan InstanceID
dan untuk mengizinkan
server mengakses data atau layanan yang terkait dengan aplikasi. Metode ini mengikuti
pola OAuth2, dan memerlukan authorizedEntity
serta 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 aksesnya diizinkan oleh token.
Pelajari Instance ID API lebih lanjut untuk: