本指南介绍了一些概念，例如构成 Google 文档 API 的主要方法、如何访问文档，以及创建文档的工作流程。

　　documents资源提供了用于调用 Docs API 的方法。您可以使用以下方法创建、读取和更新 Google 文档：

　　documentId是文档的唯一标识符，可以从文档的网址派生而来。它是一种包含字母、数字和某些特殊字符的特定字符串谷歌 免翻墙 2016。文档 ID 是稳定的，即使文档名称发生变化也是如此。

　　文档文件存储在我们的云端存储服务 Google 云端硬盘中。虽然 Google 文档 API 有自己的独立方法，但通常还需要使用 Google 云端硬盘 API 方法与用户的 Google 文档文件进行交互。例如，如需复制 Google 文档文件，请使用 Drive API 的方法。如需了解详情，请参阅复制现有文档。

　　默认情况下，使用 Docs API 时，系统会将新文档保存到用户云端硬盘的根文件夹中。您可以选择将文件保存到云端硬盘文件夹。如需了解详情，请参阅使用 Google 云端硬盘文件夹。

　　如需从用户的“我的云端硬盘”中检索文档，通常需要先使用云端硬盘的files.list方法检索文件的 ID。不带任何参数调用此方法会返回用户的所有文件和文件夹（包括 ID）的列表。

　　知道documentId后，使用documents.get方法检索指定文档的完整实例。如需了解详情，请参阅请求和响应。

　　创建和填充新文档非常简单，因为没有现有内容需要担心，也没有协作者可以更改文档状态。从概念上讲，其工作原理如下图序列图所示：

　　更新现有文档要复杂一些。在可以进行有意义的调用来更新文档之前，您必须知道文档的当前状态：文档由哪些元素组成、这些元素中包含的内容以及文档中元素的顺序。下图序列图展示了其工作原理：

　　此图表未考虑其他协作者在同一文档中进行并发更新的工作流。如需了解详情，请参阅最佳实践部分中的规划协作。

　　如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据Apache 2.0 许可获得了许可。有关详情，请参阅Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。