Publish or republish a Datawrapper chart

Source: R/dw_publish_chart.R

Publish a chart on Datawrapper.

dw_publish_chart(
  chart_id,
  api_key = "environment",
  return_urls = TRUE,
  return_object = FALSE
)

Arguments

chart_id

Required. A Datawrapper-chart-id as character string, usually a five character combination of digits and letters, e.g. "aBcDe". Or a dw_chart-object.
api_key

Optional. A Datawrapper-API-key as character string. Defaults to "environment" - tries to automatically retrieve the key that's stored in the .Reviron-file by datawrapper_auth.
return_urls

Optional. If TRUE (default) it returns the code for the responsive iFrame and an URL to the chart.
return_object

Optional. Defaults to FALSE. Returns an object if set to TRUE which contains publicUrl and iframeCode.

Value

A message that specifies, if the publication was successful. If set, including the iFrame-Code and chart-URL. If return_object is set to TRUE it returns a S3-structure of type dw_chart

Note

This function publishes a chart in Datawrapper.

Author

Benedict Witzenberger

Examples


if (FALSE) {
dw_publish_chart("aBcDE")
} # uses the preset key in the .Renviron-file

if (FALSE) {
dw_publish_chart(chart_id = "a1B2Cd", api_key = "1234ABCD")
} # uses the specified key

if (FALSE) {
dw_publish_chart(chart_id = "a1B2Cd", return_urls = FALSE)
} # won't return code and URLs for chart

if (FALSE) {
published_chart <- dw_publish_chart(chart_id = "a1B2Cd", return_object = TRUE)
} # returns an object with URL and IframeCode