| Title: | Connect to Your 'Skilljar' Data |
|---|---|
| Description: | Functions that simplify calls to the 'Skilljar' API. See <https://api.skilljar.com/docs/> for documentation on the 'Skilljar' API. This package is not supported by 'Skilljar'. |
| Authors: | Chris Umphlett [aut, cre] |
| Maintainer: | Chris Umphlett <[email protected]> |
| License: | CC0 |
| Version: | 0.1.2.9000 |
| Built: | 2024-10-24 04:43:42 UTC |
| Source: | https://github.com/chrisumphlett/skilljar |
Returns a data.frame with all paths and the items in those paths.
get_course_paths(api_token)get_course_paths(api_token)
api_token |
Your personalized token provided by 'Skilljar' |
Utilizing the API requires a token. This must be obtained by logging in at dashboard.skilljar.com and going to Organization -> API Credentials. There are different strategies for storing api tokens securely. It is an unnecessary risk to store the token in the script!
A data frame with users and user data
See https://api.skilljar.com/docs/ for documentation on the 'Skilljar' API.
## Not run: # Get course progress data paths <- get_course_paths(api_token = "my-token") ## End(Not run)## Not run: # Get course progress data paths <- get_course_paths(api_token = "my-token") ## End(Not run)
Returns a data.frame with all course progress details for a list of user id's.
get_course_progress(user_ids, api_token)get_course_progress(user_ids, api_token)
user_ids |
Vector of user id's for which you want course progress data |
api_token |
Your personalized token provided by 'Skilljar' |
The API call only returns one user at a time. If you have many users then it may take a long time for the function to return. You may also exceed the 'Skilljar' API rate limit.
Utilizing the API requires a token. This must be obtained by logging in at dashboard.skilljar.com and going to Organization -> API Credentials. There are different strategies for storing api tokens securely. It is an unnecessary risk to store the token in the script!
A data frame with users and user data
See https://api.skilljar.com/docs/ for documentation on the 'Skilljar' API.
## Not run: # Get some user id's users <- get_users(domain = "training.mycompany.com", users_desired = 10, api_token = "my-token") # Get course progress data progress <- get_course_progress(user_ids = unique(users$user.id), api_token = "my-token") ## End(Not run)## Not run: # Get some user id's users <- get_users(domain = "training.mycompany.com", users_desired = 10, api_token = "my-token") # Get course progress data progress <- get_course_progress(user_ids = unique(users$user.id), api_token = "my-token") ## End(Not run)
Returns a data.frame with all published courses from a particular domain.
get_published_courses(domain, api_token)get_published_courses(domain, api_token)
domain |
Domain of 'Skilljar' account |
api_token |
Your personalized token provided by 'Skilljar' |
Utilizing the API requires a token. This must be obtained by logging in at dashboard.skilljar.com and going to Organization -> API Credentials. There are different strategies for storing api tokens securely. It is an unnecessary risk to store the token in the script!
A data frame with all published course data
See https://api.skilljar.com/docs/ for documentation on the 'Skilljar' API.
## Not run: # Retrieve all published courses courses <- get_published_courses(domain = "training.mycompany.com", api_token = "my-token") ## End(Not run)## Not run: # Retrieve all published courses courses <- get_published_courses(domain = "training.mycompany.com", api_token = "my-token") ## End(Not run)
Accepts a vector of user id's, and a domain, and returns a data.frame that indicates if each id is found in that domain.
get_user_domain(domain, user_ids, api_token)get_user_domain(domain, user_ids, api_token)
domain |
Skilljar domain you want to search in |
user_ids |
Vector of user id's |
api_token |
Your personalized token provided by 'Skilljar' |
Utilizing the API requires a token. This must be obtained by logging in at dashboard.skilljar.com and going to Organization -> API Credentials. There are different strategies for storing api tokens securely. It is an unnecessary risk to store the token in the script!
A data.frame that indicates if each id is found in that domain.
See https://api.skilljar.com/docs/ for documentation on the 'Skilljar' API.
## Not run: # Retrieve user data and domain for 100 users my_users <- get_users(users_desired = 100, api_token = "my-token") user_vector <- users %>% select(user_id) %>% pull() my_users2 <- get_user_domain(user_vector, "my-domain.skilljar.com", api_token = "my-token") ## End(Not run)## Not run: # Retrieve user data and domain for 100 users my_users <- get_users(users_desired = 100, api_token = "my-token") user_vector <- users %>% select(user_id) %>% pull() my_users2 <- get_user_domain(user_vector, "my-domain.skilljar.com", api_token = "my-token") ## End(Not run)
Returns a data.frame with all users from a particular domain. If you have many users and do not want to return them all at once, you may request fewer users to save time while doing development. The API returns up 10,000 users at a time– if you request more than 10,000, it will return in full page increments (a multiple of 10,000).
get_users(users_desired = 1e+08, api_token)get_users(users_desired = 1e+08, api_token)
users_desired |
Number of user records to return |
api_token |
Your personalized token provided by 'Skilljar' |
Utilizing the API requires a token. This must be obtained by logging in at dashboard.skilljar.com and going to Organization -> API Credentials. There are different strategies for storing api tokens securely. It is an unnecessary risk to store the token in the script!
A data frame with users and user data
See https://api.skilljar.com/docs/ for documentation on the 'Skilljar' API.
## Not run: # Retrieve 1000 users my_users <- get_users(users_desired = 1000, api_token = "my-token") ## End(Not run)## Not run: # Retrieve 1000 users my_users <- get_users(users_desired = 1000, api_token = "my-token") ## End(Not run)