Dengan Instance ID API, Anda dapat mengintegrasikan ID Instance dengan aplikasi Android
atau iOS. ID Instance memberikan ID unik untuk setiap instance
aplikasi Anda dan mekanisme untuk mengautentikasi serta mengizinkan tindakan. InstanceID
berumur
panjang, tetapi dapat berakhir masa berlakunya karena alasan berikut:
- Perangkat direset ke setelan pabrik.
- Pengguna meng-uninstal aplikasi.
- Pengguna melakukan “Hapus Data” di aplikasi.
- Perangkat yang 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
dan scope
. authorizedEntity
dapat berupa project ID atau InstanceID
lain, dan menentukan layanan yang diizinkan untuk menggunakan token yang dihasilkan. scope
menentukan layanan atau data tertentu yang dapat diakses oleh token.
Pelajari lebih lanjut Instance ID API untuk: