使用 REST API v4 获取 Google 表格数据时出现“未找到请求的实体”

Question

所以，我正在尝试使用 REST API v4 从我的 Google 表格中获取数据。电子表格的 URL 是

https://docs.google.com/spreadsheets/d/1OaknELJVzHxsz5UkH4asuC_xIjgVF3s7JldrxiVuRc/edit#gid=2107620388

所以，我的spreadsheetId 是1OaknELJVzHxsz5UkH4asuC_xIjgVF3s7JldrxiVuRc。 我正在关注this 链接以获取数据。根据文档，要使用的API 是

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/Sheet1!A1:D5

现在，对于 sheet，我有 2 张纸 - transactions 和 categories。

所以，我最终要使用的URL 变成了

https://sheets.googleapis.com/v4/spreadsheets/1OaknELJVzHxsz5UkH4asuEC_xIjgVF3s7JldrxiVuRc/values/transactions

我使用以下curl 调用来获取数据

curl -v \
-H 'Authorization: Bearer ya29.GlxSB5uTisAfJ3umjYbGGdHBWeeuoBpQtytjdHc2QfP2lwVWqsQ7RwT-Or0z7VRAVQzilVWkweZ2WcH3TQqVnmoCZDe3rTn3euZ4MsoV1mCUpNh2bV-KHEhD16Q' \
-H 'Content-Type: application/json' \
https://sheets.googleapis.com/v4/spreadsheets/1OaknELJVzHxsz5UkH4asuEC_xIjgVF3s7JldrxiVuRc/values/transactions

但是，我得到如下错误

