Instance ID API memungkinkan Anda 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
berumur panjang, tetapi dapat habis masa berlakunya karena alasan berikut:
- Reset ke setelan pabrik.
- Pengguna meng-uninstal aplikasi.
- Pengguna melakukan “Hapus Data” di aplikasi.
- Perangkat yang tidak digunakan untuk jangka waktu yang lama (perangkat dan wilayah 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 memungkinkan
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 diotorisasi untuk menggunakan token yang dihasilkan. scope
menentukan layanan atau data tertentu yang diizinkan oleh token.
Pelajari Instance ID API lebih lanjut untuk: