Obtén un ID de cliente de OAuth 2.0

Descripción general

Para usar Google Fit para Android, necesitas un ID de cliente de OAuth 2.0 para las aplicaciones para Android.

Todas las aplicaciones para Android están firmadas con un certificado digital del cual posees la privada. Para obtener más información sobre los certificados digitales, consulta la guía de Android para firmar tus aplicaciones.

Los IDs de cliente de OAuth de Android están vinculados a pares de paquetes y certificados específicos. Tú solo necesitas un ID para cada certificado, independientemente de la cantidad de usuarios que tengas para la aplicación.

Obtener un ID para tu app implica completar varios pasos. Estos pasos se describen a continuación.

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

Busca información sobre el certificado de tu app

La clave de API se basa en una forma abreviada del certificado digital de tu app. conocido como huella digital SHA-1. Para mostrar la huella digital SHA-1 de 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 APIs de Google

Sigue estos pasos para crear o modificar un proyecto para tu app en la Consola de API de Google, habilita la API de Fitness y solicita 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 Fitness API en la Consola de APIs de Google y obtén 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 tu app.
  3. Haz clic en Continuar para habilitar la API de Fitness.
  4. Haz clic en Ir a Credenciales.
  5. Haz clic en Nuevas credenciales y, luego, selecciona ID de cliente de OAuth.
  6. En Tipo de aplicación, selecciona Android.

  7. En el cuadro de diálogo que se muestra a continuación, escribe la huella digital SHA-1 y el nombre del paquete de tu app. 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 nuevo ID de cliente y secreto de OAuth 2.0 de Android aparecen en la lista de IDs de tu proyecto. Un ID de cliente de OAuth 2.0 es una cadena de caracteres, como la siguiente:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com