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: