快速入門導覽課程：開始使用 Developer Knowledge API

本指南說明如何開始使用 Developer Knowledge API。您將瞭解如何啟用 Developer Knowledge API、取得 API 金鑰，以及發出第一個 API 呼叫，搜尋及擷取開發人員說明文件。

事前準備

啟用 API

  1. 在 Google API 程式庫中開啟 Developer Knowledge API 頁面。
  2. 確認您已選取要使用 API 的正確專案。
  3. 按一下「啟用」。啟用或使用 API 時，不需要特定的 IAM 角色。

建立及保護 API 金鑰

  1. 在 Google Cloud 控制台中，前往已啟用 API 的專案，然後前往「憑證」頁面。
  2. 按一下「建立憑證」，然後從選單中選取「API 金鑰」。
  3. 在「Name」欄位中，輸入金鑰名稱。
  4. 按一下「選取 API 限制」下拉式選單，然後輸入「Developer Knowledge API」。按一下結果，然後按一下「確定」。
    • 注意：如果您剛啟用 Developer Knowledge API，可能要過一段時間才會顯示在清單中。請稍候片刻，然後再試一次。
  5. 點選「建立」。

搜尋文件區塊

取得 Developer Knowledge API 金鑰後，即可開始使用 API。以下範例說明如何搜尋與「BigQuery」相關的文件區塊：

  1. 將 Developer Knowledge API 金鑰儲存至環境變數：

    export DEVELOPERKNOWLEDGE_API_KEY="YOUR_API_KEY"

    將 YOUR_API_KEY 替換為您產生的 API 金鑰。

  2. 使用 curl 呼叫 searchDocumentChunks 端點：

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

這項指令會傳回符合查詢條件的文件區塊清單，包括內容的程式碼片段和每個文件的 parent。

擷取文件

searchDocumentChunks 的回覆包含文件區塊清單。每個文件區塊都有 parent 欄位，您可以使用 GetDocument 擷取文件的完整內容。

複製 searchDocumentChunks 呼叫傳回的其中一個文件區塊的 parent (例如 documents/developers.google.com/...)，將其儲存至環境變數，然後使用 curl 呼叫 GetDocument 端點：

export DOC_NAME="DOCUMENT_NAME"

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

這會傳回指定文件的完整 Markdown 內容。

後續步驟