Se usó la API de Cloud Translation para traducir esta página.

Suscripción y claves de API

Para usar la API de Google Awareness, debes agregar una clave de API de Google a tu app. El tipo de clave de API que necesitas es una clave de API de Android.

Todas las apps para Android se firman con un certificado digital para el que tienes la clave privada. Para obtener más información sobre los certificados digitales, consulta la guía de Android sobre cómo firmar tu app.

Las claves de API de Android están vinculadas a pares de paquetes de certificados específicos. Solo necesitas una clave para cada certificado, independientemente de la cantidad de usuarios que tengas para la app.

Se requieren varios pasos para obtener una clave para tu app. Se describen en detalle en esta guía y se resumen de la siguiente manera:

Obtén información sobre el certificado de tu app.
Registra un proyecto en la consola de Google Play Console y agrega la API de User Context como un servicio para el proyecto.
Solicitar una clave.
Agrega la clave a tu app. Para ello, agrega un elemento al manifiesto de la app.

Cómo encontrar la información del certificado de tu app

La clave de API se basa en una versión abreviada del certificado digital de tu app, conocida como huella digital SHA-1. Para mostrar la huella digital SHA-1 de tu certificado, primero asegúrate de usar el certificado correcto. Es posible que tengas los siguientes dos certificados para elegir:

Certificado de depuración: Las herramientas del SDK de Android generan este certificado automáticamente cuando realizas una compilación de depuración. Utiliza este certificado solo con apps que estés probando. No intentes publicar una app firmada con un certificado de depuración. El certificado de depuración se describe más detalladamente en la sección Firma tu compilación de depuración en la documentación para desarrolladores de Android.
Certificado de lanzamiento: Las herramientas del SDK de Android generan este certificado cuando realizas una compilación de lanzamiento. También puedes generar este certificado con el programa keytool. Usa este certificado cuando tengas todo listo para lanzar tu app al público.

Para obtener más información sobre keytool, consulta su documentación de Oracle.

Certificado de depuración

Cómo mostrar la huella digital del certificado de depuración

Usa el programa keytool con el parámetro -v para mostrar la huella digital SHA-1 de un certificado. Para ello, completa los siguientes pasos:

Busca tu archivo de depuración de depósito de claves. El nombre del archivo es debug.keystore y se crea la primera vez que compilas el proyecto. De forma predeterminada, se almacena en el mismo directorio que los archivos de tu dispositivo virtual de Android (AVD):
- OS X y Linux: ~/.android/
- Windows Vista y Windows 7: C:\Users\your_user_name\.android\

Indica la huella digital SHA-1:

En el caso de Linux o OS X, abre una ventana de terminal y escribe lo siguiente:

keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

Para Windows Vista y Windows 7, ejecuta lo siguiente:

keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Debería ver un resultado similar al siguiente:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

Certificado de lanzamiento

Cómo mostrar la huella digital del certificado de lanzamiento

Usa el programa keytool con el parámetro -v para mostrar la huella digital SHA-1 de un certificado. Para ello, completa los siguientes pasos:

Busca tu archivo de depósito de claves para certificado de lanzamiento. No existe una ubicación ni un nombre predeterminados para este archivo. Si no especificas estos datos al compilar tu app para su lanzamiento, el archivo .apk quedará sin firmar, y deberás firmarlo antes de publicarlo. Para el certificado de lanzamiento, también necesitas el alias del certificado, las contraseñas del almacén de claves y el certificado.
Ingresa lo siguiente para enumerar los alias de todas las claves en un almacén de claves:
```
keytool -list -keystore your_keystore_name
      
```
Reemplaza your_keystore_name por la ruta de acceso y el nombre completamente calificados del almacén de claves. Incluye la extensión .keystore. Ingresa la contraseña del almacén de claves cuando se te solicite. Luego, keytool mostrará todos los alias en el almacén de claves.

En una ventana de terminal o de comandos, escribe lo siguiente:

      keytool -list -v -keystore your_keystore_name -alias your_alias_name

Reemplaza your_keystore_name por la ruta de acceso y el nombre completamente calificados del almacén de claves. Incluye la extensión .keystore.
Reemplaza your_alias_name por el alias que le asignaste al certificado cuando lo creaste.

Debería ver un resultado similar al siguiente:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

En la línea que comienza con SHA1, se incluye la huella digital SHA-1 del certificado. La huella digital es una secuencia de 20 números hexadecimales de dos dígitos separados por dos puntos.

Precaución: Para proteger tu clave y el almacén de claves, no ingreses los argumentos storepass ni keypass en la línea de comandos, salvo que la seguridad de tu computadora esté garantizada. Por ejemplo, en una computadora de uso público, alguien podría ver el historial de tu ventana de terminal o la lista de procesos en ejecución, obtener la contraseña y, luego, tener acceso de escritura a tu certificado de firma. Esto le permitiría a esa persona modificar o reemplazar tu app por una propia.

Obtén una clave de API de Google Play Console

Para comenzar a usar la API de Google Awareness, haz clic en el botón Obtener una clave. Se vincula a Google Play Console, que te guía a través del proceso y activa la API de Awareness automáticamente.

Obtén una clave

También puedes seguir estos pasos para obtener una clave de API:

Ve a Google Play Console.
Selecciona un proyecto o crea uno nuevo.
Haz clic en Continuar para habilitar la API de Awareness.
En la página "Credenciales", crea una clave de Android y configura las credenciales de la API.
Nota: Si tienes una clave de Android existente, puedes usarla.
En el cuadro de diálogo "Crear clave", debes restringir el uso a las apps para Android. Para ello, ingresa la huella digital SHA-1 y el nombre del paquete de tu app, como en el siguiente ejemplo:
```
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.awareness-example
```
Haz clic en Crear. Tu nueva clave de API de Android aparecerá en la lista de claves de API de tu proyecto. Una clave de API es una cadena de caracteres, como la siguiente:
```
AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
```

Ahora que tienes una clave de API, puedes agregarla al manifiesto de la app, como se describe en la guía de Inicio.

Activa APIs adicionales

La API de Awareness te permite acceder a varios tipos de datos contextuales, como las balizas. Para usar estos tipos, debes habilitar las APIs correspondientes en la consola de Google Play Console.

Servicio	Métodos de la API de Awareness	API que se habilitará
Beacons	`SnapshotApi.getBeaconState()`, `FenceApi.BeaconFence`	API de Nearby Messages