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。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。