*   Trying 2607:f8b0:400a:804::200a...
* TCP_NODELAY set
* Connected to sheets.googleapis.com (2607:f8b0:400a:804::200a) port 443 (#0)
* ALPN, offering h2
* ALPN, offering http/1.1
* Cipher selection: ALL:!EXPORT:!EXPORT40:!EXPORT56:!aNULL:!LOW:!RC4:@STRENGTH
* successfully set certificate verify locations:
*   CAfile: /etc/ssl/cert.pem
  CApath: none
* TLSv1.2 (OUT), TLS handshake, Client hello (1):
* TLSv1.2 (IN), TLS handshake, Server hello (2):
* TLSv1.2 (IN), TLS handshake, Certificate (11):
* TLSv1.2 (IN), TLS handshake, Server key exchange (12):
* TLSv1.2 (IN), TLS handshake, Server finished (14):
* TLSv1.2 (OUT), TLS handshake, Client key exchange (16):
* TLSv1.2 (OUT), TLS change cipher, Client hello (1):
* TLSv1.2 (OUT), TLS handshake, Finished (20):
* TLSv1.2 (IN), TLS change cipher, Client hello (1):
* TLSv1.2 (IN), TLS handshake, Finished (20):
* SSL connection using TLSv1.2 / ECDHE-ECDSA-CHACHA20-POLY1305
* ALPN, server accepted to use h2
* Server certificate:
*  subject: C=US; ST=California; L=Mountain View; O=Google LLC; CN=*.googleapis.com
*  start date: Jul  2 19:21:00 2019 GMT
*  expire date: Sep 24 18:57:00 2019 GMT
*  subjectAltName: host "sheets.googleapis.com" matched cert's "*.googleapis.com"
*  issuer: C=US; O=Google Trust Services; CN=Google Internet Authority G3
*  SSL certificate verify ok.
* Using HTTP2, server supports multi-use
* Connection state changed (HTTP/2 confirmed)
* Copying HTTP/2 data in stream buffer to connection buffer after upgrade: len=0
* Using Stream ID: 1 (easy handle 0x7fe5d7800000)
> GET /v4/spreadsheets/1OaknELJVzHxsUkH4asuEC_xIjgVF3s7JldrxiVuRc/values/transactions HTTP/2
> Host: sheets.googleapis.com
> User-Agent: curl/7.54.0
> Accept: */*
> Authorization: Bearer ya29.GlxSB5uTisAfJ3umjYbGGdHBWeeutytjdHc2QfP2lwVWqsQ7RwT-Or0z7VRAVQzilVWkweZ2WcH3TQqVnmoCZAehDe3rTn3euZ4MsoV1mCUpNh2bV-KHEhD16Q
> Content-Type: application/json
>
* Connection state changed (MAX_CONCURRENT_STREAMS updated)!
< HTTP/2 404
< vary: X-Origin
< vary: Referer
< vary: Origin,Accept-Encoding
< content-type: application/json; charset=UTF-8
< date: Fri, 26 Jul 2019 23:34:05 GMT
< server: ESF
< cache-control: private
< x-xss-protection: 0
< x-frame-options: SAMEORIGIN
< alt-svc: quic=":443"; ma=2592000; v="46,43,39"
< accept-ranges: none
<
{
  "error": {
    "code": 404,
    "message": "Requested entity was not found.",
    "status": "NOT_FOUND"
  }
}
* Connection #0 to host sheets.googleapis.com left intact

我尝试了其他A1 Notation，但都没有成功

transactions!A:B
transactions!A1:B2
categories!A:B
transactions
categories

我知道我的Bearer 令牌是有效的并且在范围内，因为我能够创建一个spreadsheet。 另外，我正在为我的应用程序使用以下范围

https://www.googleapis.com/auth/drive.file

我在这里做错了什么？ 谢谢

Answer 1

• 您希望使用 Sheets API 的电子表格.values.get 方法检索值。

如果我的理解是正确的，那么这个答案呢？

问题：

当出现Requested entity was not found.的错误信息时，可以考虑以下原因。

• 未找到电子表格 ID 的电子表格。
  • 如果未找到工作表名称，则会显示错误消息Unable to parse range: ###。
• 在https://www.googleapis.com/auth/drive.file范围的情况下，可以访问使用包含此范围的访问令牌创建的文件。您可能会尝试访问不是使用包括范围在内的访问令牌创建的电子表格。

根据您的问题，当电子表格ID正确时，认为后者是您的问题的原因。

解决方案：

为了避免这种情况，我想提出以下两种模式。请将此答案视为几个答案之一。

模式一：

当你需要使用https://www.googleapis.com/auth/drive.file的范围时，这个怎么样？

1. 通过电子表格.create 的方法，使用访问令牌创建新的电子表格，包括https://www.googleapis.com/auth/drive.file 的范围。并为创建的电子表格设置一些值。这可以通过手动操作来完成。请检索电子表格 ID。

   curl \
     -H 'Authorization: Bearer ###' \
     -H 'Content-Type: application/json' \
     -d '{"properties": {"title": "sample"}}' \
     https://sheets.googleapis.com/v4/spreadsheets
   

2. 使用 Sheets API 的 spreadsheets.values.get 方法从创建的电子表格中检索值。

   curl \
   -H 'Authorization: Bearer ###' \
   https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/transactions
   

   • The official document 说https://www.googleapis.com/auth/drive.file 的范围如下。

   查看和管理您使用此应用打开或创建的 Google 云端硬盘文件和文件夹

模式2：

当您可以使用其他范围而不是https://www.googleapis.com/auth/drive.file 时，使用https://www.googleapis.com/auth/spreadsheets.readonly 的范围怎么样？在这种情况下，您可以从现有电子表格中检索错误为Requested entity was not found. 的值。

curl \
-H 'Authorization: Bearer ###' \
https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/transactions

• 在此范围内，您无法更新电子表格。如果要更新，请使用https://www.googleapis.com/auth/spreadsheets。作为范围。请注意这一点。

注意：

• 在上面的 curl 命令示例中，假设您已经能够使用 Sheets API 为电子表格放置和获取值。

参考资料：

• Method: spreadsheets.values.get
• Method: spreadsheets.create
• Scopes of Google Sheets API, v4

如果我误解了您的问题并且这不是您想要的方向，我深表歉意。