Las credenciales se usan para obtener un token de acceso de los servidores de autorización de Google a fin de que tu app pueda llamar a las APIs de Google Workspace. En esta guía, se describe cómo elegir y configurar las credenciales que necesita tu app.
Para ver las definiciones de los términos que se encuentran en esta página, consulta Descripción general de la autenticación y la autorización.
Elige la credencial de acceso adecuada para ti
Las credenciales obligatorias dependen del tipo de datos, la plataforma y la metodología de acceso de tu app. Existen tres tipos de credenciales disponibles:
Caso de uso | Método de autenticación | Acerca de este método de autenticación |
---|---|---|
Accede a los datos disponibles públicamente en tu app. | Claves de API | Verifica que la API que quieres usar admita claves de API antes de usar este método de autenticación. |
Acceder a los datos del usuario, como su dirección de correo electrónico o edad | ID de cliente de OAuth | Requiere que tu app solicite el consentimiento del usuario y lo solicite. |
Accede a los datos que pertenecen a tu propia aplicación o a los recursos en nombre de los usuarios de Google Workspace o Cloud Identity mediante la delegación de todo el dominio. | Cuenta de servicio | Cuando una app se autentica como una cuenta de servicio, tiene acceso a todos los recursos a los que la cuenta de servicio tiene permiso para acceder. |
Credenciales de la clave de API
Una clave de API es una string larga que contiene letras mayúsculas y minúsculas, números, guiones bajos y guiones, como AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe
.
Este método de autenticación se usa para acceder de forma anónima a los datos disponibles de forma pública, como los archivos de Google Workspace compartidos mediante el parámetro de configuración de uso compartido “Cualquier persona en Internet que tenga este vínculo”. Para obtener más detalles, consulta Cómo usar claves de API.
Para crear una clave de API, sigue estos pasos:
- En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.
- Haz clic en Crear credenciales > Clave de API.
- Aparecerá tu nueva clave de API.
- Haz clic en Copiar para copiar tu clave de API y usarla en el código de tu app. También puedes encontrar la clave de API en la sección "Claves de API" de las credenciales de tu proyecto.
- Haz clic en Restringir clave para actualizar la configuración avanzada y limitar el uso de tu clave de API. Para obtener más detalles, consulta Cómo aplicar restricciones de clave de API.
Credenciales del ID de cliente de OAuth
Para autenticarte como usuario final y acceder a los datos del usuario en tu app, debes crear uno o más IDs de cliente de OAuth 2.0. Un ID de cliente se usa con el fin de identificar una sola app para los servidores de OAuth de Google. Si la app se ejecuta en varias plataformas, debes crear un ID de cliente distinto para cada una.Elige el tipo de aplicación a fin de obtener instrucciones específicas para crear un ID de cliente de OAuth:
Aplicación web
- En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.
- Haz clic en Crear credenciales > ID de cliente de OAuth.
- Haz clic en Tipo de aplicación > Aplicación web.
- En el campo Nombre, escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
- Agrega URIs autorizados relacionados con tu app:
- Apps del cliente (JavaScript): En Orígenes autorizados de JavaScript, haz clic en Agregar URI. Luego, ingresa un URI para usar en las solicitudes del navegador. Identifica los dominios desde los cuales tu aplicación puede enviar solicitudes de API al servidor OAuth 2.0.
- Apps del servidor (Java, Python y mucho más): En URI de redireccionamiento autorizados, haz clic en Agregar URI. Luego, ingresa un URI de extremo al que el servidor OAuth 2.0 pueda enviar respuestas.
- Haz clic en Crear. Aparecerá la pantalla de creación del cliente OAuth que muestra tu ID de cliente nuevo y el secreto de cliente.
Toma nota del ID de cliente. Los secretos del cliente no se usan para las aplicaciones web.
- Haz clic en OK. La credencial creada recientemente aparecerá en ID de cliente de OAuth 2.0.
Android
- En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.
- Haz clic en Crear credenciales > ID de cliente de OAuth.
- Haz clic en Tipo de aplicación > Android.
- En el campo "Nombre", escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
- En el campo "Nombre del paquete", ingresa el nombre del paquete de tu archivo
AndroidManifest.xml
. - En el campo "Huella digital del certificado SHA-1", ingresa la huella digital del certificado SHA-1 generada.
- Haz clic en Crear. Aparecerá la pantalla de creación del cliente OAuth que muestra tu nuevo ID de cliente.
- Haz clic en OK. La credencial creada recientemente aparecerá en "ID de cliente OAuth 2.0".
iOS
- En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.
- Haz clic en Crear credenciales > ID de cliente de OAuth.
- Haz clic en Tipo de aplicación > iOS.
- En el campo "Nombre", escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
- En el campo "ID del paquete", ingresa el identificador del paquete como aparece en el archivo
Info.plist
de la app. - Opcional: Si su aplicación aparece en la App Store de Apple, ingrese el ID de la App Store.
- Opcional: En el campo "ID de equipo", ingresa la cadena única de 10 caracteres, generada por Apple y asignada a tu equipo.
- Haz clic en Crear. Aparecerá la pantalla de creación del cliente OAuth que muestra tu ID de cliente nuevo y el secreto de cliente.
- Haz clic en OK. La credencial creada recientemente aparecerá en "ID de cliente OAuth 2.0".
App de Chrome
- En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.
- Haz clic en Crear credenciales > ID de cliente de OAuth.
- Haz clic en Tipo de aplicación > App de Chrome.
- En el campo "Nombre", escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
- En el campo “ID de aplicación”, ingresa la string del ID único de 32 caracteres de tu app. Puedes encontrar este valor de ID en la URL de Chrome Web Store de tu app y en el Panel del desarrollador de Chrome Web Store.
- Haz clic en Crear. Aparecerá la pantalla de creación del cliente OAuth que muestra tu ID de cliente nuevo y el secreto de cliente.
- Haz clic en OK. La credencial creada recientemente aparecerá en "ID de cliente OAuth 2.0".
App de escritorio
- En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.
- Haz clic en Crear credenciales > ID de cliente de OAuth.
- Haz clic en Tipo de aplicación > Aplicación de escritorio.
- En el campo Nombre, escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
- Haz clic en Crear. Aparecerá la pantalla de creación del cliente OAuth que muestra tu ID de cliente nuevo y el secreto de cliente.
- Haz clic en OK. La credencial creada recientemente aparecerá en ID de cliente de OAuth 2.0.
TVs y dispositivos de entrada limitada
- En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.
- Haz clic en Crear credenciales > ID de cliente de OAuth.
- Haz clic en Tipo de aplicación > TVs y dispositivos de entrada limitada.
- En el campo "Nombre", escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
- Haz clic en Crear. Aparecerá la pantalla de creación del cliente OAuth que muestra tu ID de cliente nuevo y el secreto de cliente.
- Haz clic en OK. La credencial creada recientemente aparecerá en "ID de cliente OAuth 2.0".
Plataforma universal de Windows (UWP)
- En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.
- Haz clic en Crear credenciales > ID de cliente de OAuth.
- Haz clic en Tipo de aplicación > Universal Windows Platform (UWP).
- En el campo "Nombre", escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
- En el campo "ID de tienda", ingresa el valor del ID de Microsoft Store único de 12 caracteres de tu aplicación. Puedes encontrar este ID en la URL de Microsoft Store de tu app y en el Centro de socios.
- Haz clic en Crear. Aparecerá la pantalla de creación del cliente OAuth que muestra tu ID de cliente nuevo y el secreto de cliente.
- Haz clic en OK. La credencial creada recientemente aparecerá en "ID de cliente OAuth 2.0".
Credenciales de cuenta de servicio
Una cuenta de servicio es un tipo especial de cuenta que usa una aplicación, en lugar de una persona. Puedes usar una cuenta de servicio para acceder a datos o realizar acciones mediante la cuenta de robot, o para acceder a datos en nombre de usuarios de Google Workspace o Cloud Identity. Para obtener más información, consulta Comprende las cuentas de servicio.Crea una cuenta de servicio
- En la consola de Google Cloud, ve a Menú > IAM y administración > Cuentas de servicio.
- Haz clic en Crear cuenta de servicio.
- Completa los detalles de la cuenta de servicio y, luego, haz clic en Crear y continuar.
- Opcional: Asigna roles a tu cuenta de servicio para otorgar acceso a los recursos de tu proyecto de Google Cloud. Para obtener más detalles, consulta Cómo otorgar, cambiar y revocar el acceso a los recursos.
- Haz clic en Continuar.
- Opcional: Ingresa los usuarios o grupos que puedan administrar esta cuenta de servicio y realizar acciones con ella. Para obtener más detalles, consulta Administra la suplantación de identidad de cuentas de servicio.
- Haz clic en Listo. Anota la dirección de correo electrónico de la cuenta de servicio.
Asigna un rol a una cuenta de servicio
Debes asignar una función precompilada o personalizada a una cuenta de servicio mediante una cuenta de administrador avanzado.
En la Consola del administrador de Google, ve a Menú > Cuenta > Roles de administrador.
Selecciona el rol que quieres asignar y, luego, haz clic en Asignar administrador.
Haz clic en Asignar cuentas de servicio.
Ingresa la dirección de correo electrónico de la cuenta de servicio.
Haz clic en Agregar > Asignar rol.
Crea credenciales para una cuenta de servicio
Debes obtener credenciales en forma de un par de claves pública/privada. El código usa estas credenciales para autorizar acciones de la cuenta de servicio dentro de la app.A fin de obtener credenciales para tu cuenta de servicio, haz lo siguiente:
- En la consola de Google Cloud, ve a Menú > IAM y administración > Cuentas de servicio.
- Selecciona tu cuenta de servicio.
- Haz clic en Claves > Agregar clave > Crear clave nueva.
- Selecciona JSON y, luego, haz clic en Crear.
Se generará el nuevo par de claves pública/privada y se descargará en tu máquina como un archivo nuevo. Guarda el archivo JSON descargado como
credentials.json
en tu directorio de trabajo. Este archivo es la única copia de esta clave. Para obtener más información sobre cómo almacenar tu clave de forma segura, consulta Cómo administrar claves de cuentas de servicio. - Haz clic en Cerrar.
Opcional: Configura la delegación de todo el dominio para una cuenta de servicio
Para llamar a las APIs en nombre de los usuarios de una organización de Google Workspace, una cuenta de administrador avanzado debe otorgar a tu cuenta de servicio la delegación de autoridad de todo el dominio en la Consola del administrador de Google Workspace. Para obtener más información, consulta Delega la autoridad de todo el dominio a una cuenta de servicio.A fin de configurar la delegación de autoridad de todo el dominio para una cuenta de servicio, haz lo siguiente:
- En la consola de Google Cloud, ve a Menú > IAM y administración > Cuentas de servicio.
- Selecciona tu cuenta de servicio.
- Haz clic en Mostrar configuración avanzada.
- En “Delegación de todo el dominio”, busca el “ID de cliente” de tu cuenta de servicio. Haz clic en Copiar para copiar el valor del ID de cliente en tu portapapeles.
Si tienes acceso de administrador avanzado a la cuenta de Google Workspace relevante, haz clic en Ver la Consola del administrador de Google Workspace, accede con una cuenta de usuario de administrador avanzado y sigue estos pasos.
Si no tienes acceso de administrador avanzado a la cuenta de Google Workspace relevante, comunícate con el administrador avanzado de esa cuenta y envíale el ID de cliente de tu cuenta de servicio y la lista de permisos de OAuth para que pueda completar los siguientes pasos en la Consola del administrador.
- En la Consola del administrador de Google, ve a Menú > Seguridad > Control de acceso y datos > Controles de API.
- Haz clic en Administrar la delegación de todo el dominio.
- Haz clic en Add new (Agregar nuevo).
- En el campo "ID de cliente", pega el ID de cliente que copiaste anteriormente.
- En el campo "Alcances de OAuth", ingresa una lista delimitada por comas de los alcances que requiere tu aplicación. Este es el mismo conjunto de permisos que definiste cuando configuraste la pantalla de consentimiento de OAuth.
- Haz clic en Autorizar.
Próximo paso
Ya está todo listo para que desarrolles en Google Workspace. Revisa la lista de productos para desarrolladores de Google Workspace y cómo encontrar ayuda.