執行個體 ID API
您可以使用 Instance ID API 將 Instance ID 與 Android 或 iOS 應用程式整合。Instance ID 會為應用程式的每個執行個體提供專屬 ID,以及驗證和授權動作的機制。InstanceID
的生命週期很長,但可能會因下列原因而到期:
- 將裝置恢復原廠設定。
- 使用者解除安裝應用程式。
- 使用者在應用程式中執行「清除資料」功能。
- 裝置長時間未使用 (裝置和地區決定時間範圍)。
- 執行個體 ID 服務偵測到濫用或錯誤情形,並重設
InstanceID
。
- 如果用戶端應用程式需要這項功能,則為伺服器端程式碼。
執行個體 ID 服務會透過回呼通知 InstanceIDListenerService
,讓應用程式知道 InstanceID
已重設。如果應用程式收到這項通知,就必須呼叫 getToken()
並擷取新的 InstanceID
,然後更新伺服器。
使用 getToken
方法證明 InstanceID
的擁有權,並允許伺服器存取與應用程式相關聯的資料或服務。此方法遵循 OAuth2 的模式,且需要 authorizedEntity
和 scope
。authorizedEntity
可以是專案 ID 或其他 InstanceID
,可用來決定哪些服務有權使用產生的權杖。scope
會決定權杖允許存取的特定服務或資料。
進一步瞭解以下項目的 Instance ID API:
Android
iOS
伺服器
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-03-11 (世界標準時間)。
[null,null,["上次更新時間:2025-03-11 (世界標準時間)。"],[[["The Instance ID API provides a unique identifier for each app instance and enables authentication and authorization."],["Instance IDs are long-lived but can expire due to various factors like device reset, uninstallation, data clearing, extended inactivity, or service-detected issues."],["Upon Instance ID reset, apps are notified and must retrieve a new ID using `getToken()` and update their servers."],["The `getToken()` method, using OAuth2 patterns, verifies Instance ID ownership and grants server access to associated data or services based on authorized entity and scope."]]],[]]