Gérer les bibliothèques et les API Cloud

Vous pouvez accéder aux produits et services Google Cloud Platform à partir de votre code à l'aide des API Cloud. Les API Cloud présentent une interface JSON REST simple que vous pouvez appeler via des bibliothèques clientes.

Ce document explique comment activer les API Cloud, gérer les comptes de service et les variables d'environnement pour accéder aux API localement, et ajouter des bibliothèques clientes Cloud pour Java à votre projet Maven.

Avant de commencer

Suivez le guide de démarrage rapide pour installer et configurer IntelliJ IDEA.

Ajouter des bibliothèques clientes Google Cloud

Pour ajouter des bibliothèques à votre projet dans IntelliJ :

Pour les projets Maven

  1. Sélectionnez Tools > Google Cloud Tools > Add Cloud libraries and Manage Cloud APIs (Outils > Outils Google Cloud > Ajouter des bibliothèques Cloud et gérer des API Cloud).
  2. La boîte de dialogue Add Google Cloud Libraries (Ajouter des bibliothèques Google Cloud) affiche les bibliothèques prises en charge.

    Capture d'écran illustrant la boîte de dialogue d'ajout de bibliothèques Google Cloud. Cette boîte de dialogue propose un menu déroulant permettant de sélectionner le module auquel ajouter les bibliothèques, affiche la liste des API disponibles pouvant être ajoutées et fournit un espace de travail contenant des informations sur les API sélectionnées.
  3. Dans le champ GCP Project (Projet GCP), vérifiez que le bon projet et le bon compte sont affichés. Si ce n'est pas le cas, cliquez sur les points de suspension pour choisir le bon projet et le bon compte.
  4. Dans le menu déroulant Add Google Client Library to Module (Ajouter une bibliothèque cliente Google au module), sélectionnez le module auquel vous souhaitez ajouter la bibliothèque.
  5. Dans le menu déroulant Google Cloud Java (Java Google Cloud), sélectionnez la version du BOM Java Google Cloud que vous souhaitez utiliser.
  6. Java Google Cloud résout les conflits de version entre les bibliothèques en ajoutant la nomenclature BOM Java Google Cloud au fichier pom.xml de vos projets.

  7. Cochez la case correspondant à chaque bibliothèque à ajouter.
  8. Cliquez sur Continue (Continuer).
  9. La boîte de dialogue Enable GCP APIs and Manage Service Accounts Confirmation (Confirmation de l'activation des API GCP et de la gestion des comptes de service) s’affiche.

    Capture d'écran illustrant la boîte de dialogue de confirmation permettant d'ajouter des rôles à un nouveau compte de service et de saisir le chemin d'accès au téléchargement de la clé. La boîte de dialogue affiche également les API qui seront ajoutées au projet.
  10. Dans le champ Service account name (Nom du compte de service), conservez le nom par défaut ou entrez-en un nouveau.
  11. Dans le champ Download path (Chemin d'accès au téléchargement), accédez à l'emplacement où vous souhaitez télécharger la clé du compte de service.
  12. Si votre API le requiert, sélectionnez les rôles que vous souhaitez ajouter au compte de service.
  13. Cliquez sur "OK".
  14. Capture d'écran confirmant la création du compte de service et indiquant le chemin d'accès à la clé.

    IntelliJ effectue les mises à jour suivantes :

    • ajout des dépendances sélectionnées à votre fichier pom.xml ;
    • activation des API sélectionnées sur Google Cloud Platform ;
    • création du compte de service et téléchargement de sa clé à l'emplacement spécifié.
  15. Pour accéder aux API Google Cloud localement, définissez les variables d'environnement GOOGLE_APPLICATION_CREDENTIALS et GOOGLE_CLOUD_PROJECT sur votre serveur de développement local ou sur l'une de vos configurations d'exécution locales :
    1. Cliquez sur l'icône Copier pour copier les variables dans votre presse-papiers.
    2. Modifiez votre configuration d'exécution.
    3. Dans la section Environment Variables (Variables d'environnement), cliquez sur l'icône Coller.
    4. Pour le serveur d'applications local, cette section apparaît sous l'onglet Startup/Connection (Démarrage/Connexion).

    5. Les variables d'environnement sont automatiquement insérées pour vous.

Pour les projets non-Maven

  1. Sélectionnez Tools > Google Cloud Tools > Manage Cloud APIs (Outils > Outils Google Cloud > Gérer des API Cloud).
  2. La boîte de dialogue Manage Google Cloud API (Gérer des API Google Cloud) affiche les bibliothèques prises en charge.

    Capture d'écran illustrant la boîte de dialogue d'ajout de bibliothèques Google Cloud. Cette boîte de dialogue affiche la liste des API disponibles pouvant être ajoutées et fournit un espace de travail qui affiche des informations sur les API sélectionnées.
  3. Dans le champ GCP Project (Projet GCP), vérifiez que le bon projet et le bon compte sont affichés. Si ce n'est pas le cas, cliquez sur les points de suspension pour choisir le bon projet et le bon compte.
  4. Cochez la case correspondant à chaque bibliothèque à ajouter.
  5. Cliquez sur Continue (Continuer).
  6. La boîte de dialogue Enable GCP APIs and Manage Service Accounts Confirmation (Confirmation de l'activation des API GCP et de la gestion des comptes de service) s’affiche.

    Capture d'écran illustrant la boîte de dialogue de confirmation permettant d'ajouter des rôles à un nouveau compte de service et de saisir le chemin d'accès au téléchargement de la clé. La boîte de dialogue affiche également les API qui seront ajoutées au projet.
  7. Dans le champ Service account name (Nom du compte de service), conservez le nom par défaut ou entrez-en un nouveau.
  8. Dans le champ Download path (Chemin d'accès au téléchargement), accédez à l'emplacement où vous souhaitez télécharger la clé du compte de service.
  9. Si votre API le requiert, sélectionnez les rôles que vous souhaitez ajouter au compte de service.
  10. Cliquez sur "OK".
  11. Capture d'écran confirmant la création du compte de service et indiquant le chemin d'accès à la clé.

    IntelliJ effectue les mises à jour suivantes :

    • activation des API sélectionnées sur Google Cloud Platform ;
    • création du compte de service et téléchargement de sa clé à l'emplacement spécifié.
  12. Pour accéder aux API Google Cloud localement, définissez les variables d'environnement GOOGLE_APPLICATION_CREDENTIALS et GOOGLE_CLOUD_PROJECT sur votre serveur de développement local ou sur l'une de vos configurations d'exécution locales :
    1. Cliquez sur l'icône Copier pour copier les variables dans votre presse-papiers.
    2. Modifiez votre configuration d'exécution.
    3. Dans la section Environment Variables (Variables d'environnement), cliquez sur l'icône Coller.
    4. Pour le serveur d'applications local, cette section apparaît sous l'onglet Startup/Connection (Démarrage/Connexion).

    5. Les variables d'environnement sont automatiquement insérées pour vous.

Étape suivante

  • Explorez le code du plug-in, signalez les problèmes sur GitHub, ou posez une question sur Stack Overflow.
Cette page vous a-t-elle été utile ? Évaluez-la :