Skip to content

YouTube: List Captions

Plugin ID: eca_youtube_list_captions

Available since: 1.0.0

Lists all available caption tracks for a YouTube video. Use this before GetCaption to see available options and get caption IDs.

Fields

<div class="messages messages--warning"><strong>Important:</strong> This action requires OAuth2 authentication and only works for videos you own or have permission to access. It will not work for other users' videos.</div>

Authentication Type — config key: auth_type

Choose between API Client (OAuth2) or Service Account authentication.

Type: select · Required: yes · Default: api_client

Allowed values: api_client, service_account

Authentication Source — config key: auth_from

Choose whether to select authentication directly or use a token for dynamic selection.

Type: select · Required: yes · Default: direct

Allowed values: direct, token

API Client — config key: api_client_id

Search and select an API Client for OAuth2 authentication.

Type: textfield · Required: no · Default: empty string

Service Account — config key: service_account_id

Search and select a Service Account for server-to-server authentication.

Type: textfield · Required: no · Default: empty string

Client ID from Token — config key: auth_client_from_token

Token that resolves to a client ID (e.g., [user:field_google_client_id]). The token should contain just the client ID, not the auth type prefix.
This field supports tokens.

Type: textfield · Required: no · Default: empty string

Video ID or URL — config key: video_input

Enter a YouTube video ID or full YouTube URL for a video you own. Supports token replacement.
This field supports tokens.

Type: textfield · Required: yes · Default: empty string

Captions Token Name — config key: captions_token_name

Token name to store caption list. Access as:
• [token_name:captions:0:id] - First caption ID (for GetCaption)
• [token_name:captions:0:language] - First caption language
• [token_name:captions:0:name] - First caption display name
• [token_name:count] - Total number of captions
Use the ID values with the GetCaption action.
This field supports tokens.

Type: textfield · Required: no · Default: empty string