Avant de commencer (v4beta1)

Présentation

Avant de commencer à utiliser Cloud Talent Solution (CTS), vous devez activer l'API dans la console Google Cloud Platform (GCP). Les étapes ci-dessous vous guident à travers les actions suivantes :

  • activer CTS sur un projet GCP ;
    1. Vérifiez que la facturation est activée pour CTS.
    2. Acceptez les conditions d'utilisation de la journalisation des données.
    3. Créez et/ou attribuez un ou plusieurs comptes de service à Cloud Talent Solution.
    4. Téléchargez une clé d'identifiants de compte de service.
  • Définissez la variable d'environnement d'authentification.

Configuration de la console GCP

  1. Accédez à la console GCP. Accédez au menu déroulant en haut de la page, puis sélectionnez le projet GCP que vous souhaitez associer à Cloud Talent Solution. Si vous avez déjà créé un ou plusieurs projets, ils s'affichent sous forme de liste dans le menu contextuel. Vous pouvez choisir un projet préexistant (une coche apparaît à côté du projet sélectionné) ou créer un projet en cliquant sur NEW PROJECT (Nouveau projet). Pour plus de détails sur la création d'un projet GCP, consultez la documentation.

  2. Si vous créez un nouveau projet, vous serez invité à y associer un compte de facturation. Si vous utilisez un projet préexistant, assurez-vous que la facturation est activée. Vous pouvez accéder à tout moment aux informations de facturation du projet en accédant au menu de navigation principal (l'icône hamburger en haut à gauche) et en cliquant sur l'option Billing (Facturation) :

  3. Une fois que vous avez sélectionné un projet GCP et que vous l'avez associé à un compte de facturation, vous pouvez activer l'API Cloud Talent Solution. Accédez au menu de navigation principal et faites défiler jusqu'à la section Intelligence artificielle. Cliquez sur Talent Solution, puis sur Overview (Présentation) dans le menu qui s'affiche :

  4. Si vous souhaitez d'abord essayer l'API sans l'associer à votre projet, sélectionnez l'option TRY THIS API (Essayer cette API). Reportez-vous à la documentation sur l'explorateur d'API Job Search pour plus d'informations sur l'utilisation de cette fonctionnalité. Pour activer l'API Cloud Talent Solution à utiliser avec votre projet GCP, cliquez sur ENABLE (Activer) :

  5. La page de journalisation des données s'affiche. Vous devez accepter les conditions d'utilisation pour bénéficier d'un accès complet aux fonctionnalités de CTS. Si vous choisissez de ne pas accepter ces conditions, vous ne pourrez utiliser que les requêtes d'API de suppression. Cliquez sur ENABLE (Activer) :

  6. Vous êtes maintenant invité à associer un ou plusieurs comptes de service à l'API CTS. Si vous utilisez un projet auquel sont déjà associés des comptes de service, ils s'affichent sous forme de liste sur cette page. Cliquez sur CONNECT (Associer) à côté du ou des comptes que vous souhaitez associer à l'API CTS. Une fois cette action effectuée, vous pouvez passer à l'étape 8 pour vérifier que vous avez téléchargé un fichier d'identifiants au format JSON ou P12 pour ce compte.

    Si votre projet ne dispose pas encore de comptes de service, vous êtes invité à en créer un. Saisissez le nom de votre choix dans la zone Service account name (Nom du compte de service). Votre saisie est automatiquement renseignée dans la zone Service account ID (ID de compte de service). La zone Service account description (Description du compte de service) est facultative mais recommandée si vous prévoyez d'associer plusieurs comptes de service à votre projet. Saisissez une brève description du compte de service dans cette zone, puis cliquez sur CREATE (Créer).

  7. La page suivante vous permet d'attribuer un rôle à votre nouveau compte de service. Consultez la page CTS Autorisations IAM pour plus de détails sur les rôles disponibles et les autorisations accordées à chacun. Cliquez sur le menu déroulant Sélectionnez un rôle et faites défiler jusqu'à Cloud Talent Solution. Sélectionnez un rôle pour ce compte de service parmi les options de la colonne de droite :

  8. Sur la page suivante, vous avez la possibilité d'effectuer plusieurs tâches. Ces tâches ne sont pas obligatoires, mais fortement recommandées. Vous pouvez accorder à des utilisateurs individuels l'accès au compte de service que vous venez de créer en saisissant leur adresse e-mail. Vous pouvez également créer une clé privée pour le compte de service. Vous devez utiliser une clé privée lors du processus d'authentification lorsque vous utilisez l'API. Si vous choisissez de ne pas effectuer ces actions maintenant, vous pouvez générer une clé et ajouter/modifier des informations utilisateur individuelles à tout moment en accédant au compte de service via l'option IAM dans le menu de navigation principal.

    Cliquez sur CREATE KEY (Créer une clé).

    Sélectionnez votre format préféré dans le menu contextuel, cliquez sur CREATE (Créer) :

    Un nouveau fichier d'informations d'identifiants JSON ou P12 est automatiquement téléchargé. Stockez ce fichier dans un emplacement spécifique et notez le chemin d'accès au fichier. Vous devez faire pointer la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS vers ce fichier lorsque vous effectuez le processus d'authentification. Il s'agit d'une étape essentielle pour authentifier les requêtes dans Cloud Talent Solution.

    Une fois votre fichier d'informations d'identifiants téléchargé, cliquez sur DONE (Terminé) :

  9. Votre compte de service apparaît maintenant sur la page Connect service accounts (Associer les comptes de service). Cliquez sur CONNECT pour l'associer à l'API CTS :

  10. Le compte est maintenant associé. Vous êtes prêt à commencer l'intégration de Cloud Talent Solution dans votre système :

Définir la variable d'environnement d'authentification

Fournissez des identifiants d'authentification au code de votre application en définissant la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS. Cette variable ne s'applique qu'à la session de shell actuelle. Si vous souhaitez que la variable s'applique aux futures sessions de shell, définissez-la dans le fichier de démarrage du shell, par exemple dans le fichier ~/.bashrc ou ~/.profile.

Linux ou macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Remplacez KEY_PATH par le chemin d'accès du fichier JSON contenant vos identifiants.

Par exemple :

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

Pour PowerShell :

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Remplacez KEY_PATH par le chemin d'accès du fichier JSON contenant vos identifiants.

Par exemple :

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

Pour l'invite de commande :

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Remplacez KEY_PATH par le chemin d'accès du fichier JSON contenant vos identifiants.

Pour en savoir plus, consultez la documentation sur l'authentification dans GCP.

Étapes suivantes

Installez une bibliothèque cliente ou consultez le guide de démarrage rapide de création d'offres d'emploi et d'entreprises pour commencer à effectuer des appels d'API.