Implementación de Android

Los siguientes ejemplos te ayudarán a implementar el ID de instancia en un cliente de Android. Ten en cuenta que estos ejemplos usan el alcance de GCM que usarías en la administración de tokens en el cliente de Android para Google Cloud Messaging.

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.

Obtener 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, se necesita un ID del proyecto generado por 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);

Administrar tokens e ID de instancias

El ID de instancia te permite borrar y actualizar los tokens.

Borrar tokens e ID de instancia

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 ID de instancia nuevo:

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 manera periódica (por ejemplo, cada 6 meses) para solicitar que tu app actualice sus tokens. También puede iniciar devoluciones de llamada en los siguientes casos:

  • Hay problemas de seguridad, como SSL o la plataforma.
  • La información del dispositivo ya no es válida; por ejemplo, copia de seguridad y restauración.
  • De lo contrario, el servicio de ID de instancia se ve afectado.

Implementa el servicio de agente 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 para el proyecto:

<service android:name=".MyInstanceIDService" android:exported="false">
  <intent-filter>
        <action android:name="com.google.android.gms.iid.InstanceID"/>
  </intent-filter>
</service>