当前位置: 首页>>代码示例 >>用法及示例精选 >>正文

R googlesheets4 sheet_copy 复制(工作)表


将(工作)表复制到其当前(跨页)工作表中或复制到另一个工作表。

用法

sheet_copy(
  from_ss,
  from_sheet = NULL,
  to_ss = from_ss,
  to_sheet = NULL,
  .before = NULL,
  .after = NULL
)

参数

from_ss

识别 Google 表格的内容：

  • 其文件 ID 作为字符串或 drive_id

  • 我们可以从中恢复 id 的 URL

  • one-row dribble ，这就是 googledrive 表示云端硬盘文件的方式

  • googlesheets4_spreadsheet 的实例，这就是 gs4_get() 返回的内容

通过 as_sheets_id() 处理。

from_sheet

要复制的工作表，即 "worksheet" 或 "tab"。您可以通过名称(使用字符串)或位置(使用数字)来标识工作表。默认为第一个可见工作表。

to_ss

要复制到的工作表。接受与 from_ss 相同类型的输入，如果未指定，这也是默认的输入类型。

to_sheet

可选的。新工作表的名称，作为字符串。如果您不指定这一点，Google 会生成一个名称，类似于“Copy of blah”。请注意，工作表名称在工作表中必须是唯一的，因此如果自动名称违反了这一点，Google 还会为您de-duplicates，这意味着您可能会得到“Copy of blah 2”。如果您对工作表名称有更好的想法，请指定 to_sheet 。

.before, .after

新工作表放置位置的可选规范。最多指定 .before 和 .after 之一。按名称(通过字符串)或按位置(通过数字)引用现有工作表。如果未指定，Sheets 会将新工作表放在末尾。

值

接收工作表 to_ ss ，作为 sheets_id 的实例。

也可以看看

如果复制发生在一张 Sheet 内，则生成 DuplicateSheetRequest ：

如果复制是从一张工作表到另一张工作表，则包装 spreadsheets.sheets/copyTo 端点：

并可能生成后续的 UpdateSheetPropertiesRequest ：

其他工作表函数：sheet_add() , sheet_append() , sheet_delete() , sheet_properties() , sheet_relocate() , sheet_rename() , sheet_resize() , sheet_write()

例子

ss_aaa <- gs4_create(
  "sheet-copy-demo-aaa",
  sheets = list(mtcars = head(mtcars), chickwts = head(chickwts))
)
#> ✔ Creating new Sheet: sheet-copy-demo-aaa.

# copy 'mtcars' sheet within existing Sheet, accept autogenerated name
ss_aaa %>%
  sheet_copy()
#> ✔ Duplicating sheet mtcars in sheet-copy-demo-aaa.
#> ✔ Copied as Copy of mtcars.

# copy 'mtcars' sheet within existing Sheet
# specify new sheet's name and location
ss_aaa %>%
  sheet_copy(to_sheet = "mtcars-the-sequel", .after = 1)
#> ✔ Duplicating sheet Copy of mtcars in sheet-copy-demo-aaa.
#> ✔ Copied as mtcars-the-sequel.

# make a second Sheet
ss_bbb <- gs4_create("sheet-copy-demo-bbb")
#> ✔ Creating new Sheet: sheet-copy-demo-bbb.

# copy 'chickwts' sheet from first Sheet to second
# accept auto-generated name and default location
ss_aaa %>%
  sheet_copy("chickwts", to_ss = ss_bbb)
#> ✔ Copying sheet chickwts from sheet-copy-demo-aaa to sheet-copy-demo-bbb.
#> ✔ Copied as Copy of chickwts.

# copy 'chickwts' sheet from first Sheet to second,
# WITH a specific name and into a specific location
ss_aaa %>%
  sheet_copy(
    "chickwts",
    to_ss = ss_bbb, to_sheet = "chicks-two", .before = 1
  )
#> ✔ Copying sheet chickwts from sheet-copy-demo-aaa to sheet-copy-demo-bbb.
#> ✔ Copied as chicks-two.

# clean up
gs4_find("sheet-copy-demo") %>%
  googledrive::drive_trash()
#> Files trashed:
#> • sheet-copy-demo-bbb <id: 1ogl6MGr_2L9MaRjEpI-gOBdIfCOb6Q7VQ5jmKdNJDVo>
#> • sheet-copy-demo-aaa <id: 1tl6l32B1bbfrRTQeUML5o0Z-u_6re3ge9lSSBzFTzP8>
源代码：R/sheet_copy.R

相关用法


注：本文由纯净天空筛选整理自Jennifer Bryan等大神的英文原创作品 Copy a (work)sheet。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。