R googledrive request_generate 构建 Google Drive API 请求

使用其发现文档 (https://www.googleapis.com/discovery/v1/apis/drive/v3/rest) 中的 Drive v3 API 知识构建请求。相反，大多数用户应该使用更高级别的包装器来促进常见任务，例如上传或下载云端硬盘文件。这里的函数供内部使用以及围绕 Drive API 进行编程。

request_generate() 允许您提供最少的输入。它需要端点的昵称并且：

• 使用 API 规范查找 path 、 method 和基本 URL。

• 检查 params 端点的有效性和完整性。将参数分为用于正文、查询和 URL 端点替换(也已制定)的参数。

• 当且仅当 token = NULL 时，才向查询添加 API key 。

• 如果端点需要，将 supportsAllDrives = TRUE 添加到查询中。

用法

request_generate(
  endpoint = character(),
  params = list(),
  key = NULL,
  token = drive_token()
)

参数

endpoint

特点。 googledrive 中内置的所选 Drive v3 API 端点之一的昵称。在drive_endpoints() 中了解更多信息。

params

点名名单。指定用于端点 URL 替换、查询或正文的参数。

key

API key 。不包含令牌的请求需要。 Google 文档“凭据、访问、安全性和身份”(https://support.google.com/googleapi/answer/6158857?hl=en&ref_topic=7013279) 解释了在没有令牌的情况下需要 API key 的情况。按照优先顺序，将参考以下来源：正式的 key 参数、params 中的 key 参数、通过 drive_api_key() 获取的用户配置的 API key 、googledrive 附带的内置 key 。有关用户配置 key 的详细信息，请参阅drive_auth_configure()。

token

驱动令牌。设置为 NULL 以禁止包含令牌。请注意，如果已通过 drive_deauth() 进行身份验证 de-activated ，则 drive_token() 实际上将返回 NULL 。

值

list()
组件有method,path,query,body,token， 和url，适合作为输入request_make().

也可以看看

例子

req <- request_generate(
  "drive.files.get",
  list(fileId = "abc"),
  token = drive_token()
)
req
#> $method
#> [1] "GET"
#> 
#> $url
#> [1] "https://www.googleapis.com/drive/v3/files/abc?supportsAllDrives=TRUE"
#> 
#> $body
#> named list()
#> 
#> $token
#> <request>
#> Auth token: TokenServiceAccount
#>