Crear credenciales de acceso

Las credenciales se usan para obtener un token de acceso de los servidores de autorización de Google, de modo 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 usan 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 requeridas dependen del tipo de datos, la plataforma y la metodología de acceso de tu app. Hay tres tipos de credenciales disponibles:

Caso de uso	Método de autenticación	Acerca de este método de autenticación
Acceder de forma anónima a los datos disponibles públicamente en tu app	Claves de API	Verifica que la API que quieras usar admita claves de API antes de usar este método de autenticación.
Acceder a datos del usuario, como su dirección de correo electrónico o edad	ID de cliente de OAuth	Requiere que tu app solicite y reciba el consentimiento del usuario.
Acceder 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 a través de 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 tiene acceso la cuenta de servicio.

Nota: Para obtener orientación sobre cómo elegir una credencial, consulta Cómo elegir el método de autenticación adecuado para tu caso de uso en la consola de Google Cloud o usa la opción Ayúdame a elegir en la consola de Google Cloud.

Credenciales de la clave de API

Una clave de API es una cadena 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 datos disponibles públicamente, como los archivos de Google Workspace que se comparten con el parámetro de configuración de uso compartido "Cualquier persona en Internet con este vínculo". Para obtener más detalles, consulta Usa claves de API.

Para crear una clave de API, sigue estos pasos:

1. En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.

   Ir a Credenciales

2. Haz clic en Crear credenciales > Clave de API.
3. Se mostrará tu nueva clave de API.
   • Haz clic en Copiar para copiar tu clave de API y usarla en el código de tu app. La clave de API también se puede encontrar en la sección "Claves de API" de las credenciales de tu proyecto.
   • Para evitar el uso no autorizado, te recomendamos restringir dónde y para qué APIs se puede usar la clave de API. Para obtener más detalles, consulta Agrega restricciones de API.

Credenciales de ID de cliente de OAuth

Para autenticar a los usuarios finales 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 tu app se ejecuta en varias plataformas, debes crear un ID de cliente independiente para cada una.

Elige tu tipo de aplicación para obtener instrucciones específicas sobre cómo crear un ID de cliente de OAuth:

Aplicación web

1. En la consola de Google Cloud, ve a Menú > > Clientes.

   Ir a Clientes

2. Haz clic en Crear cliente.
3. Haz clic en Tipo de aplicación > Aplicación web.
4. En el campo Nombre, escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
5. Agrega los 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 usarlo en las solicitudes del navegador. Identifica los dominios desde los que tu aplicación puede enviar solicitudes a la API del servidor de OAuth 2.0.
   • Apps del servidor (Java, Python y más): En URIs de redireccionamiento autorizados, haz clic en Agregar URI. Luego, ingresa un URI de extremo al que el servidor de OAuth 2.0 pueda enviar respuestas.
6. Haz clic en Crear.

   La credencial recién creada aparecerá en IDs de cliente de OAuth 2.0.

   Toma nota del ID de cliente. Los secretos de cliente no se usan para las aplicaciones web.

Android

1. En la consola de Google Cloud, ve a Menú > > Clientes.

   Ir a Clientes

2. Haz clic en Crear cliente.
3. Haz clic en Tipo de aplicación > Android.
4. En el campo "Nombre", ingresa un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
5. En el campo "Nombre del paquete", ingresa el nombre del paquete de tu archivo AndroidManifest.xml.
6. En el campo "Huella digital del certificado SHA-1", ingresa la huella digital del certificado SHA-1 que generaste.
7. Haz clic en Crear.

   La credencial recién creada aparecerá en "IDs de cliente de OAuth 2.0".

iOS

1. En la consola de Google Cloud, ve a Menú > > Clientes.

   Ir a Clientes

2. Haz clic en Crear cliente.
3. Haz clic en Tipo de aplicación > iOS.
4. En el campo "Nombre", ingresa un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
5. En el campo "ID del paquete", ingresa el identificador de paquete que aparece en el archivo Info.plist de la app.
6. Opcional: Si tu app aparece en la App Store de Apple, ingresa el ID de la App Store.
7. Opcional: En el campo "ID del equipo", ingresa la cadena única de 10 caracteres que genera Apple y se asigna a tu equipo.
8. Haz clic en Crear.

   La credencial recién creada aparecerá en "IDs de cliente de OAuth 2.0".

Extensión de Chrome

1. En la consola de Google Cloud, ve a Menú > > Clientes.

   Ir a Clientes

2. Haz clic en Crear cliente.
3. Haz clic en Tipo de aplicación > Extensión de Chrome.
4. En el campo "Nombre", ingresa un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
5. En el campo "ID del elemento", ingresa la cadena de ID única 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.
6. Haz clic en Crear.

   La credencial recién creada aparecerá en "IDs de cliente de OAuth 2.0".

App de escritorio

1. En la consola de Google Cloud, ve a Menú > > Clientes.

   Ir a Clientes

