Package 'tuber' reference manual

Title:	Client for the YouTube API
Description:	Get comments posted on YouTube videos, information on how many times a video has been liked, search for videos with particular content, and much more. You can also scrape captions from a few videos. To learn more about the YouTube API, see <https://developers.google.com/youtube/v3/>.
Authors:	Gaurav Sood [aut, cre], Kate Lyons [ctb], John Muschelli [ctb]
Maintainer:	Gaurav Sood <[email protected]>
License:	MIT + file LICENSE
Version:	0.9.9
Built:	2024-11-15 05:23:00 UTC
Source:	https://github.com/gojiplus/tuber

Add Video to Playlist

Description

Add Video to Playlist

Usage

add_video_to_playlist(playlist_id, video_id, position = NULL, ...)
add_video_to_playlist(playlist_id, video_id, position = NULL, ...)

Arguments

`playlist_id`	string; Required. The ID of the playlist.
`video_id`	string; Required. The ID of the video to add.
`...`	Additional arguments passed to `tuber_POST_json`.

Value

Details of the added video in the playlist.

References

https://developers.google.com/youtube/v3/docs/playlistItems/insert

Examples

## Not run: 

# Set API token via yt_oauth() first

add_video_to_playlist(playlist_id = "YourPlaylistID", video_id = "2_gLD1jarfU")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

add_video_to_playlist(playlist_id = "YourPlaylistID", video_id = "2_gLD1jarfU")

## End(Not run)

Change the title of a YouTube playlist.

Description

This function updates the title of an existing YouTube playlist using the YouTube Data API.

Usage

change_playlist_title(playlist_id, new_title)
change_playlist_title(playlist_id, new_title)

Arguments

`playlist_id`	A character string specifying the ID of the playlist you want to update.
`new_title`	A character string specifying the new title for the playlist.

Value

A list containing the server response after the update attempt.

Examples

## Not run: 
change_playlist_title(playlist_id = "YourPlaylistID", new_title = "New Playlist Title")

## End(Not run)

## Not run: 
change_playlist_title(playlist_id = "YourPlaylistID", new_title = "New Playlist Title")

## End(Not run)

Create New Playlist

Description

Create New Playlist

Usage

create_playlist(title, description, status, ...)
create_playlist(title, description, status, ...)

Arguments

`title`	string; Required. The title of the playlist.
`description`	string; Optional. The description of the playlist.
`status`	string; Optional. Default: 'public'. Can be one of: 'private', 'public', or 'unlisted'.
`...`	Additional arguments passed to `tuber_POST`.

Value

The created playlist's details.

References

https://developers.google.com/youtube/v3/docs/playlists/insert

Examples

## Not run: 

# Set API token via yt_oauth() first

create_playlist(title = "My New Playlist", description = "This is a test playlist.")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

create_playlist(title = "My New Playlist", description = "This is a test playlist.")

## End(Not run)

Delete a Particular Caption Track

Description

Delete a Particular Caption Track

Usage

delete_captions(id = NULL, ...)
delete_captions(id = NULL, ...)

Arguments

`id`	String. Required. id of the caption track that is being retrieved
`...`	Additional arguments passed to `tuber_DELETE`.

References

https://developers.google.com/youtube/v3/docs/captions/delete

Examples

## Not run: 

# Set API token via yt_oauth() first

delete_captions(id = "y3ElXcEME3lSISz6izkWVT5GvxjPu8pA")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

delete_captions(id = "y3ElXcEME3lSISz6izkWVT5GvxjPu8pA")

## End(Not run)

Delete Channel Sections

Description

Delete a Channel Section

Usage

delete_channel_sections(id = NULL, ...)
delete_channel_sections(id = NULL, ...)

Arguments

`id`	Required. ID of the channel section.
`...`	Additional arguments passed to `tuber_DELETE`.

References

https://developers.google.com/youtube/v3/docs/channelSections/delete

Examples


## Not run: 

# Set API token via yt_oauth() first

delete_channel_sections(c(channel_id = "UCRw8bIz2wMLmfgAgWm903cA"))

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

delete_channel_sections(c(channel_id = "UCRw8bIz2wMLmfgAgWm903cA"))

## End(Not run)

Delete a Particular Comment

Description

Delete a Particular Comment

Usage

delete_comments(id = NULL, ...)
delete_comments(id = NULL, ...)

Arguments

`id`	String. Required. id of the comment being retrieved
`...`	Additional arguments passed to `tuber_DELETE`.

References

https://developers.google.com/youtube/v3/docs/comments/delete

Examples

## Not run: 

# Set API token via yt_oauth() first

delete_comments(id = "y3ElXcEME3lSISz6izkWVT5GvxjPu8pA")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

delete_comments(id = "y3ElXcEME3lSISz6izkWVT5GvxjPu8pA")

## End(Not run)

Delete a Playlist Item

Description

Delete a Playlist Item

Usage

delete_playlist_items(id = NULL, ...)
delete_playlist_items(id = NULL, ...)

Arguments

`id`	String. Required. id of the playlist item that is to be deleted
`...`	Additional arguments passed to `tuber_DELETE`.

References

https://developers.google.com/youtube/v3/docs/playlistItems/delete

Examples

## Not run: 

# Set API token via yt_oauth() first

delete_playlist_items(id = "YourPlaylistItemID")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

delete_playlist_items(id = "YourPlaylistItemID")

## End(Not run)

Delete a Playlist

Description

Delete a Playlist

Usage

delete_playlists(id = NULL, ...)
delete_playlists(id = NULL, ...)

Arguments

`id`	String. Required. id of the playlist that is to be deleted
`...`	Additional arguments passed to `tuber_DELETE`.

References

https://developers.google.com/youtube/v3/docs/playlists/delete

Examples

## Not run: 

# Set API token via yt_oauth() first

delete_playlists(id = "y3ElXcEME3lSISz6izkWVT5GvxjPu8pA")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

delete_playlists(id = "y3ElXcEME3lSISz6izkWVT5GvxjPu8pA")

## End(Not run)

Delete a Video

Description

Delete a Video

Usage

delete_videos(id = NULL, ...)
delete_videos(id = NULL, ...)

Arguments

`id`	String. Required. id of the video that is to be deleted
`...`	Additional arguments passed to `tuber_DELETE`.

References

https://developers.google.com/youtube/v3/docs/playlistItems/delete

Examples

## Not run: 

# Set API token via yt_oauth() first

delete_videos(id = "y3ElXcEME3lSISz6izkWVT5GvxjPu8pA")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

delete_videos(id = "y3ElXcEME3lSISz6izkWVT5GvxjPu8pA")

## End(Not run)

Get statistics on all the videos in a Channel

Description

Get statistics on all the videos in a Channel

Usage

get_all_channel_video_stats(channel_id = NULL, mine = FALSE, ...)
get_all_channel_video_stats(channel_id = NULL, mine = FALSE, ...)

Arguments

`channel_id`	Character. Id of the channel
`mine`	Boolean. TRUE if you want to fetch stats of your own channel. Default is FALSE.
`...`	Additional arguments passed to `tuber_GET`.

Value

nested named list with top element names: kind, etag, id, snippet (list of details of the channel including title) , statistics (list of 5)

If the channel_id is mistyped or there is no information, an empty list is returned

References

https://developers.google.com/youtube/v3/docs/channels/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_all_channel_video_stats(channel_id="UCxOhDvtaoXDAB336AolWs3A")
get_all_channel_video_stats(channel_id="UCMtFAi84ehTSYSE9Xo") # Incorrect channel ID

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_all_channel_video_stats(channel_id="UCxOhDvtaoXDAB336AolWs3A")
get_all_channel_video_stats(channel_id="UCMtFAi84ehTSYSE9Xo") # Incorrect channel ID

