API de Instance ID
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Instance ID te permite integrar Instance ID en tu app para Android
o iOS. Instance ID proporciona un identificador único para cada instancia de
tu app y un mecanismo para autenticar y autorizar acciones. El InstanceID es duradero, pero puede vencer por los siguientes motivos:
- Restablecimiento de la configuración de fábrica del dispositivo
- El usuario desinstala la app.
- El usuario realiza la acción "Borrar datos" en la app.
- El dispositivo no se usó durante un período prolongado (el dispositivo y la región determinan el período).
- El servicio de ID de instancia detecta abusos o errores y restablece el
InstanceID.
- Código del servidor si tu app cliente requiere esa funcionalidad
El servicio de ID de instancia notifica a tu app un restablecimiento de InstanceID a través de una devolución de llamada a un InstanceIDListenerService. Si tu app recibe esta notificación, debe llamar a getToken(), recuperar el nuevo InstanceID y actualizar sus servidores.
Usa el método getToken para demostrar la propiedad de InstanceID y permitir que los servidores accedan a los datos o servicios asociados con la app. El método sigue los patrones de OAuth2 y requiere un authorizedEntity y un scope. El authorizedEntity puede ser un ID de proyecto o cualquier otro InstanceID, y determina los servicios que están autorizados para usar el token generado. scope determina el servicio o los datos específicos a los que el token permite el acceso.
Obtén más información sobre la API de Instance ID para lo siguiente:
Android
iOS
Servidor
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 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)"]]
