
YouTube OAuth2
CertifiedAuthenticate with YouTube using OAuth2
YouTube OAuth2
Authenticate with YouTube using OAuth2
This task authenticates with YouTube API using OAuth2 refresh token flow.
type: io.kestra.plugin.youtube.OAuth2Examples
Authentication with youtube
id: youtube_auth
namespace: company.team
tasks:
- id: authenticate
type: io.kestra.plugin.youtube.OAuth2
clientId: "{{ secret('YOUTUBE_CLIENT_ID') }}"
clientSecret: "{{ secret('YOUTUBE_CLIENT_SECRET') }}"
refreshToken: "{{ secret('YOUTUBE_REFRESH_TOKEN') }}"
Installation
Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:
kestractl plugins get io.kestra.plugin:plugin-youtube --compatible-for $KESTRA_VERSION For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.
For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.
Properties
clientId *string
The OAuth2 Client ID
OAuth2 client ID from Google Cloud console project
clientSecret *string
The OAuth2 Client Secret
OAuth2 client secret from Google Cloud console project
refreshToken *string
The OAuth2 Refresh Token
Refresh token obtained during the initial authorization flow
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150tokenUrl string
https://oauth2.googleapis.com/tokenToken endpoint URL
The Google OAuth2 token endpoint URL
Outputs
accessToken string
Access Token
OAuth2 access token for API authentication. WARNING: This token is stored in task outputs and visible to users with execution read access. Restrict namespace permissions and prefer storing tokens in Kestra's secret store.
expiresAt string
date-timeExpiration time
The exact time when the token expires
expiresIn integer
Expires In Seconds
Number of seconds until the token expires
scope string
Token Scope
Granted OAuth2 scopes
tokenType string
Token Type
Type of the access token (typically 'Bearer')