## End(Not run)

Get all the comments for a video including replies

Description

Get all the comments for a video including replies

Usage

get_all_comments(video_id = NULL, ...)
get_all_comments(video_id = NULL, ...)

Arguments

`video_id`	string; Required. `video_id`: video ID.
`...`	Additional arguments passed to `tuber_GET`.

Value

a data.frame with the following columns: authorDisplayName, authorProfileImageUrl, authorChannelUrl, authorChannelId.value, videoId, textDisplay, canRate, viewerRating, likeCount, publishedAt, updatedAt, id, moderationStatus, parentId

References

https://developers.google.com/youtube/v3/docs/commentThreads/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_all_comments(video_id = "a-UQz7fqR3w")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_all_comments(video_id = "a-UQz7fqR3w")

## End(Not run)

Get Particular Caption Track

Description

For getting captions from the v3 API, you must specify the id resource. Check list_caption_tracks for more information.

Usage

get_captions(id = NULL, lang = "en", format = "sbv", as_raw = TRUE, ...)
get_captions(id = NULL, lang = "en", format = "sbv", as_raw = TRUE, ...)

Arguments

`id`	String. Required. id of the caption track that is being retrieved
`lang`	Optional. Default is `en`.
`format`	Optional. Default is `sbv`.
`as_raw`	If `FALSE` the captions be converted to a character string versus a raw vector
`...`	Additional arguments passed to `tuber_GET`.

Value

String.

References

https://developers.google.com/youtube/v3/docs/captions/download

Examples

## Not run: 

# Set API token via yt_oauth() first

get_captions(id = "y3ElXcEME3lSISz6izkWVT5GvxjPu8pA")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_captions(id = "y3ElXcEME3lSISz6izkWVT5GvxjPu8pA")

## End(Not run)

Get statistics of a Channel

Description

Get statistics of a Channel

Usage

get_channel_stats(channel_id = NULL, mine = NULL, ...)

list_my_channel(...)
get_channel_stats(channel_id = NULL, mine = NULL, ...)

list_my_channel(...)

Arguments

`channel_id`	Character. Id of the channel
`mine`	Boolean. TRUE if you want to fetch stats of your own channel. Default is NULL.
`...`	Additional arguments passed to `tuber_GET`.

Value

nested named list with top element names: kind, etag, id, snippet (list of details of the channel including title), statistics (list of 5)

If the channel_id is mistyped or there is no information, an empty list is returned

References

https://developers.google.com/youtube/v3/docs/channels/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_channel_stats(channel_id="UCMtFAi84ehTSYSE9XoHefig")
get_channel_stats(channel_id="UCMtFAi84ehTSYSE9Xo") # Incorrect channel ID

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_channel_stats(channel_id="UCMtFAi84ehTSYSE9XoHefig")
get_channel_stats(channel_id="UCMtFAi84ehTSYSE9Xo") # Incorrect channel ID

## End(Not run)

Get Comments Threads

Description

Get Comments Threads

Usage

get_comment_threads(
  filter = NULL,
  part = "snippet",
  text_format = "html",
  simplify = TRUE,
  max_results = 100,
  page_token = NULL,
  ...
)
get_comment_threads(
  filter = NULL,
  part = "snippet",
  text_format = "html",
  simplify = TRUE,
  max_results = 100,
  page_token = NULL,
  ...
)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `video_id`: video ID. `channel_id`: channel ID. `thread_id`: comma-separated list of comment thread IDs `threads_related_to_channel`: channel ID.
`part`	Comment resource requested. Required. Comma separated list of one or more of the following: `id, snippet`. e.g., `"id, snippet"`, `"id"`, etc. Default: `snippet`.
`text_format`	Data Type: Character. Default is `"html"`. Only takes `"html"` or `"plainText"`. Optional.
`simplify`	Data Type: Boolean. Default is `TRUE`. If `TRUE`, the function returns a data frame. Else a list with all the information returned.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Default is 100. If the value is greater than 100 then the function fetches all the results. The outcome is a simplified `data.frame`.
`page_token`	Specific page in the result set that should be returned. Optional.
`...`	Additional arguments passed to `tuber_GET`.

Value

Nested named list. The entry items is a list of comments along with meta information. Within each of the items is an item snippet which has an item topLevelComment$snippet$textDisplay that contains the actual comment.

If simplify is TRUE, a data.frame with the following columns: authorDisplayName, authorProfileImageUrl, authorChannelUrl, authorChannelId.value, videoId, textDisplay, canRate, viewerRating, likeCount, publishedAt, updatedAt

References

https://developers.google.com/youtube/v3/docs/commentThreads/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_comment_threads(filter = c(video_id = "N708P-A45D0"))
get_comment_threads(filter = c(video_id = "N708P-A45D0"), max_results = 101)

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_comment_threads(filter = c(video_id = "N708P-A45D0"))
get_comment_threads(filter = c(video_id = "N708P-A45D0"), max_results = 101)

## End(Not run)

Get Comments

Description

Get Comments

Usage

get_comments(
  filter = NULL,
  part = "snippet",
  max_results = 100,
  text_format = "html",
  page_token = NULL,
  simplify = TRUE,
  ...
)
get_comments(
  filter = NULL,
  part = "snippet",
  max_results = 100,
  text_format = "html",
  page_token = NULL,
  simplify = TRUE,
  ...
)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `comment_id`: comment ID. `parent_id`: parent ID.
`part`	Comment resource requested. Required. Comma separated list of one or more of the following: `id, snippet`. e.g., `"id, snippet"`, `"id"`, etc. Default: `snippet`.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Can be between 20 and 100. Default is 100.
`text_format`	Data Type: Character. Default is `"html"`. Only takes `"html"` or `"plainText"`. Optional.
`page_token`	Specific page in the result set that should be returned. Optional.
`simplify`	Data Type: Boolean. Default is TRUE. If TRUE, the function returns a data frame. Else a list with all the information returned.
`...`	Additional arguments passed to `tuber_GET`.

Value

When filter is comment_id, and simplify is TRUE, and there is a correct comment id, it returns a data.frame with the following cols: id, authorDisplayName, authorProfileImageUrl, authorChannelUrl, value, textDisplay, canRate, viewerRating, likeCount publishedAt, updatedAt

References

