En esta página se describe cómo usar claves de API para acceder a APIs y servicios de Google Cloud que aceptan claves de API.
No todas las APIs Google Cloud aceptan claves de API para autorizar el uso. Consulta la documentación del servicio o la API que quieras usar para determinar si acepta claves de API.
Para obtener información sobre cómo crear y gestionar claves de API, incluidas las restricciones de claves de API, consulta el artículo Gestionar claves de API.
Para obtener información sobre cómo usar claves de API con Google Maps Platform, consulta la documentación de Google Maps Platform. Para obtener más información sobre la API Keys, consulta la documentación de la API Keys.Antes de empezar
Select the tab for how you plan to use the samples on this page:
C#
Para usar las .NET muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .
C++
Para usar las C++ muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .
Go
Para usar las Go muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .
Node.js
Para usar las Node.js muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .
Python
Para usar las Python muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .
REST
Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.
Install the Google Cloud CLI.
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .
Usar una clave de API con REST
Para incluir una clave de API en una llamada a la API REST, usa el encabezado HTTP x-goog-api-key
, como se muestra en el siguiente ejemplo:
curl -X POST \ -H "X-goog-api-key: API_KEY" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://translation.googleapis.com/language/translate/v2"
Si no puede usar el encabezado HTTP, puede usar el parámetro de consulta key
.
Sin embargo, este método incluye tu clave de API en la URL, lo que la expone a robos mediante análisis de URLs.
En el siguiente ejemplo se muestra cómo usar el parámetro de consulta key
con una solicitud de la API Cloud Natural Language para documents.analyzeEntities
.
Sustituye API_KEY
por la cadena de clave de tu clave de API.
POST https://language.googleapis.com/v1/documents:analyzeEntities?key=API_KEY
Usar una clave de API con bibliotecas de cliente
En este ejemplo se usa la API Cloud Natural Language, que acepta claves de API, para mostrar cómo se proporciona una clave de API a la biblioteca.
C#
Para ejecutar este ejemplo, debes instalar la biblioteca de cliente de Natural Language.
C++
Para ejecutar este ejemplo, debes instalar la biblioteca de cliente de Natural Language.
Go
Para ejecutar este ejemplo, debes instalar la biblioteca de cliente de Natural Language.
Node.js
Para ejecutar este ejemplo, debes instalar la biblioteca de cliente de Natural Language.
Python
Para ejecutar este ejemplo, debes instalar la biblioteca de cliente de Natural Language.
Ruby
Para ejecutar este ejemplo, debes instalar la biblioteca de cliente de Natural Language.
Cuando uses claves de API en tus aplicaciones, asegúrate de que se mantengan protegidas tanto durante el almacenamiento como durante la transmisión. Si expones públicamente tus claves de API, es posible que se apliquen cargos inesperados a tu cuenta. Para obtener más información, consulta las prácticas recomendadas para gestionar las claves de API.
Siguientes pasos
- Consulta una descripción general de los métodos de autenticación.
- Consulta más información sobre la API Keys.
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-12 (UTC).