R/pardot_forms.R

In jmurray0568/pardot4: An R client for the Pardot API

#' Retrieve Pardot Forms
#'
#' Make a call to the Pardot API and return the forms matching the specified criteria parameters. 
#'
#' @param ... Comma separated list of parameter name and parameter value pairs. Parameter names are not quoted. 
#'   Allowed parameter names are created_after, created_before, id_greater_than, id_less_than, updated_before, updated_after.
#' @param verbose Verbose output. See pardot_client(). 
#' @return A data frame. See http://developer.pardot.com/kb/object-field-references/#form.
#' @examples
#' \dontrun{
#' set_credentials("your-username", "your-password", "your-user-key")
#' df <- pardot_forms()
#' df <- pardot_forms(created_after = "20180101,0900") }
#' @export pardot_forms
#' @import pryr

pardot_forms <- function(..., verbose = 0) {
    # Evaluate parameters in the context of the parent environment,
    # combine parameters to a querystring e.g. param1=value1&param2=value2&...
    dots <- lapply(pryr::named_dots(...), function(p) {
        eval(p, parent.frame())
    })
    request_pars <- paste(paste(names(dots), unlist(dots), sep = "="), collapse = "&")
    pardot_client("form", "query", request_pars = request_pars, verbose = verbose)  
}