Instance ID API
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Instance ID API memungkinkan Anda mengintegrasikan Instance ID dengan aplikasi Android atau iOS. Instance ID memberikan ID unik untuk setiap instance aplikasi Anda dan mekanisme untuk mengautentikasi dan memberikan otorisasi tindakan. InstanceID memiliki masa berlaku
yang lama, tetapi dapat berakhir masa berlakunya karena alasan berikut:
- Reset perangkat ke setelan pabrik.
- Pengguna meng-uninstal aplikasi.
- Pengguna melakukan “Hapus Data” di aplikasi.
- Perangkat tidak digunakan selama jangka waktu yang lama (perangkat dan wilayah menentukan
jangka waktu).
- Layanan Instance ID mendeteksi penyalahgunaan atau error dan mereset
InstanceID.
- Kode sisi server jika aplikasi klien Anda memerlukan fungsi tersebut.
Layanan Instance ID memberi tahu aplikasi Anda tentang reset InstanceID melalui
callback ke InstanceIDListenerService. Jika 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 diberi otorisasi untuk menggunakan token yang dihasilkan. scope menentukan layanan atau data tertentu yang diizinkan token untuk diakses.
Pelajari Instance ID API lebih lanjut untuk:
Android
iOS
Server
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-31 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-31 UTC."],[[["\u003cp\u003eThe Instance ID API provides a unique identifier for each app instance and enables authentication and authorization.\u003c/p\u003e\n"],["\u003cp\u003eInstance IDs are long-lived but can expire due to various factors like device reset, uninstallation, data clearing, extended inactivity, or service-detected issues.\u003c/p\u003e\n"],["\u003cp\u003eUpon Instance ID reset, apps are notified and must retrieve a new ID using \u003ccode\u003egetToken()\u003c/code\u003e and update their servers.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetToken()\u003c/code\u003e method, using OAuth2 patterns, verifies Instance ID ownership and grants server access to associated data or services based on authorized entity and scope.\u003c/p\u003e\n"]]],[],null,["# Instance ID API\n\nThe Instance ID API lets you integrate Instance ID with your Android\nor iOS app. Instance ID provides a unique identifier for each instance of\nyour app and a mechanism to authenticate and authorize actions. The `InstanceID` is long\nlived, but may expire for the following reasons:\n\n- Device factory reset.\n- User uninstalls the app.\n- User performs \"Clear Data\" in the app.\n- Device unused for an extended period (device and region determines the timespan).\n- Instance ID service detects abuse or errors and resets the `InstanceID`.\n- Server-side code if your client app requires that functionality.\n\nThe Instance ID service notifies your app of an `InstanceID` reset via\ncallback to a `InstanceIDListenerService`. If your app receives this\nnotification, it must call `getToken()` and retrieve the new `InstanceID`,\nand update its servers.\n\nUse the `getToken` method to prove the ownership of the `InstanceID` and to allow\nservers to access data or services associated with the app. The method follows\nthe patterns of OAuth2, and requires an `authorizedEntity` and `scope`. The\n`authorizedEntity` can be a project ID or another `InstanceID`, and it determines\nthe services that are authorized to use the generated token. The `scope`\ndetermines the specific service or data to which the token allows access.\n\nLearn more about the Instance ID API for:\n\n[Android](/instance-id/reference/android/api)\n[iOS](/instance-id/reference/ios/api)\n[Server](/instance-id/reference/server)"]]
