Premiers pas

Cette page explique aux développeurs comment commencer à utiliser les API Google Cloud.

Créer un compte Google

Pour utiliser les API Google Cloud dans vos applications, vous devez d'abord disposer d'un compte Google. Il permet d'utiliser les produits Google pour les développeurs, y compris Google Cloud Console, le SDK Cloud, Cloud Logging et Cloud Monitoring. Si vous ne possédez pas de compte Google, vous pouvez vous inscrire ici.

Créer un projet Google

Pour utiliser les API Cloud, vous devez également disposer d'un projet Google. Un projet équivaut à un compte de développeur. Il sert de conteneur pour vos ressources Google Cloud. Il fournit également une limite d'isolation pour votre utilisation des services Google Cloud, vous permettant de gérer les limites de quota et la facturation indépendamment au niveau du projet. La télémétrie et les tableaux de bord concernant l'utilisation sont également regroupés par projet. Si vous n'avez pas encore de projet, vous pouvez en créer un à l'aide de Cloud Console.

Un projet peut posséder un large éventail de ressources, y compris des clés API, des clients OAuth, des comptes de service, des VM Compute Engine, des buckets Cloud Storage et des ensembles de données BigQuery. Lorsqu'une application appelle une API Cloud, le projet qui détient les identifiants de l'application est appelé projet client et le projet qui détient la ressource cible est appelé projet de ressource. Une requête API peut toucher plusieurs ressources, ce qui implique plusieurs projets de ressources.

Si vous souhaitez cesser d'utiliser Google Cloud pour une raison quelconque, vous pouvez supprimer votre projet à l'aide de Cloud Console. Votre projet et toutes les ressources qu'il contient seront supprimés après la durée de conservation. Notez que les différents types de données ont des durées de conservation différentes.

Activation des API…

Pour utiliser une API Cloud, vous devez l'activer pour votre projet. En fonction des services et des projets impliqués dans votre application, y compris le projet client et les projets de ressources, vous devrez peut-être activer une API pour plusieurs projets.

Pour activer une API, vous devez accepter les conditions d'utilisation et la responsabilité de la facturation de cette API. Vous avez besoin de l'autorisation serviceusage.services.enable sur le projet et de l'autorisation servicemanagement.services.bind sur l'API pour l'activer. Pour en savoir plus, consultez la section Contrôle des accès dans la documentation de Service Usage.

Pour activer une API pour un projet à l'aide de la console, procédez comme suit :

  1. Accédez à la bibliothèque d'API Cloud Console.
  2. Dans la liste des projets, sélectionnez celui que vous souhaitez utiliser.
  3. Dans la bibliothèque d'API, sélectionnez l'API que vous souhaitez activer. Si vous avez besoin d'aide pour trouver l'API, utilisez le champ de recherche et/ou les filtres.
  4. Sur la page de l'API, cliquez sur ACTIVER.

Sur cette même page, vous pouvez désactiver une API pour votre projet si vous ne l'utilisez plus afin d'éviter une utilisation abusive et des frais de facturation accidentels. Vous pouvez également activer et désactiver les API Cloud à l'aide du SDK Cloud et de l'API Service Usage.

Activer la facturation

Certaines API Cloud facturent des frais d'utilisation. Vous devez activer la facturation pour votre projet avant de commencer à utiliser ces API dans votre projet. L'utilisation d'une API dans un projet est facturée sur le compte de facturation associé au projet.

Si vous n'avez pas de compte de facturation, accédez à la page Facturation de Cloud Console et suivez les instructions pour en créer un. Ensuite, associez votre compte de facturation à votre projet.

Obtenir des identifiants d'application

Les API Cloud n'acceptent que les requêtes d'API provenant d'applications enregistrées. Cette exigence permet aux producteurs d'API d'associer et de déclarer l'utilisation de l'API au projet approprié propriétaire de l'application.

Les API Cloud utilisent des identifiants d'application pour identifier les applications appelantes. Parmi les types d'identifiants figurent les clés d'API, les clients OAuth 2.0 et les comptes de service. Vous pouvez utiliser Cloud Console pour créer, récupérer et gérer les identifiants de votre application. Pour en savoir plus sur les identifiants d'application, consultez la page Présentation de l'authentification.

Utiliser des identifiants d'application

Si vous débutez avec les API Google Cloud, nous vous recommandons vivement de utiliser oauth2l pour tester vos identifiants d'application et vos API Cloud avant d'écrire le code de l'application. oauth2l peut accepter n'importe quel identifiant d'application et l'utiliser pour appeler les API Google Cloud à l'aide de la commande curl.

Exemple :

oauth2l curl --credentials ./creds.json --scope cloud-platform --url https://pubsub.googleapis.com/v1/projects/my-project-id/topics -- -v

Créer des applications

Si vous créez une application à l'aide des API Cloud, nous vous recommandons d'utiliser les bibliothèques clientes Google Cloud, si elles sont disponibles. Les bibliothèques clientes peuvent gérer les fonctionnalités courantes de l'API pour plus de commodité, telles que l'authentification, le traitement des erreurs, les nouvelles tentatives et la validation de la charge utile. Vous devez transmettre les identifiants de votre application aux bibliothèques clientes lors de l'initialisation, afin que ces dernières puissent appeler les API Google Cloud pour le compte de votre application.

Pour en savoir plus, consultez la section Présentation des bibliothèques clientes.

En savoir plus

Pour plus d'informations sur la facturation, consultez la section Créer, modifier ou fermer votre compte de facturation.

Pour plus d'informations sur l'activation de la facturation sur votre projet, consultez la section Modifier les paramètres de facturation d'un projet.

Pour plus d'informations sur l'activation et la désactivation des API, consultez la section Activer et désactiver des services.