YouTubeRB

gem 'youtuberb'

# To access public data, just an API Key is required
@client = YouTube::Client.new(api_key: "")

# Or to access data for a user, an Access Token is also required
@client = YouTube::Client.new(api_key: "", access_token: "")

# Get the Channel details of the currently authenticated user
@client.channels.mine

# Get a Channel by ID
@client.channels.retrieve(id: "channel_id")

# Get a Channel by username
@client.channels.retrieve(username: "username")

# Get a Channel by it's handle
@client.channels.retrieve(handle: "@username")

# Retrieve a list of videos for a Channel
# Returns a collection of SearchResult's because YouTube don't have a direct API to view all videos on a Channel
@client.channels.videos(id: "channel_id")

# Get a single video
@client.videos.list(id: "abc123")
# => #<YouTube::Video...

# Get multiple videos
@client.videos.list(ids: ["abc123", "123abc"])
# => #<YouTube::Collection...

# Liked videos for the currently authenticated user
@client.videos.liked
# => #<YouTube::Collection...

# Get a video owned by the current user. This retrieves extra information so will only work on videos owned by the current user.
@client.videos.retrieve(id: "abc123")
# => #<YouTube::Video...

# Simple upload with just title
video = @client.videos.upload(
  file: "/path/to/video.mp4",
  title: "My Awesome Video"
)

# Upload with full metadata
video = @client.videos.upload(
  file: "/path/to/video.mp4",
  title: "Ruby Tutorial",
  description: "Learn Ruby programming",
  privacy_status: "unlisted",  # 'public', 'unlisted', or 'private'
  tags: ["ruby", "programming", "tutorial"],
  category_id: "28"  # Science & Technology
)

# Using a File object
File.open("video.mp4", "rb") do |file|
  video = @client.videos.upload(
    file: file,
    title: "My Video"
  )
end

# Access the uploaded video details
puts video.id           # => "dQw4w9WgXcQ"
puts video.title        # => "My Awesome Video"
puts video.privacy_status # => "unlisted"

# First, grab the Channel details
channel = @client.channels.retrieve(id: "channel_id")

# Then use the Playlist Items endpoint to get the Videos
@client.playlist_items.list playlist_id: channel.contentDetails.relatedPlaylists.uploads

# Or use the Search endpoint
@client.search.list channelId: channel.id

# Get first page of results
videos = @client.search.list(q: "ruby", maxResults: 10)

# Check if there's a next page
if videos.has_next_page?
  next_page = videos.next_page
  videos.each { |v| puts v.title }
end

# Check if there's a previous page
if videos.has_prev_page?
  prev_page = videos.prev_page
end

# Playlists created by the authenticated user
@client.playlists.list

# Playlists for a Channel
@client.playlists.list(channel_id: "channel")

# Return a set number of results & use pagination
playlists = @client.playlists.list(max_results: 5)
if playlists.has_next_page?
  next_playlists = playlists.next_page
end

@client.playlists.retrieve(id: "playlist_id")
@client.playlists.create(title: "My Playlist")
@client.playlists.update(id: "playlist_id", title: "My Playlist", privacy_status: "public")
@client.playlists.delete(id: "playlist_id")

# Playlist Items for a Playlist
@client.playlist_items.list(playlist_id: "playlist_id")

@client.playlist_items.retrieve(id: "playlist_item_id")

# Add a video to a playlist
@client.playlist_items.create(playlist_id: "playlist_id", video_id: "video_id")

@client.playlist_items.update(id: "playlist_item_id", playlist_id: "playlist_id", video_id: "video_id")

@client.playlist_items.delete(id: "playlist_id")

# Search YouTube for a term
@client.search.list(q: "search term")

# Restrict the search to a channel
@client.search.list(channelId: "channel")

# Search a channel for videos only and ordered by date
@client.search.list(channelId: "channel", type: "video", order: "date")

# Live Broadcasts for the currently authenticated user
@client.live_broadcasts.list

# Live Broadcasts by status
@client.live_broadcasts.list status: "active"