Instance ID API 可讓您將執行個體 ID 與 Android 或 iOS 應用程式整合。執行個體 ID 會提供每個應用程式執行個體的專屬 ID,以及驗證和授權動作的機制。InstanceID
存在時間很長,但可能會因為下列原因而失效:
- 將裝置恢復原廠設定。
- 使用者解除安裝應用程式。
- 使用者在應用程式中執行「清除資料」。
- 裝置長時間未使用 (裝置和區域會決定時間範圍)。
- 執行個體 ID 服務偵測到濫用或錯誤,並重設
InstanceID
。 - 伺服器端程式碼 (如果您的用戶端應用程式需要該功能)。
執行個體 ID 服務會透過回呼 InstanceIDListenerService
,通知應用程式有 InstanceID
重設的情形。如果應用程式收到這類通知,必須呼叫 getToken()
並擷取新的 InstanceID
,然後更新伺服器。
使用 getToken
方法驗證 InstanceID
的擁有權,並允許伺服器存取與應用程式相關聯的資料或服務。這個方法遵循 OAuth2 模式,需要使用 authorizedEntity
和 scope
。authorizedEntity
可以是專案 ID 或其他 InstanceID
,可以判定有權使用產生的權杖的服務。scope
決定憑證允許存取的特定服務或資料。
進一步瞭解以下項目的 Instance ID API: