Cette page explique comment utiliser des clés API pour accéder aux API Google Cloud et aux services qui acceptent les clés API.
Toutes les API Google Cloud n'acceptent pas les clés API pour autoriser l'utilisation. Consultez la documentation concernant le service ou l'API que vous souhaitez utiliser pour déterminer s'il accepte les clés API.
Pour en savoir plus sur la création et la gestion des clés API, y compris sur la restriction des clés API, consultez Gérer les clés API.
Pour en savoir plus sur l'utilisation des clés API avec Google Maps Platform, consultez la documentation de Google Maps Platform. Pour plus d'informations sur l'API API Keys, consultez la documentation de l'API API Keys.Avant de commencer
Select the tab for how you plan to use the samples on this page:
C#
Pour utiliser les exemples .NET de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez les Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
-
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.
Pour en savoir plus, consultez Configurer les ADC pour un environnement de développement local dans la documentation sur l'authentification Google Cloud .
C++
Pour utiliser les exemples C++ de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez les Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
-
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.
Pour en savoir plus, consultez Configurer les ADC pour un environnement de développement local dans la documentation sur l'authentification Google Cloud .
Go
Pour utiliser les exemples Go de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez les Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
-
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.
Pour en savoir plus, consultez Configurer les ADC pour un environnement de développement local dans la documentation sur l'authentification Google Cloud .
Node.js
Pour utiliser les exemples Node.js de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez les Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
-
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.
Pour en savoir plus, consultez Configurer les ADC pour un environnement de développement local dans la documentation sur l'authentification Google Cloud .
Python
Pour utiliser les exemples Python de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez les Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
-
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.
Pour en savoir plus, consultez Configurer les ADC pour un environnement de développement local dans la documentation sur l'authentification Google Cloud .
REST
Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.
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.
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .
Utiliser une clé API avec REST
Pour inclure une clé API dans un appel d'API REST, utilisez l'en-tête HTTP x-goog-api-key
, comme illustré dans l'exemple suivant :
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 vous ne pouvez pas utiliser l'en-tête HTTP, vous pouvez utiliser le paramètre de requête key
.
Toutefois, cette méthode inclut votre clé API dans l'URL, ce qui l'expose au vol par le biais d'analyses d'URL.
L'exemple suivant montre comment utiliser le paramètre de requête key
avec une requête API Cloud Natural Language pour documents.analyzeEntities
.
Remplacez API_KEY
par la chaîne de votre clé API.
POST https://language.googleapis.com/v1/documents:analyzeEntities?key=API_KEY
Utiliser une clé API avec des bibliothèques clientes
Cet exemple utilise l'API Cloud Natural Language, qui accepte les clés API, afin de vous montrer comment fournir une clé API à la bibliothèque.
C#
Pour exécuter cet exemple, vous devez installer la bibliothèque cliente Natural Language.
C++
Pour exécuter cet exemple, vous devez installer la bibliothèque cliente Natural Language.
Go
Pour exécuter cet exemple, vous devez installer la bibliothèque cliente Natural Language.
Node.js
Pour exécuter cet exemple, vous devez installer la bibliothèque cliente Natural Language.
Python
Pour exécuter cet exemple, vous devez installer la bibliothèque cliente Natural Language.
Lorsque vous utilisez des clés API dans vos applications, assurez-vous qu'elles sont protégées lors du stockage et de la transmission. L'exposition publique de vos clés API peut entraîner des frais inattendus. Pour en savoir plus, consultez la section Bonnes pratiques pour gérer les clés API.
Étape suivante
- Consultez la présentation des méthodes d'authentification.
- Apprenez-en plus sur l'API "API Keys".