box_search: Search Box files

Description Usage Arguments Details Value

View source: R/boxr_search.R

Description

Search Box files

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
box_search(
  query = "",
  content_types = c("name", "description", "file_content", "comments", "tags"),
  type = NULL,
  file_extensions = NULL,
  ancestor_folder_ids = NULL,
  created_at_range = NULL,
  updated_at_range = NULL,
  size_range = NULL,
  trash = FALSE,
  owner_user_ids = NULL,
  max = 200
)

box_search_files(query, ...)

box_search_folders(query, ...)

box_search_trash(query, ...)

Arguments

query

character, search term.

content_types

character, content to search; more than one can be supplied with a vector.

type

character, type of object to return; the default, NULL, returns all possible types ("file", "folder", or "weblink").

file_extensions

character, vector of strings containing the file extensions (without dots) by which to narrow your search.

ancestor_folder_ids

numeric or character, if supplied, results are limited to one or more parent (ancestor) folders.

created_at_range

POSIXct (vector, length 2), range of created-at times.

updated_at_range

POSIXct (vector, length 2), range of updated-at times.

size_range

numeric (vector, length 2), range of file sizes (bytes).

trash

logical, indicates to search only the trash folder.

owner_user_ids

numeric or character, limits search to files owned by users with these IDs.

max

numeric, upper limit on the number of search results.

...

Other arguments passed to box_search().

Details

The Box API supports a maximum of 200 results per request. If max > 200, then multiple requests will be sent to retrieve and combine 'paginated' results for you, behind the scenes.

See the box.com search description for details of the features of the service. Some notable details:

Value

Object with S3 class boxr_object_list.


boxr documentation built on Jan. 19, 2021, 5:06 p.m.