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
#>