Implementación en Android

Los siguientes ejemplos te ayudarán a implementar un ID de instancia en un cliente de Android. Ten en cuenta que estos ejemplos utilizan el alcance de GCM, que es útil solo con fines de demostración, ya que se retiró el uso de 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.

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, se requiere 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 tokens y los IDs de instancia

Instance ID te permite borrar y actualizar tokens.

Borra los tokens y los IDs de instancia

String authorizedEntity = PROJECT_ID;
String scope = "GCM";
InstanceID.getInstance(context).deleteToken(authorizedEntity,scope);

También puedes borrar el ID de la instancia, 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();

Nota: Si la app usó tokens que deleteInstanceID borró, deberá generar tokens de reemplazo.

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 la app actualice los tokens. También puede iniciar devoluciones de llamada en los siguientes casos:

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

Implementa el servicio de objeto de escucha de Instance ID en la 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>