无法通过Google Docs API及URL访问已发布的公开谷歌文档

核心问题定位 #

你使用的2PACX-xxx是文档发布后的网页ID（即发布链接中的ID），但Google Docs API仅识别云端硬盘中原生文档的ID（也就是文档编辑链接里的随机字符串，比如123abcXYZ...），这是导致404错误的根本原因。

具体解决步骤 #

• 确认正确的文档ID：打开云端硬盘里的原始文档，复制地址栏中d/和/edit之间的字符串，例如链接https://docs.google.com/document/d/1AbCDefGhIjKlMnOpQrStUvWxYz/edit里的1AbCDefGhIjKlMnOpQrStUvWxYz才是API可识别的有效ID。
• 检查文档权限配置：
  1. 确保服务账号已被添加为文档的编辑者或查看者，直接在文档共享设置中输入服务账号的邮箱（格式类似xxx@xxx.iam.gserviceaccount.com）并完成授权。
  2. 不要依赖发布后的公开权限，API调用的权限逻辑与网页发布权限相互独立，必须单独给服务账号配置文档访问权限。
• 验证API请求格式：使用正确的文档ID构造请求，示例格式如下：

  GET https://docs.googleapis.com/v1/documents/1AbCDefGhIjKlMnOpQrStUvWxYz?alt=json
  

• 排查服务账号身份验证：确保调用API时使用的是对应服务账号的密钥文件，身份验证流程无错误，未混用其他账号的凭据。

额外提示 #

如果确实需要获取发布后网页的内容（而非原生文档的JSON结构），可以直接发送HTTP GET请求到发布链接（比如https://docs.google.com/document/d/e/2PACX-xxx/pub），随后解析返回的HTML内容即可，这种方式无需调用Docs API，也不需要服务账号权限。

内容的提问来源于stack exchange，提问作者Christian Alexander