2. Haz clic en Crear cliente.
3. Haz clic en Tipo de aplicación > App para computadoras.
4. En el campo Nombre, escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
5. Haz clic en Crear.

   La credencial recién creada aparecerá en "IDs de cliente de OAuth 2.0".

TVs y dispositivos de entrada limitada

1. En la consola de Google Cloud, ve a Menú > > Clientes.

   Ir a Clientes

2. Haz clic en Crear cliente.
3. Haz clic en Tipo de aplicación > TVs y dispositivos de entrada limitada.
4. En el campo "Nombre", ingresa un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
5. Haz clic en Crear.

   La credencial recién creada aparecerá en "IDs de cliente de OAuth 2.0".

Plataforma universal de Windows (UWP)

1. En la consola de Google Cloud, ve a Menú > > Clientes.

   Ir a Clientes

2. Haz clic en Crear cliente.
3. Haz clic en Tipo de aplicación > Plataforma universal de Windows (UWP).
4. En el campo "Nombre", ingresa un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
5. En el campo "ID de la tienda", ingresa el valor único de 12 caracteres del ID de Microsoft Store de tu app. Puedes encontrar este ID en la URL de Microsoft Store de tu app y en el Centro de socios.
6. Haz clic en Crear.

   La credencial recién creada aparecerá en "IDs de cliente de 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 los datos o realizar acciones con la cuenta de robot, o bien para acceder a los datos en nombre de los usuarios de Google Workspace o Cloud Identity. Para obtener más información, consulta Comprende las cuentas de servicio.

Crea una cuenta de servicio

Consola de Google Cloud

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Cuentas de servicio.

   Ir a Cuentas de servicio

2. Haga clic en Crear cuenta de servicio.
3. Completa los detalles de la cuenta de servicio y, luego, haz clic en Crear y continuar.
   Nota: De forma predeterminada, Google crea un ID de cuenta de servicio único. Si quieres cambiar el ID, modifícalo en el campo ID de cuenta de servicio.
4. 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 Otorga, cambia y revoca el acceso a los recursos.
5. Haz clic en Continuar.
6. Opcional: Ingresa los usuarios o grupos que pueden 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.
7. Haz clic en Listo. Toma nota de la dirección de correo electrónico de la cuenta de servicio.

gcloud CLI

1. Crea la cuenta de servicio:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. 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 Otorga, cambia y revoca el acceso a los recursos.

Asigna un rol a una cuenta de servicio

Una cuenta de superadministrador debe asignar un rol prediseñado o personalizado a una cuenta de servicio.

1. En la Consola del administrador de Google, ve a Menú > Cuenta > Roles de administrador.

   Ir a Roles de administrador

2. Coloca el cursor sobre el rol que deseas asignar y, luego, haz clic en Asignar administrador.

3. Haz clic en Asignar cuentas de servicio.

4. Ingresa la dirección de correo electrónico de la cuenta de servicio.

5. 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. Tu código usa estas credenciales para autorizar las acciones de la cuenta de servicio dentro de tu app.

Para obtener credenciales para tu cuenta de servicio, sigue estos pasos:

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Cuentas de servicio.

   Ir a Cuentas de servicio

2. Selecciona tu cuenta de servicio.
3. Haz clic en Claves > Agregar clave > Crear clave nueva.
4. Selecciona JSON y, luego, haz clic en Crear.

   Se generará y descargará el nuevo par de claves pública/privada en tu equipo 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 información sobre cómo almacenar tu clave de forma segura, consulta Cómo administrar claves para cuentas de servicio.

5. 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 en todo el dominio en la Consola del administrador de Google Workspace. Para obtener más información, consulta Delegación de autoridad en todo tu dominio a una cuenta de servicio.

Para configurar la delegación de autoridad en todo el dominio para una cuenta de servicio, sigue estos pasos:

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Cuentas de servicio.

   Ir a Cuentas de servicio

2. Selecciona tu cuenta de servicio.
3. Haz clic en Mostrar configuración avanzada.
4. En “Delegación en 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 el portapapeles.

5. Si tienes acceso de administrador avanzado a la cuenta de Google Workspace pertinente, 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 correspondiente, comunícate con un administrador avanzado de esa cuenta y envíale el ID de cliente y la lista de permisos de OAuth de tu cuenta de servicio para que pueda completar los siguientes pasos en la Consola del administrador.

1. En la Consola del administrador de Google, ve a Menú > Seguridad > Control de acceso y datos > Controles de API.

   Ir a Controles de API

2. Haz clic en Administrar la delegación de todo el dominio.
3. Haz clic en Agregar nueva.
4. En el campo "ID de cliente", pega el ID de cliente que copiaste anteriormente.
5. En el campo "Permisos de OAuth", ingresa una lista delimitada por comas de los permisos que requiere tu aplicación. Este es el mismo conjunto de permisos que definiste cuando configuraste la pantalla de consentimiento de OAuth.
6. Haz clic en Autorizar.

Próximo paso

Ya puedes desarrollar en Google Workspace. Revisa la lista de productos para desarrolladores de Google Workspace y cómo obtener ayuda.