API Instance ID
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Instance ID ti consente di integrare Instance ID con la tua app per Android
o iOS. Instance ID fornisce un identificatore univoco per ogni istanza della tua
app e un meccanismo per autenticare e autorizzare le azioni. Il InstanceID è di lunga
durata, ma potrebbe scadere per i seguenti motivi:
- Ripristino dei dati di fabbrica del dispositivo.
- L'utente disinstalla l'app.
- L'utente esegue "Cancella dati" nell'app.
- Dispositivo inutilizzato per un periodo prolungato (il periodo di tempo è determinato dal dispositivo e dalla regione).
- Il servizio ID istanza rileva comportamenti illeciti o errori e reimposta
InstanceID.
- Codice lato server se l'app client richiede questa funzionalità.
Il servizio Instance ID notifica alla tua app un ripristino di InstanceID tramite
callback a un InstanceIDListenerService. Se la tua app riceve questa
notifica, deve chiamare getToken() e recuperare il nuovo InstanceID,
e aggiornare i suoi server.
Utilizza il metodo getToken per dimostrare la proprietà di InstanceID e per consentire
ai server di accedere ai dati o ai servizi associati all'app. Il metodo segue
i pattern di OAuth2 e richiede un authorizedEntity e un scope. authorizedEntity può essere un ID progetto o un altro InstanceID e determina i servizi autorizzati a utilizzare il token generato. Il scope
determina il servizio o i dati specifici a cui il token consente l'accesso.
Scopri di più sull'API Instance ID per:
Android
iOS
Server
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-09-05 UTC.
[null,null,["Ultimo aggiornamento 2025-09-05 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)"]]