https://developers.google.com/youtube/v3/docs/comments/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_comments(filter = c(comment_id = "z13dh13j5rr0wbmzq04cifrhtuypwl4hsdk"))
get_comments(filter = c(parent_id = "z13ds5yxjq3zzptyx04chlkbhx2yh3ezxtc0k"))
get_comments(filter =
c(comment_id = "z13dh13j5rr0wbmzq04cifrhtuypwl4hsdk,
             z13dh13j5rr0wbmzq04cifrhtuypwl4hsdk"))

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_comments(filter = c(comment_id = "z13dh13j5rr0wbmzq04cifrhtuypwl4hsdk"))
get_comments(filter = c(parent_id = "z13ds5yxjq3zzptyx04chlkbhx2yh3ezxtc0k"))
get_comments(filter =
c(comment_id = "z13dh13j5rr0wbmzq04cifrhtuypwl4hsdk,
             z13dh13j5rr0wbmzq04cifrhtuypwl4hsdk"))

## End(Not run)

Get Playlist Item IDs

Description

Get Playlist Item IDs

Usage

get_playlist_item_ids(
  filter = NULL,
  part = "contentDetails",
  max_results = 50,
  video_id = NULL,
  page_token = NULL,
  simplify = TRUE,
  ...
)
get_playlist_item_ids(
  filter = NULL,
  part = "contentDetails",
  max_results = 50,
  video_id = NULL,
  page_token = NULL,
  simplify = TRUE,
  ...
)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `item_id`: comma-separated list of one or more unique playlist item IDs. `playlist_id`: YouTube playlist ID.
`part`	Required. Comma separated string including one or more of the following: `contentDetails, id, snippet, status`. Default: `contentDetails`.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Default is 50. If over 50, all the results are returned.
`video_id`	Optional. request should return only the playlist items that contain the specified video.
`page_token`	specific page in the result set that should be returned, optional
`simplify`	returns a data.frame rather than a list.
`...`	Additional arguments passed to `tuber_GET`.

Value

playlist items

References

https://developers.google.com/youtube/v3/docs/playlists/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_playlist_items(filter =
                       c(playlist_id = "PLrEnWoR732-CN09YykVof2lxdI3MLOZda"))
get_playlist_items(filter =
                       c(playlist_id = "PL0fOlXVeVW9QMO3GoESky4yDgQfK2SsXN"),
                       max_results = 51)

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_playlist_items(filter =
                       c(playlist_id = "PLrEnWoR732-CN09YykVof2lxdI3MLOZda"))
get_playlist_items(filter =
                       c(playlist_id = "PL0fOlXVeVW9QMO3GoESky4yDgQfK2SsXN"),
                       max_results = 51)

## End(Not run)

Get Playlist Item Video IDs

Description

Get Playlist Item Video IDs

Usage

get_playlist_item_videoids(
  filter = NULL,
  part = "contentDetails",
  max_results = 50,
  video_id = NULL,
  page_token = NULL,
  simplify = TRUE,
  ...
)
get_playlist_item_videoids(
  filter = NULL,
  part = "contentDetails",
  max_results = 50,
  video_id = NULL,
  page_token = NULL,
  simplify = TRUE,
  ...
)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `item_id`: comma-separated list of one or more unique playlist item IDs. `playlist_id`: YouTube playlist ID.
`part`	Required. Comma separated string including one or more of the following: `contentDetails, id, snippet, status`. Default: `contentDetails`.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Default is 50. If over 50, all the results are returned.
`video_id`	Optional. request should return only the playlist items that contain the specified video.
`page_token`	specific page in the result set that should be returned, optional
`simplify`	returns a data.frame rather than a list.
`...`	Additional arguments passed to `tuber_GET`.

Value

playlist items

References

https://developers.google.com/youtube/v3/docs/playlists/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_playlist_items(filter =
                       c(playlist_id = "YourPlaylistID"))
get_playlist_items(filter =
                       c(playlist_id = "YourPlaylistID"),
                       max_results = 51)

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_playlist_items(filter =
                       c(playlist_id = "YourPlaylistID"))
get_playlist_items(filter =
                       c(playlist_id = "YourPlaylistID"),
                       max_results = 51)

## End(Not run)

Get Playlist Items

Description

Get Playlist Items

Usage

get_playlist_items(
  filter = NULL,
  part = "contentDetails",
  max_results = 50,
  video_id = NULL,
  page_token = NULL,
  simplify = TRUE,
  ...
)
get_playlist_items(
  filter = NULL,
  part = "contentDetails",
  max_results = 50,
  video_id = NULL,
  page_token = NULL,
  simplify = TRUE,
  ...
)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `item_id`: comma-separated list of one or more unique playlist item IDs. `playlist_id`: YouTube playlist ID.
`part`	Required. Comma separated string including one or more of the following: `contentDetails, id, snippet, status`. Default: `contentDetails`.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Default is 50. If over 50, all the results are returned.
`video_id`	Optional. request should return only the playlist items that contain the specified video.
`page_token`	specific page in the result set that should be returned, optional
`simplify`	returns a data.frame rather than a list.
`...`	Additional arguments passed to `tuber_GET`.

Value

playlist items

References

https://developers.google.com/youtube/v3/docs/playlists/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_playlist_items(filter =
                       c(playlist_id = "PLrEnWoR732-CN09YykVof2lxdI3MLOZda"))
get_playlist_items(filter =
                       c(playlist_id = "PL0fOlXVeVW9QMO3GoESky4yDgQfK2SsXN"),
                       max_results = 51)

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_playlist_items(filter =
                       c(playlist_id = "PLrEnWoR732-CN09YykVof2lxdI3MLOZda"))
get_playlist_items(filter =
                       c(playlist_id = "PL0fOlXVeVW9QMO3GoESky4yDgQfK2SsXN"),
                       max_results = 51)

## End(Not run)

Get Playlists

Description

Get Playlists

Usage

get_playlists(
  filter = NULL,
  part = "snippet",
  max_results = 50,
  hl = NULL,
  page_token = NULL,
  simplify = TRUE,
  ...
)
get_playlists(
  filter = NULL,
  part = "snippet",
  max_results = 50,
  hl = NULL,
  page_token = NULL,
  simplify = TRUE,
  ...
)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `channel_id`: ID of the channel `playlist_id`: YouTube playlist ID.
`part`	Required. One of the following: `contentDetails, id, localizations, player, snippet, status`. Default: `contentDetails`.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Can be between 0 and 50. Default is 50.
`hl`	Language used for text values. Optional. Default is `en-US`. For other allowed language codes, see `list_langs`.
`page_token`	specific page in the result set that should be returned, optional
`simplify`	Data Type: Boolean. Default is `TRUE`. If `TRUE` and if part requested is `contentDetails`, the function returns a `data.frame`. Else a list with all the information returned.
`...`	Additional arguments passed to `tuber_GET`.

Value

playlists When simplify is TRUE, a data.frame with 4 columns is returned: kind, etag, id, contentDetails.itemCount

References

https://developers.google.com/youtube/v3/docs/playlists/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_playlists(filter=c(channel_id="UCMtFAi84ehTSYSE9XoHefig"))
get_playlists(filter=c(channel_id="UCMtFAi84ehTSYSE9X")) # incorrect Channel ID

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_playlists(filter=c(channel_id="UCMtFAi84ehTSYSE9XoHefig"))
get_playlists(filter=c(channel_id="UCMtFAi84ehTSYSE9X")) # incorrect Channel ID

## End(Not run)

Get Related Videos

Description

Takes a video id and returns related videos

Usage

get_related_videos(
  video_id = NULL,
  max_results = 50,
  safe_search = "none",
  ...
)
get_related_videos(
  video_id = NULL,
  max_results = 50,
  safe_search = "none",
  ...
)

Arguments

`video_id`	Character. Required. No default.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Can be between 0 and 50. Default is 50.
`safe_search`	Character. Optional. Takes one of three values: `'moderate'`, `'none'` (default) or `'strict'`
`...`	Additional arguments passed to `tuber_GET`.

Value

data.frame with 16 columns: video_id, rel_video_id, publishedAt, channelId, title, description, thumbnails.default.url, thumbnails.default.width, thumbnails.default.height, thumbnails.medium.url, thumbnails.medium.width, thumbnails.medium.height, thumbnails.high.url, thumbnails.high.width, thumbnails.high.height, channelTitle, liveBroadcastContent

References

https://developers.google.com/youtube/v3/docs/search/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_related_videos(video_id = "yJXTXN4xrI8")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_related_videos(video_id = "yJXTXN4xrI8")

## End(Not run)

Get statistics of a Video

Description

Get statistics of a Video

Usage

get_stats(video_id = NULL, ...)
get_stats(video_id = NULL, ...)

Arguments

`video_id`	Character. Id of the video. Required.
`...`	Additional arguments passed to `tuber_GET`.

Value

list with 6 elements: id, viewCount, likeCount, dislikeCount, favoriteCount, commentCount

References

https://developers.google.com/youtube/v3/docs/videos/list#parameters

Examples

## Not run: 

# Set API token via yt_oauth() first

get_stats(video_id="N708P-A45D0")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_stats(video_id="N708P-A45D0")

## End(Not run)

Get Subscriptions

Description

Get Subscriptions

Usage

get_subscriptions(
  filter = NULL,
  part = "contentDetails",
  max_results = 50,
  for_channel_id = NULL,
  order = NULL,
  page_token = NULL,
  ...
)
get_subscriptions(
  filter = NULL,
  part = "contentDetails",
  max_results = 50,
  for_channel_id = NULL,
  order = NULL,
  page_token = NULL,
  ...
)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `channel_id`: ID of the channel. Required. No default. `subscription_id`: YouTube subscription ID
`part`	Part of the resource requested. Required. Character. A comma separated list of one or more of the following: `contentDetails, id, snippet, subscriberSnippet`. e.g. "id, snippet", "id", etc. Default: `contentDetails`.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Can be between 0 and 50. Default is 50.
`for_channel_id`	Optional. String. A comma-separated list of channel IDs. Limits response to subscriptions matching those channels.
`order`	method that will be used to sort resources in the API response. Takes one of the following: alphabetical, relevance, unread
`page_token`	Specific page in the result set that should be returned. Optional. String.
`...`	Additional arguments passed to `tuber_GET`.

Value

named list of subscriptions

References

https://developers.google.com/youtube/v3/docs/subscriptions/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_subscriptions(filter = c(channel_id = "UChTJTbr5kf3hYazJZO-euHg"))

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

get_subscriptions(filter = c(channel_id = "UChTJTbr5kf3hYazJZO-euHg"))

## End(Not run)

Get Details of a Video or Videos

Description

Get details such as when the video was published, the title, description, thumbnails, category etc.

Usage

get_video_details(
  video_id = NULL,
  part = "snippet",
  as.data.frame = FALSE,
  ...
)
get_video_details(
  video_id = NULL,
  part = "snippet",
  as.data.frame = FALSE,
  ...
)

Arguments

`video_id`	Comma separated list of IDs of the videos for which details are requested. Required.
`part`	Comma-separated vector of video resource properties requested. Options include: `contentDetails, fileDetails, id, liveStreamingDetails, localizations, player, processingDetails, recordingDetails, snippet, statistics, status, suggestions, topicDetails`
`as.data.frame`	Logical, returns the requested information as data.frame. Does not work for: `fileDetails, suggestions, processingDetails`
`...`	Additional arguments passed to `tuber_GET`.

Value

list. If part is snippet, the list will have the following elements: id (video id that was passed), publishedAt, channelId, title, description, thumbnails, channelTitle, categoryId, liveBroadcastContent, localized, defaultAudioLanguage

References

https://developers.google.com/youtube/v3/docs/videos/list

Examples

## Not run: 

# Set API token via yt_oauth() first

get_video_details(video_id = "yJXTXN4xrI8")
get_video_details(video_id = "yJXTXN4xrI8", part = "contentDetails")
# retrieve multiple parameters
get_video_details(video_id = "yJXTXN4xrI8", part = c("contentDetails", "status"))
# get details for multiple videos as data frame
get_video_details(video_id = c("LDZX4ooRsWs", "yJXTXN4xrI8"), as.data.frame = TRUE)

## End(Not run)

## Not run: 

# Set API token via yt_oauth() first

get_video_details(video_id = "yJXTXN4xrI8")
get_video_details(video_id = "yJXTXN4xrI8", part = "contentDetails")
# retrieve multiple parameters
get_video_details(video_id = "yJXTXN4xrI8", part = c("contentDetails", "status"))
# get details for multiple videos as data frame
get_video_details(video_id = c("LDZX4ooRsWs", "yJXTXN4xrI8"), as.data.frame = TRUE)

## End(Not run)

List reasons that can be used to report abusive videos

Description

List reasons that can be used to report abusive videos

Usage

list_abuse_report_reasons(part = "id, snippet", hl = "en-US", ...)
list_abuse_report_reasons(part = "id, snippet", hl = "en-US", ...)

Arguments

`part`	Caption resource requested. Required. Comma separated list of one or more of the following: `id, snippet`. e.g., `"id, snippet"`, `"id"`, etc. Default: `snippet`.
`hl`	Language used for text values. Optional. Default is `en-US`. For other allowed language codes, see `list_langs`.
`...`	Additional arguments passed to `tuber_GET`.

Value

If no results, empty data.frame returned If part requested = "id, snippet" or "snippet", data.frame with 4 columns: etag, id, label, secReasons If part requested = "id", data.frame with 2 columns: etag, id

References

https://developers.google.com/youtube/v3/docs/videoAbuseReportReasons/list

Examples

## Not run: 

# Set API token via yt_oauth() first

list_abuse_report_reasons()
list_abuse_report_reasons(part="id")
list_abuse_report_reasons(part="snippet")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_abuse_report_reasons()
list_abuse_report_reasons(part="id")
list_abuse_report_reasons(part="snippet")

## End(Not run)

List Captions of a Video

Description

List Captions of a Video

Usage

list_caption_tracks(
  part = "snippet",
  video_id = NULL,
  lang = "en",
  id = NULL,
  simplify = TRUE,
  ...
)
list_caption_tracks(
  part = "snippet",
  video_id = NULL,
  lang = "en",
  id = NULL,
  simplify = TRUE,
  ...
)

Arguments

`part`	Caption resource requested. Required. Comma separated list of one or more of the following: `id, snippet`. e.g., "id, snippet", "id" Default: `snippet`.
`video_id`	ID of the video whose captions are requested. Required. No default.
`lang`	Language of the caption; required; default is English ("en")
`id`	comma-separated list of IDs that identify the caption resources that should be retrieved; optional; string
`simplify`	Boolean. Default is TRUE. When TRUE, and part is `snippet`, a data.frame is returned
`...`	Additional arguments passed to `tuber_GET`.

Value

list of caption tracks. When simplify is TRUE, a data.frame is returned with following columns: videoId, lastUpdated, trackKind, language, name, audioTrackType, isCC, isLarge, isEasyReader, isDraft, isAutoSynced, status, id (caption id)

References

https://developers.google.com/youtube/v3/docs/captions/list

Examples

## Not run: 

# Set API token via yt_oauth() first

list_caption_tracks(video_id = "yJXTXN4xrI8")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_caption_tracks(video_id = "yJXTXN4xrI8")

## End(Not run)

Upload Video to Youtube

Description

Upload Video to Youtube

Usage

list_captions(video_id, query = NULL, ...)
list_captions(video_id, query = NULL, ...)

Arguments

`video_id`	ID of the YouTube video
`query`	Fields for 'query' in 'GET'
`...`	Additional arguments to send to `tuber_GET` and therefore `GET`

Value

A list of the response object from the GET and content about captions

Examples

## Not run: 
video_id <- "M7FIvfx5J10"
list_captions(video_id)

## End(Not run)
## Not run: 
video_id <- "M7FIvfx5J10"
list_captions(video_id)

## End(Not run)

List Channel Activity

Description

Returns a list of channel events that match the request criteria.

Usage

list_channel_activities(
  filter = NULL,
  part = "snippet",
  max_results = 50,
  page_token = NULL,
  published_after = NULL,
  published_before = NULL,
  region_code = NULL,
  simplify = TRUE,
  ...
)
list_channel_activities(
  filter = NULL,
  part = "snippet",
  max_results = 50,
  page_token = NULL,
  published_after = NULL,
  published_before = NULL,
  region_code = NULL,
  simplify = TRUE,
  ...
)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `channel_id`: ID of the channel. Required. No default.
`part`	specify which part do you want. It can only be one of the three: `contentDetails, id, snippet`. Default is `snippet`.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Can be between 0 and 50. Default is 50.
`page_token`	specific page in the result set that should be returned, optional
`published_after`	Character. Optional. RFC 339 Format. For instance, "1970-01-01T00:00:00Z"
`published_before`	Character. Optional. RFC 339 Format. For instance, "1970-01-01T00:00:00Z"
`region_code`	ISO 3166-1 alpha-2 country code, optional, see also `list_regions`
`simplify`	Data Type: Boolean. Default is `TRUE`. If `TRUE` and if part requested is `contentDetails`, the function returns a `data.frame`. Else a list with all the information returned.
`...`	Additional arguments passed to `tuber_GET`.

Value

named list If simplify is TRUE, a data.frame is returned with 18 columns: publishedAt, channelId, title, description, thumbnails.default.url, thumbnails.default.width, thumbnails.default.height, thumbnails.medium.url, thumbnails.medium.width, thumbnails.medium.height, thumbnails.high.url, thumbnails.high.width, thumbnails.high.height, thumbnails.standard.url, thumbnails.standard.width, thumbnails.standard.height, channelTitle, type

References

https://developers.google.com/youtube/v3/docs/activities/list

Examples

## Not run: 

# Set API token via yt_oauth() first

list_channel_activities(filter = c(channel_id = "UCRw8bIz2wMLmfgAgWm903cA"))
list_channel_activities(filter = c(channel_id = "UCRw8bIz2wMLmfgAgWm903cA", regionCode="US"))
list_channel_activities(filter = c(channel_id = "UCMtFAi84ehTSYSE9XoHefig"),
                        published_before = "2016-02-10T00:00:00Z",
                        published_after = "2016-01-01T00:00:00Z")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_channel_activities(filter = c(channel_id = "UCRw8bIz2wMLmfgAgWm903cA"))
list_channel_activities(filter = c(channel_id = "UCRw8bIz2wMLmfgAgWm903cA", regionCode="US"))
list_channel_activities(filter = c(channel_id = "UCMtFAi84ehTSYSE9XoHefig"),
                        published_before = "2016-02-10T00:00:00Z",
                        published_after = "2016-01-01T00:00:00Z")

## End(Not run)

Returns List of Requested Channel Resources

Description

Returns List of Requested Channel Resources

Usage

list_channel_resources(
  filter = NULL,
  part = "contentDetails",
  max_results = 50,
  page_token = NULL,
  hl = "en-US",
  ...
)
list_channel_resources(
  filter = NULL,
  part = "contentDetails",
  max_results = 50,
  page_token = NULL,
  hl = "en-US",
  ...
)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `category_id`: YouTube guide category that returns channels associated with that category `username`: YouTube username that returns channel associated with that username. `channel_id`: a comma-separated list of the YouTube channel ID(s) for the resource(s) that are being retrieved
`part`	a comma separated list of channel resource properties that response will include string. Required. One of the following: `auditDetails, brandingSettings, contentDetails, contentOwnerDetails, id, invideoPromotion, localizations, snippet, statistics, status, topicDetails`. Default is `contentDetails`.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Can be between 0 and 50. Default is 50.
`page_token`	specific page in the result set that should be returned, optional
`hl`	Language used for text values. Optional. Default is `en-US`. For other allowed language codes, see `list_langs`.
`...`	Additional arguments passed to `tuber_GET`.

Value

list

References

https://developers.google.com/youtube/v3/docs/channels/list

Examples


## Not run: 

# Set API token via yt_oauth() first

list_channel_resources(filter = c(channel_id = "UCT5Cx1l4IS3wHkJXNyuj4TA"))
list_channel_resources(filter = c(username = "latenight"), part = "id, contentDetails")
list_channel_resources(filter = c(username = "latenight"), part = "id, contentDetails",
max_results = 10)

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_channel_resources(filter = c(channel_id = "UCT5Cx1l4IS3wHkJXNyuj4TA"))
list_channel_resources(filter = c(username = "latenight"), part = "id, contentDetails")
list_channel_resources(filter = c(username = "latenight"), part = "id, contentDetails",
max_results = 10)

## End(Not run)

List Channel Sections

Description

Returns list of channel sections that channel id belongs to.

Usage

list_channel_sections(filter = NULL, part = "snippet", hl = NULL, ...)
list_channel_sections(filter = NULL, part = "snippet", hl = NULL, ...)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `channel_id`: Channel ID `id`: Section ID
`part`	specify which part do you want. It can only be one of the following: `contentDetails, id, localizations, snippet, targeting`. Default is `snippet`.
`hl`	language that will be used for text values, optional, default is en-US. See also `list_langs`
`...`	Additional arguments passed to `tuber_GET`.

Value

captions for the video from one of the first track

References

https://developers.google.com/youtube/v3/docs/activities/list

Examples


## Not run: 

# Set API token via yt_oauth() first

list_channel_sections(c(channel_id = "UCRw8bIz2wMLmfgAgWm903cA"))

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_channel_sections(c(channel_id = "UCRw8bIz2wMLmfgAgWm903cA"))

## End(Not run)

Returns List of Requested Channel Videos

Description

Iterate through the max_results number of playlists in channel and get the videos for each of the playlists.

Usage

list_channel_videos(
  channel_id = NULL,
  max_results = 50,
  page_token = NULL,
  hl = "en-US",
  ...
)
list_channel_videos(
  channel_id = NULL,
  max_results = 50,
  page_token = NULL,
  hl = "en-US",
  ...
)

Arguments

`channel_id`	String. ID of the channel. Required.
`max_results`	Maximum number of videos returned. Integer. Default is 50. If the number is over 50, all the videos will be returned.
`page_token`	Specific page in the result set that should be returned. Optional.
`hl`	Language used for text values. Optional. Default is `en-US`. For other allowed language codes, see `list_langs`
`...`	Additional arguments passed to `tuber_GET`.

Value

list of data.frame with each list corresponding to a different playlist

References

https://developers.google.com/youtube/v3/docs/channels/list

Examples


## Not run: 

# Set API token via yt_oauth() first

list_channel_videos(channel_id = "UCXOKEdfOFxsHO_-Su3K8SHg")
list_channel_videos(channel_id = "UCXOKEdfOFxsHO_-Su3K8SHg", max_results = 10)

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_channel_videos(channel_id = "UCXOKEdfOFxsHO_-Su3K8SHg")
list_channel_videos(channel_id = "UCXOKEdfOFxsHO_-Su3K8SHg", max_results = 10)

## End(Not run)

Get list of categories that can be associated with YouTube channels

Description

Get list of categories that can be associated with YouTube channels

Usage

list_guidecats(filter = NULL, hl = NULL, ...)
list_guidecats(filter = NULL, hl = NULL, ...)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `region_code`: Character. Required. Has to be a ISO 3166-1 alpha-2 code (see https://www.iso.org/obp/ui/#search) `category_id`: YouTube channel category ID
`hl`	Language used for text values. Optional. Default is `en-US`. For other allowed language codes, see `list_langs`.
`...`	Additional arguments passed to `tuber_GET`.

Value

data.frame with 5 columns: region_code, channelId, title, etag, id

References

https://developers.google.com/youtube/v3/docs/guideCategories/list

Examples

## Not run: 

# Set API token via yt_oauth() first

list_guidecats(c(region_code = "JP"))

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_guidecats(c(region_code = "JP"))

## End(Not run)

List Languages That YouTube Currently Supports

Description

List Languages That YouTube Currently Supports

Usage

list_langs(hl = NULL, ...)
list_langs(hl = NULL, ...)

Arguments

`hl`	Language used for text values. Optional. Default is `en-US`. For other allowed language codes, see `list_langs`.
`...`	Additional arguments passed to `tuber_GET`.

Value

data.frame with 3 columns: hl (two letter abbreviation), name (of the language), etag

References

https://developers.google.com/youtube/v3/docs/i18nLanguages/list

Examples

## Not run: 

# Set API token via yt_oauth() first

list_langs()

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_langs()

## End(Not run)

List My videos

Description

List My videos

Usage

list_my_videos(...)
list_my_videos(...)

Arguments

...

additional arguments to pass to list_channel_videos

Value

data.frame with each list corresponding to a different playlist

Examples

## Not run: 
  list_my_videos()

## End(Not run)

## Not run: 
  list_my_videos()

## End(Not run)

List Content Regions That YouTube Currently Supports

Description

List Content Regions That YouTube Currently Supports

Usage

list_regions(hl = NULL, ...)
list_regions(hl = NULL, ...)

Arguments

`hl`	Language used for text values. Optional. Default is `en-US`. For other allowed language codes, see `list_langs`.
`...`	Additional arguments passed to `tuber_GET`.

Value

data.frame with 3 columns: gl (two letter abbreviation), name (of the region), etag

References

https://developers.google.com/youtube/v3/docs/i18nRegions/list

Examples

## Not run: 

# Set API token via yt_oauth() first

list_regions()

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_regions()

## End(Not run)

List of Categories That Can be Associated with Videos

Description

List of Categories That Can be Associated with Videos

Usage

list_videocats(filter = NULL, ...)
list_videocats(filter = NULL, ...)

Arguments

`filter`	string; Required. named vector of length 1 potential names of the entry in the vector: `region_code`: Character. Required. Has to be a ISO 3166-1 alpha-2 code (see https://www.iso.org/obp/ui/#search) `category_id`: video category ID
`...`	Additional arguments passed to `tuber_GET`.

Value

data.frame with 6 columns: region_code, channelId, title, assignable, etag, id

References

https://developers.google.com/youtube/v3/docs/videoCategories/list

Examples

## Not run: 

# Set API token via yt_oauth() first

list_videocats(c(region_code = "JP"))
list_videocats() # Will throw an error asking for a valid filter with valid region_code

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_videocats(c(region_code = "JP"))
list_videocats() # Will throw an error asking for a valid filter with valid region_code

## End(Not run)

List (Most Popular) Videos

Description

List (Most Popular) Videos

Usage

list_videos(
  part = "contentDetails",
  max_results = 50,
  page_token = NULL,
  hl = NULL,
  region_code = NULL,
  video_category_id = NULL,
  ...
)
list_videos(
  part = "contentDetails",
  max_results = 50,
  page_token = NULL,
  hl = NULL,
  region_code = NULL,
  video_category_id = NULL,
  ...
)

Arguments

`part`	Required. Comma separated string including one or more of the following: `contentDetails, fileDetails, id, liveStreamingDetails, localizations, player, processingDetails, recordingDetails, snippet, statistics, status, suggestions, topicDetails`. Default: `contentDetails`.
`max_results`	Maximum number of items that should be returned. Integer. Optional. Can be between 0 and 50. Default is 50.
`page_token`	specific page in the result set that should be returned, optional
`hl`	Language used for text values. Optional. Default is `en-US`. For other allowed language codes, see `list_langs`.
`region_code`	Character. Required. Has to be a ISO 3166-1 alpha-2 code (see https://www.iso.org/obp/ui/#search).
`video_category_id`	the video category for which the chart should be retrieved. See also `list_videocats`.
`...`	Additional arguments passed to `tuber_GET`.

Value

data.frame with 5 columns: channelId, title, assignable, etag, id

References

https://developers.google.com/youtube/v3/docs/search/list

Examples

## Not run: 

# Set API token via yt_oauth() first

list_videos()

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

list_videos()

## End(Not run)

Read SBV file

Description

Read SBV file

Usage

read_sbv(file)
read_sbv(file)

Arguments

file

The file name of the sbv file

Value

A data.frame with start/stop times and the text

Examples

if (yt_authorized()){
vids <- list_my_videos()
res <- list_caption_tracks(video_id = vids$contentDetails.videoId[1])
cap <- get_captions(id = res$id, as_raw = FALSE)
tfile <- tempfile(fileext = ".sbv")
writeLines(cap, tfile)
x <- read_sbv(tfile)
if (requireNamespace("hms", quietly = TRUE)) {
  x$start <- hms::as_hms(x$start)
  x$stop <- hms::as_hms(x$stop)
}
}
if (yt_authorized()){
vids <- list_my_videos()
res <- list_caption_tracks(video_id = vids$contentDetails.videoId[1])
cap <- get_captions(id = res$id, as_raw = FALSE)
tfile <- tempfile(fileext = ".sbv")
writeLines(cap, tfile)
x <- read_sbv(tfile)
if (requireNamespace("hms", quietly = TRUE)) {
  x$start <- hms::as_hms(x$start)
  x$stop <- hms::as_hms(x$stop)
}
}

tuber provides access to the YouTube API V3.

Description

tuber provides access to the YouTube API V3 via RESTful calls.

Author(s)

Maintainer: Gaurav Sood [email protected]

Other contributors:

Kate Lyons [email protected] [contributor]
John Muschelli [email protected] [contributor]

Request Response Verification

Description

Request Response Verification

Usage

tuber_check(req)
tuber_check(req)

Arguments

req

request

Value

in case of failure, a message

DELETE

Description

DELETE

Usage

tuber_DELETE(path, query, ...)
tuber_DELETE(path, query, ...)

Arguments

`path`	path to specific API request URL
`query`	query list
`...`	Additional arguments passed to `GET`.

Value

list

GET

Description

GET

Usage

tuber_GET(path, query, auth = "token", ...)
tuber_GET(path, query, auth = "token", ...)

Arguments

`path`	path to specific API request URL
`query`	query list
`auth`	A character vector of the authentication method, either "token" (the default) or "key"
`...`	Additional arguments passed to `GET`.

Value

list

POST

Description

POST

Usage

tuber_POST(path, query, body = "", ...)
tuber_POST(path, query, body = "", ...)

Arguments

`path`	path to specific API request URL
`query`	query list
`body`	passing image through body
`...`	Additional arguments passed to `GET`.

Value

list

POST encoded in json

Description

POST encoded in json

Usage

tuber_POST_json(path, query, body = "", ...)
tuber_POST_json(path, query, body = "", ...)

Arguments

`path`	path to specific API request URL
`query`	query list
`body`	passing image through body
`...`	Additional arguments passed to `GET`.

Value

list

Update a YouTube Video's Metadata

Description

This function updates the metadata of an existing YouTube video using the YouTube Data API.

Usage

update_video_metadata(
  video_id,
  title,
  category_id,
  description,
  privacy_status,
  made_for_kids
)
update_video_metadata(
  video_id,
  title,
  category_id,
  description,
  privacy_status,
  made_for_kids
)

Arguments

`video_id`	A character string specifying the ID of the video you want to update.
`title`	A character string specifying the new title for the video.
`category_id`	A character string specifying the new category ID for the video.
`description`	A character string specifying the new description for the video.
`privacy_status`	A character string specifying the new privacy status for the video ('public', 'private', or 'unlisted').
`made_for_kids`	A boolean specifying whether the video is self-declared as made for kids.

Value

A list containing the server response after the update attempt.

Examples

## Not run: 
update_video_metadata(video_id = "YourVideoID",
                      title = "New Video Title",
                      category_id = "24",
                      description = "New Description",
                      privacy_status = "public",
                      made_for_kids = FALSE)

## End(Not run)
## Not run: 
update_video_metadata(video_id = "YourVideoID",
                      title = "New Video Title",
                      category_id = "24",
                      description = "New Description",
                      privacy_status = "public",
                      made_for_kids = FALSE)

## End(Not run)

Upload Video Caption to Youtube

Description

Upload Video Caption to Youtube

Usage

upload_caption(
  file,
  video_id,
  language = "en-US",
  caption_name,
  is_draft = FALSE,
  query = NULL,
  open_url = FALSE,
  ...
)
upload_caption(
  file,
  video_id,
  language = "en-US",
  caption_name,
  is_draft = FALSE,
  query = NULL,
  open_url = FALSE,
  ...
)

Arguments

`file`	Filename of the caption, probably '.srt'
`video_id`	YouTube Video ID. Try `list_my_videos` for examples.
`language`	character string of 'BCP47' language type. See http://www.rfc-editor.org/rfc/bcp/bcp47.txt for language specification
`caption_name`	character vector of the name for the caption.
`is_draft`	logical indicating whether the caption track is a draft.
`query`	Fields for 'query' in 'POST'
`open_url`	Should the video be opened using `browseURL`
`...`	Additional arguments to send to `POST`

Value

A list of the response object from the POST, content, and the URL of the video

Note

See https://developers.google.com/youtube/v3/docs/captions#resource for full specification

Examples

## Not run: 
xx = list_my_videos()
video_id = xx$contentDetails.videoId[1]
video_id = as.character(video_id)
language = "en-US"

## End(Not run)
## Not run: 
xx = list_my_videos()
video_id = xx$contentDetails.videoId[1]
video_id = as.character(video_id)
language = "en-US"

## End(Not run)

Upload Video to Youtube

Description

Upload Video to Youtube

Usage

upload_video(
  file,
  snippet = NULL,
  status = list(privacyStatus = "public"),
  query = NULL,
  open_url = FALSE,
  ...
)
upload_video(
  file,
  snippet = NULL,
  status = list(privacyStatus = "public"),
  query = NULL,
  open_url = FALSE,
  ...
)

Arguments

`file`	Filename of the video locally
`snippet`	Additional fields for the video, including 'description' and 'title'. See https://developers.google.com/youtube/v3/docs/videos#resource for other fields. Coerced to a JSON object
`status`	Additional fields to be put into the `status` input. options for 'status' are 'license' (which should hold: 'creativeCommon', or 'youtube'), 'privacyStatus', 'publicStatsViewable', 'publishAt'.
`query`	Fields for 'query' in 'POST'
`open_url`	Should the video be opened using `browseURL`
`...`	Additional arguments to send to `tuber_POST` and therefore `POST`

Value

A list of the response object from the POST, content, and the URL of the uploaded

Note

The information for 'status' and 'snippet' are at https://developers.google.com/youtube/v3/docs/videos#resource but the subset of these fields to pass in are located at: https://developers.google.com/youtube/v3/docs/videos/insert The 'part“ parameter serves two purposes in this operation. It identifies the properties that the write operation will set, this will be automatically detected by the names of 'body'. See https://developers.google.com/youtube/v3/docs/videos/insert#usage

Examples

snippet = list(
title = "Test Video",
description = "This is just a random test.",
tags = c("r language", "r programming", "data analysis")
)
status = list(privacyStatus = "private")
snippet = list(
title = "Test Video",
description = "This is just a random test.",
tags = c("r language", "r programming", "data analysis")
)
status = list(privacyStatus = "private")

Manage YouTube API key

Description

These functions manage your YouTube API key and package key in .Renviron.

Usage

yt_get_key(decrypt = FALSE)
yt_set_key(key, type)
yt_get_key(decrypt = FALSE)
yt_set_key(key, type)

Arguments

`decrypt`	A boolean vector specifying whether to decrypt the supplied key with 'httr2::secret_decrypt()'. Defaults to 'FALSE'. If 'TRUE', requires the environment variable 'TUBER_KEY' to be set in '.Renviron'.
`key`	A character vector specifying a YouTube API key.
`type`	A character vector specifying the type of API key to set. One of 'api' (the default, stored in ‘YOUTUBE_KEY') or ’package'. Package keys are stored in 'TUBER_KEY' and are used to decrypt API keys, for use in continuous integration and testing.

Value

'yt_get_key()' returns a character vector with the YouTube API key stored in '.Renviron'. If this value is not stored in '.Renviron', the functions return 'NULL'.

When the ‘type' argument is set to ’api', ‘yt_set_key()' assigns a YouTube API key to 'YOUTUBE_KEY' in '.Renviron' and invisibly returns 'NULL'. When the 'type' argument is set to ’package', 'yt_set_key()' assigns a package key to 'TUBER_KEY' in '.Renviron' and invisibly returns 'NULL'.

Examples

## Not run: 
## for interactive use
yt_get_key()

list_channel_videos(
  channel_id = "UCDgj5-mFohWZ5irWSFMFcng",
  max_results = 3,
  part = "snippet",
  auth = "key"
)

## for continuous integration and testing
yt_set_key(httr2::secret_make_key(), type = "package")
x <- httr2::secret_encrypt("YOUR_YOUTUBE_API_KEY", "TUBER_KEY")
yt_set_key(x, type = "api")
yt_get_key(decrypt = TRUE)

list_channel_videos(
  channel_id = "UCDgj5-mFohWZ5irWSFMFcng",
  max_results = 3,
  part = "snippet",
  auth = "key"
)

## End(Not run)
## Not run: 
## for interactive use
yt_get_key()

list_channel_videos(
  channel_id = "UCDgj5-mFohWZ5irWSFMFcng",
  max_results = 3,
  part = "snippet",
  auth = "key"
)

## for continuous integration and testing
yt_set_key(httr2::secret_make_key(), type = "package")
x <- httr2::secret_encrypt("YOUR_YOUTUBE_API_KEY", "TUBER_KEY")
yt_set_key(x, type = "api")
yt_get_key(decrypt = TRUE)

list_channel_videos(
  channel_id = "UCDgj5-mFohWZ5irWSFMFcng",
  max_results = 3,
  part = "snippet",
  auth = "key"
)

## End(Not run)

Set up Authorization

Description

The function looks for .httr-oauth in the working directory. If it doesn't find it, it expects an application ID and a secret. If you want to remove the existing .httr-oauth, set remove_old_oauth to TRUE. By default, it is set to FALSE. The function launches a browser to allow you to authorize the application

Usage

yt_oauth(
  app_id = NULL,
  app_secret = NULL,
  scope = "ssl",
  token = ".httr-oauth",
  ...
)
yt_oauth(
  app_id = NULL,
  app_secret = NULL,
  scope = "ssl",
  token = ".httr-oauth",
  ...
)

Arguments

`app_id`	client id; required; no default
`app_secret`	client secret; required; no default
`scope`	Character. `ssl`, `basic`, `own_account_readonly`, `upload_and_manage_own_videos`, `partner`, and `partner_audit`. Required. `ssl` and `basic` are basically interchangeable. Default is `ssl`.
`token`	path to file containing the token. If a path is given, the function will first try to read from it. Default is `.httr-oauth` in the local directory. So if there is such a file, the function will first try to read from it.
`...`	Additional arguments passed to `oauth2.0_token`

Value

sets the google_token option and also saves .httr_oauth in the working directory (find out the working directory via getwd())

References

https://developers.google.com/youtube/v3/docs/

https://developers.google.com/youtube/v3/guides/auth/client-side-web-apps for different scopes

Examples

 ## Not run: 
yt_oauth(paste0("998136489867-5t3tq1g7hbovoj46dreqd6k5kd35ctjn",
                ".apps.googleusercontent.com"),
         "MbOSt6cQhhFkwETXKur-L9rN")

## End(Not run)
## Not run: 
yt_oauth(paste0("998136489867-5t3tq1g7hbovoj46dreqd6k5kd35ctjn",
                ".apps.googleusercontent.com"),
         "MbOSt6cQhhFkwETXKur-L9rN")

## End(Not run)

Search YouTube

Description

Search for videos, channels and playlists. (By default, the function searches for videos.)

Usage

yt_search(
  term = NULL,
  max_results = 50,
  channel_id = NULL,
  channel_type = NULL,
  type = "video",
  event_type = NULL,
  location = NULL,
  location_radius = NULL,
  published_after = NULL,
  published_before = NULL,
  video_definition = "any",
  video_caption = "any",
  video_license = "any",
  video_syndicated = "any",
  region_code = NULL,
  relevance_language = "en",
  video_type = "any",
  simplify = TRUE,
  get_all = TRUE,
  page_token = NULL,
  ...
)
yt_search(
  term = NULL,
  max_results = 50,
  channel_id = NULL,
  channel_type = NULL,
  type = "video",
  event_type = NULL,
  location = NULL,
  location_radius = NULL,
  published_after = NULL,
  published_before = NULL,
  video_definition = "any",
  video_caption = "any",
  video_license = "any",
  video_syndicated = "any",
  region_code = NULL,
  relevance_language = "en",
  video_type = "any",
  simplify = TRUE,
  get_all = TRUE,
  page_token = NULL,
  ...
)

Arguments

`term`	Character. Search term; required; no default For using Boolean operators, see the API documentation. Here's some of the relevant information: "Your request can also use the Boolean NOT (-) and OR (\|) operators to exclude videos or to find videos that are associated with one of several search terms. For example, to search for videos matching either "boating" or "sailing", set the q parameter value to boating\|sailing. Similarly, to search for videos matching either "boating" or "sailing" but not "fishing", set the q parameter value to boating\|sailing -fishing"
`max_results`	Maximum number of items that should be returned. Integer. Optional. Can be between 0 and 50. Default is 50. Search results are constrained to a maximum of 500 videos if type is video and we have a value of `channel_id`.
`channel_id`	Character. Only return search results from this channel; Optional.
`channel_type`	Character. Optional. Takes one of two values: `'any', 'show'`. Default is `'any'`
`type`	Character. Optional. Takes one of three values: `'video', 'channel', 'playlist'`. Default is `'video'`.
`event_type`	Character. Optional. Takes one of three values: `'completed', 'live', 'upcoming'`
`location`	Character. Optional. Latitude and Longitude within parentheses, e.g. "(37.42307,-122.08427)"
`location_radius`	Character. Optional. e.g. "1500m", "5km", "10000ft", "0.75mi"
`published_after`	Character. Optional. RFC 339 Format. For instance, "1970-01-01T00:00:00Z"
`published_before`	Character. Optional. RFC 339 Format. For instance, "1970-01-01T00:00:00Z"
`video_definition`	Character. Optional. Takes one of three values: `'any'` (return all videos; Default), `'high', 'standard'`
`video_caption`	Character. Optional. Takes one of three values: `'any'` (return all videos; Default), `'closedCaption', 'none'`. Type must be set to video.
`video_license`	Character. Optional. Takes one of three values: `'any'` (return all videos; Default), `'creativeCommon'` (return videos with Creative Commons license), `'youtube'` (return videos with standard YouTube license).
`video_syndicated`	Character. Optional. Takes one of two values: `'any'` (return all videos; Default), `'true'` (return only syndicated videos)
`region_code`	Character. Required. Has to be a ISO 3166-1 alpha-2 code (see https://www.iso.org/obp/ui/#search).
`relevance_language`	Character. Optional. The relevance_language argument instructs the API to return search results that are most relevant to the specified language. The parameter value is typically an ISO 639-1 two-letter language code. However, you should use the values zh-Hans for simplified Chinese and zh-Hant for traditional Chinese. Please note that results in other languages will still be returned if they are highly relevant to the search query term.
`video_type`	Character. Optional. Takes one of three values: `'any'` (return all videos; Default), `'episode'` (return episode of shows), 'movie' (return movies)
`simplify`	Boolean. Return a data.frame if `TRUE`. Default is `TRUE`. If `TRUE`, it returns a list that carries additional information.
`get_all`	get all results, iterating through all the results pages. Default is `TRUE`. Result is a `data.frame`. Optional.
`page_token`	specific page in the result set that should be returned, optional
`...`	Additional arguments passed to `tuber_GET`.

Value

data.frame with 16 elements: video_id, publishedAt, channelId, title, description, thumbnails.default.url, thumbnails.default.width, thumbnails.default.height, thumbnails.medium.url, thumbnails.medium.width, thumbnails.medium.height, thumbnails.high.url, thumbnails.high.width, thumbnails.high.height, channelTitle, liveBroadcastContent

References

https://developers.google.com/youtube/v3/docs/search/list

Examples


## Not run: 

# Set API token via yt_oauth() first

yt_search(term = "Barack Obama")
yt_search(term = "Barack Obama", published_after = "2016-10-01T00:00:00Z")
yt_search(term = "Barack Obama", published_before = "2016-09-01T00:00:00Z")
yt_search(term = "Barack Obama", published_before = "2016-03-01T00:00:00Z",
                               published_after = "2016-02-01T00:00:00Z")
yt_search(term = "Barack Obama", published_before = "2016-02-10T00:00:00Z",
                               published_after = "2016-01-01T00:00:00Z")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

yt_search(term = "Barack Obama")
yt_search(term = "Barack Obama", published_after = "2016-10-01T00:00:00Z")
yt_search(term = "Barack Obama", published_before = "2016-09-01T00:00:00Z")
yt_search(term = "Barack Obama", published_before = "2016-03-01T00:00:00Z",
                               published_after = "2016-02-01T00:00:00Z")
yt_search(term = "Barack Obama", published_before = "2016-02-10T00:00:00Z",
                               published_after = "2016-01-01T00:00:00Z")

## End(Not run)

Check if authentication token is in options

Description

Check if authentication token is in options

Usage

yt_token()

yt_authorized()

yt_check_token()
yt_token()

yt_authorized()

yt_check_token()

Value

A Token2.0 class

Search YouTube by Topic It uses the Freebase list of topics

Description

Search YouTube by Topic It uses the Freebase list of topics

Usage

yt_topic_search(topic = NULL, ...)
yt_topic_search(topic = NULL, ...)

Arguments

`topic`	topic being searched for; required; no default
`...`	Additional arguments passed to `tuber_GET`.

Value

a list

Examples

 ## Not run: 

# Set API token via yt_oauth() first

yt_topic_search(topic = "Barack Obama")

## End(Not run)
## Not run: 

# Set API token via yt_oauth() first

yt_topic_search(topic = "Barack Obama")

## End(Not run)

Package 'tuber'

Help Index

Add Video to Playlist

Description

Usage

Arguments

Value

References

Examples

Change the title of a YouTube playlist.

Description

Usage

Arguments

Value

Examples

Create New Playlist

Description

Usage

Arguments

Value

References

Examples

Delete a Particular Caption Track

Description

Usage

Arguments

References

Examples

Delete Channel Sections

Description

Usage

Arguments

References

Examples

Delete a Particular Comment

Description

Usage

Arguments

References

Examples

Delete a Playlist Item

Description

Usage

Arguments

References

Examples

Delete a Playlist

Description

Usage

Arguments

References

Examples

Delete a Video

Description

Usage

Arguments

References

Examples

Get statistics on all the videos in a Channel

Description

Usage

Arguments

Value

References

Examples

Get all the comments for a video including replies

Description

Usage

Arguments

Value

References

Examples

Get Particular Caption Track

Description

Usage

Arguments

Value

References

Examples

Get statistics of a Channel