Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Instance ID te permite integrar el ID de instancia en tu app para Android o iOS. El ID de instancia proporciona un identificador único para cada instancia de tu app y un mecanismo para autenticar y autorizar acciones. El InstanceID tiene una duración prolongada, pero puede vencer por los siguientes motivos:
Se restableció 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 sobre 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 a usar el token generado. El parámetro 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:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)"]]
