Guide de démarrage rapide : Premiers pas avec l'API Developer Knowledge

Ce guide vous explique comment utiliser l'API Developer Knowledge. Vous découvrirez comment activer l'API Developer Knowledge, obtenir une clé API et effectuer vos premiers appels d'API pour rechercher et récupérer de la documentation pour les développeurs.

Avant de commencer

Avant de commencer à utiliser l'API Developer Knowledge, assurez-vous de suivre les étapes ci-dessous.

Activer l'API

  1. Ouvrez la page de l'API Developer Knowledge dans la bibliothèque des API Google.
  2. Vérifiez que le projet dans lequel vous comptez utiliser l'API est bien sélectionné.
  3. Cliquez sur Activer. Aucun rôle IAM spécifique n'est requis pour activer ou utiliser l' API.

Créer et sécuriser la clé API

  1. Dans la console Google Cloud du projet dans lequel vous avez activé l'API, accédez à la page Identifiants.
  2. Cliquez sur Créer des identifiants, puis sélectionnez Clé API dans le menu.
  3. Dans le champ Nom, saisissez un nom pour la clé.

  4. Cliquez sur le menu déroulant Sélectionner des restrictions d'API, puis saisissez API Developer Knowledge. Cliquez sur le résultat, puis sur OK.

    Remarques :

    • Si vous venez d'activer l'API Developer Knowledge, il est possible qu'elle n'apparaisse pas immédiatement dans la liste. Patientez quelques minutes, puis réessayez.
    • Si vous prévoyez d'utiliser la même clé pour les appels de modèle généraux de votre client d'IA (par exemple, GEMINI_API_KEY), vous devez également sélectionner API Generative Language. Sinon, ces appels seront bloqués.
  5. Cliquez sur Créer.

Générer des réponses à partir de la documentation

Une fois que vous disposez de votre clé API Developer Knowledge, vous pouvez commencer à utiliser l'API. L'exemple suivant montre comment poser une question et générer une réponse à partir de la documentation :

  1. Enregistrez votre clé API Developer Knowledge dans une variable d'environnement :

    export DEVELOPERKNOWLEDGE_API_KEY="YOUR_API_KEY"

    Remplacez YOUR_API_KEY par la clé API que vous avez générée.

  2. Utilisez curl pour appeler le point de terminaison AnswerQuery :

    curl -X POST "https://developerknowledge.googleapis.com/v1:answerQuery?key=$DEVELOPERKNOWLEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I create a BigQuery dataset?"}'

Cette commande renvoie une réponse à votre requête basée sur la documentation.

Rechercher des blocs de documents

Si vous souhaitez trouver des extraits de documentation spécifiques plutôt qu'une réponse générée, vous pouvez rechercher directement des blocs de documents.

Utilisez curl pour appeler le point de terminaison SearchDocumentChunks :

curl "https://developerknowledge.googleapis.com/v1/documents:searchDocumentChunks?query=BigQuery&key=$DEVELOPERKNOWLEDGE_API_KEY"

La réponse inclut des blocs de contenu correspondants de la documentation et des références aux documents parents.

Récupérer un document

La réponse de searchDocumentChunks contient une liste de blocs de documents. Chaque bloc de document comporte un champ parent contenant le nom de ressource du document, que vous pouvez utiliser avec GetDocument pour récupérer l'intégralité du contenu du document.

Pour récupérer un document, copiez le champ parent de l'un des blocs renvoyés par searchDocumentChunks, enregistrez-le dans une variable d'environnement, puis utilisez curl pour appeler le point de terminaison GetDocument :

export DOC_NAME="PARENT_FIELD_FROM_SEARCH"

curl "https://developerknowledge.googleapis.com/v1/$DOC_NAME?key=$DEVELOPERKNOWLEDGE_API_KEY"

Cette commande renvoie l'intégralité du contenu Markdown du document spécifié.

Étape suivante