R googlesheets4 sheets_id Sheets_id 類

sheets_id 是一個 S3 類，它將字符串標記為 Google Sheet 的 id，Sheets API 文檔將其稱為 spreadsheetId 。

sheets_id 類的任何對象也具有 drive_id 類，googledrive 將其用於相同目的。這意味著您可以向 googledrive 函數提供 sheets_id，以便對您的工作表執行與電子表格無關的任何操作。示例：更改工作表的名稱、父文件夾或權限。在 vignette("drive-and-sheets") 中了解有關一起使用 googlesheets4 和 googledrive 的更多信息。請注意，sheets_id 對象僅保存一個 id，而父類 drive_id 可用於保存多個 id。

as_sheets_id() 是一個通用函數，它將各種輸入轉換為 sheets_id 的實例。請參閱下麵的更多內容。

當您打印 sheets_id 時，我們嘗試通過 gs4_get() 顯示工作表的當前元數據。這可能會因多種原因而失敗(例如，如果您處於離線狀態)，但輸入 sheets_id 始終會以不可見的方式顯示並返回。

用法

as_sheets_id(x, ...)

參數

x: 包含 Google Sheet id 的內容：id 字符串、 drive_id 、 URL、 one-row dribble 或 googlesheets4_spreadsheet 。
...: 其他參數傳遞給方法。 (不曾用過。)

`as_sheets_id()`

這些輸入可以轉換為 sheets_id ：

電子表格 ID，“包含字母、數字和一些特殊字符的字符串”，根據我們的經驗，通常為 44 個字符長。示例：1qpyC0XzvTcKT6EISywvqESX3A0MwQoFDE8p-Bll4hps 。
一個 URL，我們可以從中挖掘電子表格或文件 ID。例子："https://docs.google.com/spreadsheets/d/1BzfL0kZUz1TsI5zxJF1WNF01IxvC67FbOJUiiGMZ_mQ/edit#gid=1150108545".
googledrive 包使用的 one-row dribble 和 "Drive tibble" 。一般來說，一個dribble可以代表多個文件，每個文件一行。由於 googlesheets4 未在電子表格上進行矢量化，因此我們隻準備接受 one-row dribble 。
- googledrive::drive_get("YOUR_SHEET_NAME") 是通過名稱查找工作表的好方法。
- gs4_find("YOUR_SHEET_NAME") 是獲取工作表的另一種好方法。
電子表格元數據，例如 gs4_get() 返回。從字麵上看，這是類 googlesheets4_spreadsheet 的對象。

也可以看看

googledrive drive_id

例子

mini_gap_id <- gs4_example("mini-gap")
class(mini_gap_id)
#> [1] "sheets_id"  "drive_id"   "vctrs_vctr" "character" 
mini_gap_id
#> 
#> ── <googlesheets4_spreadsheet> ───────────────────────────────────────────
#> Spreadsheet name: mini-gap                                    
#>               ID: 1k94ZVVl6sdj0AXfK9MQOuQ4rOhd1PULqpAu2_kr9MAU
#>           Locale: en_US                                       
#>        Time zone: America/Los_Angeles                         
#>      # of sheets: 5                                           
#> 
#> ── <sheets> ──────────────────────────────────────────────────────────────
#> (Sheet name): (Nominal extent in rows x columns)
#>       Africa: 6 x 6
#>     Americas: 6 x 6
#>         Asia: 6 x 6
#>       Europe: 6 x 6
#>      Oceania: 6 x 6

as_sheets_id("abc")
#> 
#> ── <googlesheets4_spreadsheet> ───────────────────────────────────────────
#> Spreadsheet name: "<unknown>"
#>               ID: abc        
#>           Locale: <unknown>  
#>        Time zone: <unknown>  
#>      # of sheets: <unknown>  
#> 
#> Unable to get metadata for this Sheet. Error details:
#> Client error: (404) NOT_FOUND
#> • A specified resource is not found, or the request is rejected by
#>   undisclosed reasons, such as whitelisting.
#> • Requested entity was not found.

源代碼：R/sheets_id-class.R

相關用法

注：本文由純淨天空篩選整理自Jennifer Bryan等大神的英文原創作品 sheets_id class。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。