Los siguientes ejemplos te ayudarán a implementar un ID de instancia en un cliente de Android. Ten en cuenta que estos ejemplos usan el alcance de GCM, que es útil solo con fines de demostración porque Google Cloud Messaging se retiró del uso.
Configura los Servicios de Google Play
Para escribir tu aplicación cliente, usa el SDK de Servicios de Google Play, como se describe en Cómo configurar el SDK de Servicios de Google Play. La biblioteca de Servicios de Play incluye la biblioteca de Instance ID.
Obtén un ID de instancia
La siguiente línea de código muestra un ID de instancia:
String iid = InstanceID.getInstance(context).getId();
Genera un token
Para generar tokens, necesitas un ID del proyecto que genera Google Developers Console.
String authorizedEntity = PROJECT_ID; // Project id from Google Developer Console
String scope = "GCM"; // e.g. communicating using GCM, but you can use any
// URL-safe characters up to a maximum of 1000, or
// you can also leave it blank.
String token = InstanceID.getInstance(context).getToken(authorizedEntity,scope);
Administra los IDs de instancia y tokens
El ID de instancia te permite borrar y actualizar tokens.
Borrar IDs de instancia y tokens
String authorizedEntity = PROJECT_ID;
String scope = "GCM";
InstanceID.getInstance(context).deleteToken(authorizedEntity,scope);
También puedes borrar el ID de instancia en sí, incluidos todos los tokens asociados. La próxima vez que llames a getInstance(), obtendrás un nuevo ID de instancia:
InstanceID.getInstance(context).deleteInstanceID();
String newIID = InstanceID.getInstance(context).getId();
Tokens de actualización
El servicio de ID de instancia inicia devoluciones de llamada de forma periódica (por ejemplo, cada 6 meses) y solicita que tu app actualice sus tokens. También puede iniciar devoluciones de llamada en los siguientes casos:
- Hay problemas de seguridad, por ejemplo, problemas de SSL o de plataforma.
- La información del dispositivo ya no es válida; por ejemplo, la copia de seguridad y el restablecimiento.
- De lo contrario, el servicio de Instance ID se ve afectado.
Implementa el servicio de objeto de escucha de Instance ID en tu app para recibir estas devoluciones de llamada:
public class MyInstanceIDService extends InstanceIDListenerService {
public void onTokenRefresh() {
refreshAllTokens();
}
private void refreshAllTokens() {
// assuming you have defined TokenList as
// some generalized store for your tokens
ArrayList<TokenList> tokenList = TokensList.get();
InstanceID iid = InstanceID.getInstance(this);
for(tokenItem : tokenList) {
tokenItem.token =
iid.getToken(tokenItem.authorizedEntity,tokenItem.scope,tokenItem.options);
// send this tokenItem.token to your server
}
}
};
También debes configurar este servicio en el archivo de manifiesto del proyecto:
<service android:name=".MyInstanceIDService" android:exported="false">
<intent-filter>
<action android:name="com.google.android.gms.iid.InstanceID"/>
</intent-filter>
</service>