R googledrive drive_fields 请求部分资源

您可以通过仅请求实际需要的元数据来提高 API 调用的性能。该函数主要供内部使用，目前主要关注Files resource。请注意，高级 googledrive 函数假定至少包含 name 、 id 和 kind 字段。假设 resource = "files"(默认值)，将根据已知字段名称检查通过 fields 提供的输入的有效性，并返回经过验证的字段。要查看包含所有可能字段以及每个字段的简短说明的小标题，请调用 drive_fields(expose()) 。

prep_fields() 准备包含作为查询参数的字段。

用法

drive_fields(fields = NULL, resource = "files")

prep_fields(fields, resource = "files")

参数

fields: 字段名称的字符向量。如果是resource = "files"，则检查它们的有效性。否则，它们将被通过。
resource: 字符，命名感兴趣的 API 资源。目前，仅预期文件资源。

值

drive_fields()：字段名称的字符向量。 prep_fields()：一个字符串。

也可以看看

Improve performance，位于 Drive API 文档中。

例子

# get a tibble of all fields for the Files resource + indicator of defaults
drive_fields(expose())
#> # A tibble: 55 × 2
#>    name                         desc                                      
#>    <chr>                        <chr>                                     
#>  1 appProperties                "A collection of arbitrary key-value pair…
#>  2 capabilities                 "Capabilities the current user has on thi…
#>  3 contentHints                 "Additional information about the content…
#>  4 copyRequiresWriterPermission "Whether the options to copy, print, or d…
#>  5 createdTime                  "The time at which the file was created (…
#>  6 description                  "A short description of the file."        
#>  7 driveId                      "ID of the shared drive the file resides …
#>  8 explicitlyTrashed            "Whether the file has been explicitly tra…
#>  9 exportLinks                  "Links for exporting Google Docs to speci…
#> 10 fileExtension                "The final component of fullFileExtension…
#> # ℹ 45 more rows

# invalid fields are removed and throw warning
drive_fields(c("name", "parents", "ownedByMe", "pancakes!"))
#> Warning: Omitting fields that are not recognized as part of the Files resource:
#> • pancakes!
#> [1] "name"      "parents"   "ownedByMe"

# prepare fields for query
prep_fields(c("name", "parents", "kind"))
#> [1] "files/name,files/parents,files/kind"

源代码：R/drive_fields.R

相关用法

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