Instance ID API memungkinkan Anda mengintegrasikan Instance ID dengan aplikasi Android atau iOS. Instance ID menyediakan ID unik untuk setiap instance aplikasi Anda dan mekanisme untuk mengautentikasi dan mengizinkan tindakan. InstanceID
memiliki masa berlaku yang lama, tetapi dapat berakhir karena alasan berikut:
- Perangkat direset ke setelan pabrik.
- Pengguna meng-uninstal aplikasi.
- Pengguna melakukan “Hapus Data” di aplikasi.
- Perangkat tidak digunakan dalam jangka waktu yang lama (jangka waktu ditentukan oleh perangkat dan wilayah).
- 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 aplikasi Anda 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 diizinkan untuk menggunakan token yang dihasilkan. scope
menentukan layanan atau data tertentu yang dapat diakses oleh token.
Pelajari lebih lanjut Instance ID API untuk: