Guida rapida: inizia a utilizzare l'API Developer Knowledge

Questa guida mostra come iniziare a utilizzare l'API Developer Knowledge. Imparerai come abilitare l'API Developer Knowledge, ottenere una chiave API ed effettuare le tue prime chiamate API per cercare e recuperare la documentazione per gli sviluppatori.

Prima di iniziare

Abilita l'API

  1. Apri la pagina dell'API Developer Knowledge nella libreria delle API di Google.
  2. Verifica di aver selezionato il progetto corretto in cui intendi utilizzare l'API.
  3. Fai clic su Abilita. Per abilitare o utilizzare l'API non sono necessari ruoli IAM specifici.

Crea e proteggi la chiave API

  1. Nella console Google Cloud per il progetto in cui hai attivato l'API, vai alla pagina Credenziali.
  2. Fai clic su Crea credenziali e poi seleziona Chiave API dal menu.
  3. Nel campo Nome, fornisci un nome per la chiave.
  4. Fai clic sul menu a discesa Seleziona limitazioni dell'API e poi digita API Developer Knowledge. Fai clic sul risultato, quindi su Ok.
    • Nota: se hai appena attivato l'API Developer Knowledge, potrebbe esserci un ritardo prima che venga visualizzata nell'elenco. Attendi alcuni minuti e riprova.
  5. Fai clic su Crea.

Cercare blocchi di documenti

Una volta ottenuta la chiave API Developer Knowledge, puoi iniziare a utilizzare l'API. L'esempio seguente mostra come cercare blocchi di documenti correlati a "BigQuery":

  1. Salva la chiave API di Developer Knowledge in una variabile di ambiente:

    export DEVELOPERKNOWLEDGE_API_KEY="YOUR_API_KEY"

    Sostituisci YOUR_API_KEY con la chiave API che hai generato.

  2. Utilizza curl per chiamare l'endpoint searchDocumentChunks:

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

Questo comando restituisce un elenco di blocchi di documenti che corrispondono alla query, inclusi snippet dei contenuti e un parent per ogni documento.

Recuperare un documento

La risposta di searchDocumentChunks contiene un elenco di blocchi di documenti. Ogni blocco di documenti ha un campo parent, che puoi utilizzare per recuperare i contenuti completi del documento con GetDocument.

Copia parent di uno dei blocchi di documenti restituiti dalla chiamata searchDocumentChunks (ad esempio, documents/developers.google.com/...), salvalo in una variabile di ambiente e utilizza curl per chiamare l'endpoint GetDocument:

export DOC_NAME="DOCUMENT_NAME"

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

Restituisce l'intero contenuto Markdown del documento specificato.

Passaggi successivi