YouTube Livestreams Action

Fetch YouTube livestreams from a YouTube channel (by channel id) and create files or posts on a website.

Inputs

`api-key`

Required Google api key with access to YouTube Data API v3

`channel-id`

Required YouTube channel id

`max-results`

Optional Max number of results to return, defaults to 5

`thumbnail-size`

Optional Thumbnail image size name, one of default, medium, high, standard, maxres

`output-path`

Optional Path to write output files to, defaults to _data/streams

`output-filename-template`

Optional Output filename template for each output file including placeholders, defaults to ${publishedAt}.yml

`output-content-template`

Optional Output content template for each output file including placeholders[1], defaults to:

_id: '${id}'
etag: '${etag}'
title: '${title}'
description: '${description}'
thumbnailUrl: '${thumbnailUrl}'
channelId: '${channelId}'
channelTitle: '${channelTitle}'
videoId: '${videoId}'
publishedAt: '${publishedAt}'
publishTime: '${publishTime}'
duration: '${duration}'
actualStartTime: '${actualStartTime}'
actualEndTime: '${actualEndTime}'

[1]: Placeholders currently include the following fields from the YouTube search and video details responses:

${id}
${etag}
${title}
${description}
${thumbnailUrl}
${channelId}
${channelTitle}
${videoId}
${publishedAt}
${publishTime}
${duration}
${actualStartTime}
${actualEndTime}

Example usage

uses: InSourceSoftware/youtube-livestreams-action@v1
with:
  api-key: ${{ secrets.GOOGLE_API_KEY }}
  channel-id: 'xyz'
  max-results: '5'
  thumbnail-size: 'standard'
  output-path: '_data/streams'
  output-filename-template: '${publishedAt}.yml'
  output-content-template: |
    _id: '${id}'
    etag: '${etag}'
    title: '${title}'
    description: '${description}'
    thumbnailUrl: '${thumbnailUrl}'
    channelId: '${channelId}'
    channelTitle: '${channelTitle}'
    videoId: '${videoId}'
    publishedAt: '${publishedAt}'
    publishTime: '${publishTime}'
    duration: '${duration}'
    actualStartTime: '${actualStartTime}'
    actualEndTime: '${actualEndTime}'

InSourceSoftware / youtube-livestreams-action