#' Grab list of ads
#'
#' @description Fetches the list of ads under a given account, campaign or adset.
#'
#' @param id ID of object to grab from.
#' \href{https://www.facebook.com/business/help/1492627900875762}{how to find yours}.
#' @param token A valid token as returned by \code{\link{fbAuthenticate}}
#' or a short-term token from
#' \href{https://developers.facebook.com/tools/explorer}{facebook Graph API Explorer}.
#' @param fields default (\code{"default"}) returns the most popular ones.
#' Run \code{\link{findFields}} to see all valid fields.
#' @param n Number of results to retrieve, defaults to \code{100}.
#' When you make an API request, you will usually not receive all
#' of the results of that request in a single response.
#' This is because some responses could contain thousands of objects
#' so most responses are paginated by default. \code{previous}
#' fetches the previous page of response (after the initial query)
#' similarly \code{next} fetches the next page and \code{NULL} does not
#' paginate (only makes one query).
#' @param verbose Defaults to \code{FALSE} if \code{TRUE}
#' will print information on the query in the console.
#' @param ... additional parameters to pass to insights.
#' @param limit Number of results requested at each API call, defaults to
#' \code{100}.
#'
#' @examples
#' \dontrun{
#' ads <- grabAds(id = "act_123456789012345", token = "XXXXXX")
#' }
#'
#' @seealso \code{\link{getAd}}
#'
#' @author John Coene \email{jcoenep@@gmail.com}
#'
#' @export
grabAds <- function (id, token, fields = "default", ..., n = 100,
verbose = FALSE, limit = 100) {
fb_data <- findObjects(id = id, token = token, fields = fields, ...,
n = n, verbose = verbose, object = "ads",
FUN = "grabAds", limit = limit)
if (nrow(fb_data) == 0) warning(paste("No data."), call. = FALSE)
return (fb_data)
}
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.