Obtén un ID de cliente de OAuth 2.0

Descripción general

Si quieres usar Google Fit para Android, necesitas un ID de cliente de OAuth 2.0 para aplicaciones de Android.

Todas las apps para Android están firmadas con un certificado digital del que tienes la clave privada. Consulta la guía de Android para firmar tus aplicaciones a fin de obtener más información sobre los certificados digitales.

Los ID de cliente de OAuth de Android están vinculados a pares de certificado/paquete específicos. Solo necesitas un ID por cada certificado, independientemente de la cantidad de usuarios que usen la app.

Para obtener un ID para su aplicación, se requieren varios pasos. Estos pasos se describen a continuación.

  1. Busca la información del certificado de tu app.
  2. Crea o modifica un proyecto en la Consola de API de Google.
  3. Solicitar un ID de cliente de OAuth 2.0

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

La clave de API se basa en una forma corta del certificado digital de tu app, que se conoce como su huella digital SHA-1. Para mostrar la huella digital SHA-1 para tu certificado, primero asegúrate de estar usando el certificado correcto. Puedes tener dos certificados:

  • 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 Firma en el modo 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. Utiliza este certificado cuando estés listo para lanzar tu app al público.

Sigue los pasos que se incluyen a continuación para mostrar la huella digital SHA-1 de un certificado mediante el programa keytool con el parámetro -v. Para obtener más información sobre Keytool, consulta la documentación de Oracle.

Certificado de depuración

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

  1. Busca el archivo de almacén de claves correspondiente a tu depuración. 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):

    • macOS y Linux: ~/.android/
    • Windows Vista y Windows 7: C:\Users\your_user_name\.android\
  2. Indica la huella digital SHA-1:

    • En el caso de macOS o Linux, abre una ventana de la terminal y escribe lo siguiente:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • En el caso de Windows Vista y Windows 7, ejecuta lo siguiente:

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

Deberías ver un resultado similar a este:

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 visualizar la huella digital del certificado de lanzamiento

  1. Busca el archivo de almacén de claves correspondiente a tu 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 y las contraseñas del almacén de claves y del certificado. Puedes indicar los alias de todas las claves en un almacén de claves. Para ello, ingresa lo siguiente:

    keytool -list -keystore your_keystore_name

    Reemplaza your_keystore_name por la ruta de acceso completamente calificada y el nombre del almacén de claves, incluida la extensión .keystore. Se te pedirá que ingreses la contraseña del almacén de claves. Luego, keytool mostrará todos los alias en el almacén de claves.

  2. En una terminal o un símbolo del sistema, ingresa lo siguiente:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

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

Deberías ver un resultado similar a este:

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.

Solicita un ID de cliente de OAuth 2.0 en la Consola de API de Google

Sigue estos pasos a fin de crear o modificar un proyecto para tu app en la Consola de API de Google, habilitar la API de Fitness y solicitar un ID de cliente de OAuth 2.0.

Si deseas obtener orientación en el proceso y activar la API de Fitness automáticamente, haz clic en

Obtén un ID de cliente

También puedes seguir estos pasos para habilitar la API de Fitness en la Consola de API de Google y obtener un ID de cliente de OAuth 2.0.

  1. Ve a la Consola de API de Google.
  2. Selecciona un proyecto o crea uno nuevo. Usa el mismo proyecto para las versiones de Android y REST de la app.
  3. Haz clic en Continuar para habilitar la API de Fitness.
  4. Haz clic en Ir a Credenciales.
  5. Haz clic en Credenciales nuevas y, luego, selecciona ID de cliente de OAuth.
  6. En Tipo de aplicación, selecciona Android.
  7. En el diálogo que aparece, ingresa la huella digital SHA-1 y el nombre del paquete de tu aplicación. Por ejemplo:

    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

    com.example.android.fit-example

  8. Haz clic en Crear. Tu ID y secreto de cliente de OAuth 2.0 para Android aparecen en la lista de ID de tu proyecto. Un ID de cliente de OAuth 2.0 es una string de caracteres, similar a la siguiente:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com