diff --git a/R/drive_endpoints.R b/R/drive_endpoints.R index 2bbb8c154..a3bc9cd8a 100644 --- a/R/drive_endpoints.R +++ b/R/drive_endpoints.R @@ -10,10 +10,10 @@ #' The names of this list (or the `id` sub-elements) are the nicknames that can #' be used to specify an endpoint in [request_generate()]. For each endpoint, we #' store its nickname or `id`, the associated HTTP verb, the `path`, and details -#' about the parameters. This list is derived programmatically from the [Drive -#' API v3 Discovery -#' Document](https://www.googleapis.com/discovery/v1/apis/drive/v3/rest) using -#' the approach described in the [Discovery Documents +#' about the parameters. This list is derived programmatically from the Drive +#' API v3 Discovery Document +#' (`https://www.googleapis.com/discovery/v1/apis/drive/v3/rest`) using the +#' approach described in the [Discovery Documents #' section](https://gargle.r-lib.org/articles/request-helper-functions.html#discovery-documents) #' of the gargle vignette [Request helper #' functions](https://gargle.r-lib.org/articles/request-helper-functions.html). diff --git a/R/request_generate.R b/R/request_generate.R index 82bde58bb..d25644e5c 100644 --- a/R/request_generate.R +++ b/R/request_generate.R @@ -2,10 +2,10 @@ #' #' @description Build a request, using knowledge of the [Drive v3 #' API](https://developers.google.com/drive/api/v3/about-sdk) from its -#' [Discovery -#' Document](https://www.googleapis.com/discovery/v1/apis/drive/v3/rest). Most -#' users should, instead, use higher-level wrappers that facilitate common -#' tasks, such as uploading or downloading Drive files. The functions here are +#' Discovery Document +#' (`https://www.googleapis.com/discovery/v1/apis/drive/v3/rest`). Most users +#' should, instead, use higher-level wrappers that facilitate common tasks, +#' such as uploading or downloading Drive files. The functions here are #' intended for internal use and for programming around the Drive API. #' #' @description `request_generate()` lets you provide the bare minimum of input. @@ -25,7 +25,7 @@ #' for an API key in the absence of a token is explained in Google's document #' "Credentials, access, security, and identity" #' (`https://support.google.com/googleapi/answer/6158857?hl=en&ref_topic=7013279`). -#' In order of precedence, these sources are consulted: the formal `key` +#' In order of precedence, these sources are consulted: the formal `key` #' argument, a `key` parameter in `params`, a user-configured API key fetched #' via [drive_api_key()], a built-in key shipped with googledrive. See #' [drive_auth_configure()] for details on a user-configured key. diff --git a/man/drive_endpoints.Rd b/man/drive_endpoints.Rd index 218f893a4..1d0160696 100644 --- a/man/drive_endpoints.Rd +++ b/man/drive_endpoints.Rd @@ -30,8 +30,10 @@ this data. The names of this list (or the \code{id} sub-elements) are the nicknames that can be used to specify an endpoint in \code{\link[=request_generate]{request_generate()}}. For each endpoint, we store its nickname or \code{id}, the associated HTTP verb, the \code{path}, and details -about the parameters. This list is derived programmatically from the \href{https://www.googleapis.com/discovery/v1/apis/drive/v3/rest}{Drive API v3 Discovery Document} using -the approach described in the \href{https://gargle.r-lib.org/articles/request-helper-functions.html#discovery-documents}{Discovery Documents section} +about the parameters. This list is derived programmatically from the Drive +API v3 Discovery Document +(\verb{https://www.googleapis.com/discovery/v1/apis/drive/v3/rest}) using the +approach described in the \href{https://gargle.r-lib.org/articles/request-helper-functions.html#discovery-documents}{Discovery Documents section} of the gargle vignette \href{https://gargle.r-lib.org/articles/request-helper-functions.html}{Request helper functions}. } \examples{ diff --git a/man/request_generate.Rd b/man/request_generate.Rd index 405cb044a..2fa7e162b 100644 --- a/man/request_generate.Rd +++ b/man/request_generate.Rd @@ -37,9 +37,10 @@ Note that, if auth has been de-activated via \code{\link[=drive_deauth]{drive_de } \description{ Build a request, using knowledge of the \href{https://developers.google.com/drive/api/v3/about-sdk}{Drive v3 API} from its -\href{https://www.googleapis.com/discovery/v1/apis/drive/v3/rest}{Discovery Document}. Most -users should, instead, use higher-level wrappers that facilitate common -tasks, such as uploading or downloading Drive files. The functions here are +Discovery Document +(\verb{https://www.googleapis.com/discovery/v1/apis/drive/v3/rest}). Most users +should, instead, use higher-level wrappers that facilitate common tasks, +such as uploading or downloading Drive files. The functions here are intended for internal use and for programming around the Drive API. \code{request_generate()} lets you provide the bare minimum of input.