Developer Knowledge API

借助 Developer Knowledge API，您可以以编程方式访问 Google 的公开开发者文档，从而将此知识库集成到您自己的应用和工作流中。

概览

Developer Knowledge API 旨在成为以机器可读格式访问 Google 开发者文档的规范来源。它提供以下功能来搜索和检索文档，以及回答查询：

• SearchDocumentChunks ：根据查询查找相关网页 URI 和内容片段。
• GetDocument 或 BatchGetDocuments ：提取搜索结果的完整内容。
• AnswerQuery ：根据文档语料库生成查询的答案。

Developer Knowledge API 支持以非结构化 Markdown 内容的形式搜索和检索文档页面。如需查看可搜索内容的语料库，请参阅 语料库参考文档。

使用开发者知识的方式

您可以根据自己的工作流，通过以下界面访问开发者知识：

• REST API 和 RPC API：直接调用 HTTP 或 gRPC 端点 。如需了解方法规范，请参阅 REST 参考文档 和 RPC 参考文档。
• 客户端库：使用 C#、Go、Java、Node.js 和 TypeScript、PHP、Python 和 Ruby 的官方客户端库，将 Developer Knowledge API 集成到您的应用中。
• Google Cloud CLI (gcloud): run gcloud developer-knowledge commands from your terminal to search document chunks, fetch Markdown content, and generate answers.
• 开发者知识 MCP 服务器：使用 Model Context Protocol (MCP) 工具（search_documents、get_documents 和 answer_query）将 AI 编码辅助或智能体连接到 Google 的文档。请参阅MCP 参考文档。

提示： 如果您使用的是 AI 编码辅助，请运行 npx skills add google/skills --skill retrieving-developer-knowledge 安装 retrieving-developer-knowledge 智能体 skill。借助此技能，您的助理可以获得内置说明，了解要选择哪个开发者知识 MCP 服务器工具、如何处理错误，以及在 MCP 服务器不可用时如何使用 curl 调用 REST API。如需了解详情，请参阅 使用开发者知识智能体技能。

在 API 和 MCP 服务器之间进行选择

Developer Knowledge API 和开发者知识 MCP 服务器旨在满足不同的集成需求：

• 在以下情况下使用 Developer Knowledge API、客户端库或 gcloud CLI ：
  • 您的项目未使用 AI 智能体。
  • 您想为智能体定义自定义工具或工具集。
  • 您想在将结果传递给模型之前对其进行处理或组合（例如，在提取完整内容之前检查文档字节长度）。
  • 您需要 过滤搜索结果 （例如按 data_source 或 update_time）或应用 字段掩码。
• 在以下情况下
  使用开发者知识 MCP 服务器和智能体技能：
  • 您想连接 AI 编码辅助或智能体，而无需编写自定义工具定义和说明。
  • 您希望在开发者知识 MCP 服务器添加新功能时自动更新。
  • 您不需要对搜索结果进行自定义元数据过滤。

启用 API

如需使用 Developer Knowledge API，您首先需要为 Google Cloud 项目启用该 API。

**提示**： 如果您没有 Google Cloud 云项目，请按照 Google Cloud 或 Firebase 说明创建一个。

1. 在 Google API 库中打开 Developer Knowledge API 页面 。
2. 检查您是否已选择要使用该 API 的正确项目。
3. 点击启用 。启用或使用该 API 不需要任何特定的 IAM 角色。

身份验证

您可以使用以下方法之一对 Developer Knowledge API 的请求进行身份验证：

• API 密钥：使用 key 查询参数或 X-Goog-Api-Key 标头对直接 REST 请求 或 开发者知识 MCP 服务器 进行身份验证。
• 应用默认凭据 (ADC)、OAuth 2.0 或服务账号： 在使用官方 客户端库或生产 工作流时对请求进行身份验证。如需详细了解如何设置凭证，请参阅 应用默认凭证文档。
• 用户凭据 (gcloud CLI)：通过使用 gcloud auth login 登录 Google Cloud 账号来对 CLI 请求进行身份验证。如需查看设置 说明，请参阅 gcloud CLI 快速入门。

包含的文档

如需了解 API 搜索哪些文档，请参阅语料库参考文档，以获取 相关信息。

Developer Knowledge API 旨在提供对最新 Google 开发者文档的访问权限。我们的目标是在内容发布后 48 小时内重新为内容编制索引，以便在 2 个工作日内提供新的或更新的文档。

已知限制

• Markdown 质量 ：Markdown 是根据源 HTML 生成的。可能会存在一些差异或格式问题。
• 内容范围 ：仅包含 语料库参考文档中的公开页面。 不包含来自其他来源（例如 GitHub、OSS 网站、博客或 YouTube）的内容。