qualtRics (version 3.1.1)

metadata: Download metadata for a survey

Description

Using this function, you can retrieve metadata about your survey. This information includes question metadata (type, options, choices, etc), number of responses, general metadata, survey flow, etc.

Usage

metadata(surveyID, get = list(), ...)

Arguments

surveyID

A string. Unique ID for the survey you want to download. Returned as 'id' by the getSurveys function.

get

A list containing `TRUE`/`FALSE` values of one of the following: `metadata`, `questions`, `responsecounts`, `blocks`, `flow`, `embedded_data`, or `comments`. A `TRUE` value will return that specific element. If you leave this empty, the function will return the `metadata`, `questions`, and `responsecounts` elements. See examples below for more information.

...

Additional options. User may pass an argument called `questions`, which should be a vector containing the names of questions for which you want to return metadata.

Examples

# NOT RUN {
# Register your Qualtrics credentials if you haven't already
qualtrics_api_credentials(
  api_key = "<YOUR-API-KEY>",
  base_url = "<YOUR-BASE-URL>"
)

# Retrieve a list of surveys
surveys <- all_surveys()

# Get metadata for a survey
md <- metadata(surveyID = surveys$id[6])

# Get metadata with specific elements
md_specific <- metadata(
  surveyID = id,
  get = list(questions = FALSE, flow = TRUE)
)

# Get specific question metadata
question_specific <- metadata(
  surveyID = id,
  get = list(questions = TRUE),
  questions = c("Q1", "Q2")
)

# Example of a metadata file
file <- system.file("extdata", "metadata.rds", package = "qualtRics")

# Load
metadata_ex <- readRDS(file = file)
# }
# NOT RUN {
# }