NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

YouTube

youtube

YouTube is a video-sharing platform with user-generated content, live streaming, and monetization opportunities, widely used for marketing, education, and entertainment

Video & AudioSocial Media AccountsWeb del proveedor
Acciones
14
Triggers
4
Autenticación
—
OAuth gestionado
Sí
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (14)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Get Channel ActivitiesYOUTUBE_GET_CHANNEL_ACTIVITIESAcción

Gets recent activities from a youtube channel including video uploads, playlist additions, likes, and other channel events.

Parámetros de entrada

  • partstring

    Comma-separated list of activity resource properties to include (e.g., 'snippet', 'contentDetails', 'id').

  • channelIdstringObligatorio

    The YouTube channel ID to retrieve activities for. Channel IDs typically start with 'UC'.

  • pageTokenstring

    Pagination token from a previous response to get the next page of results.

  • maxResultsinteger

    Maximum number of activities to return.

  • publishedAfterstring

    Return activities published after this date-time (RFC 3339 format: YYYY-MM-DDTHH:MM:SSZ).

  • publishedBeforestring

    Return activities published before this date-time (RFC 3339 format: YYYY-MM-DDTHH:MM:SSZ).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get channel ID by handleYOUTUBE_GET_CHANNEL_ID_BY_HANDLEAcción

Retrieves the youtube channel id for a specific youtube channel handle.

Parámetros de entrada

  • channel_handlestringObligatorio

    The YouTube channel handle (e.g., @Google) for which to retrieve the corresponding channel ID. This handle must start with an '@' symbol.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Channel StatisticsYOUTUBE_GET_CHANNEL_STATISTICSAcción

Gets detailed statistics for youtube channels including subscriber counts, view counts, and video counts.

Parámetros de entrada

  • idstringObligatorio

    Comma-separated list of YouTube channel IDs. Channel IDs typically start with 'UC'.

  • partstring

    Comma-separated list of channel resource properties to include. Use 'statistics' for subscriber count.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List captionsYOUTUBE_LIST_CAPTION_TRACKAcción

Retrieves a list of caption tracks for a youtube video, returning an empty list if no captions exist or failing if the video id is invalid or not found.

Parámetros de entrada

  • partstring

    Specifies a comma-separated list of one or more caption resource parts that the API response will include. Valid parts are 'id' and 'snippet'.

  • videoIdstringObligatorio

    The YouTube video ID for which the API should return caption tracks.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List channel videosYOUTUBE_LIST_CHANNEL_VIDEOSAcción

Lists videos from a specified youtube channel, ensuring results are of `type: 'video'`.

Parámetros de entrada

  • partstring

    Specifies `search` resource properties to include; it must be `snippet` for this action. The `snippet` includes basic video details like ID, title, description, and thumbnails.

  • channelIdstringObligatorio

    The unique ID of the YouTube channel for which videos are to be retrieved.

  • pageTokenstring

    Token for pagination; use `nextPageToken` from a previous response for the next page, or `prevPageToken` for the previous page.

  • maxResultsinteger

    The maximum number of videos to return per page.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List user playlistsYOUTUBE_LIST_USER_PLAYLISTSAcción

Retrieves playlists owned by the authenticated user, implicitly using mine=true.

Parámetros de entrada

  • partstring

    Specifies a comma-separated list of one or more playlist resource properties to include in the response. Common values are 'snippet', 'id', and 'contentDetails'.

  • pageTokenstring

    Token for pagination to retrieve a specific page of results.

  • maxResultsinteger

    Maximum number of playlists to return.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List user subscriptionsYOUTUBE_LIST_USER_SUBSCRIPTIONSAcción

Retrieves the authenticated user's youtube channel subscriptions, allowing specification of response parts and pagination.

Parámetros de entrada

  • partstring

    Specifies the comma-separated subscription resource parts to include. Valid parts are `id`, `snippet`, `contentDetails`, and `subscriberSnippet`.

  • pageTokenstring

    Token for a specific page of results, obtained from a previous response. Omit for the first page.

  • maxResultsinteger

    Maximum number of subscription items to return per page.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Download YouTube caption trackYOUTUBE_LOAD_CAPTIONSAcción

Downloads a specific youtube caption track, which must be owned by the authenticated user, and returns its content as text.

Parámetros de entrada

  • idstringObligatorio

    Unique YouTube-assigned ID of the caption track to download.

  • tfmtstring

    Desired format for the caption track. Supported formats: 'srt' (SubRip), 'sbv' (SubViewer), 'vtt' (WebVTT).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Search YouTubeYOUTUBE_SEARCH_YOU_TUBEAcción

Searches youtube for videos, channels, or playlists using a query term, returning the raw api response.

Parámetros de entrada

  • qstringObligatorio

    Search query term. Supports: - Basic text: 'machine learning' - Exact phrases: '"exact phrase"' - Exclusions: 'python -snake' - Multiple terms: 'AI OR ML' - Channel search: '@channelhandle' or channel name

  • partstring

    Comma-separated list of search resource properties (e.g., 'id', 'snippet') to include in the API response.

  • typestring

    Restricts search to 'video', 'channel', or 'playlist'; comma-separate for multiple types (e.g., 'video,channel').

  • pageTokenstring

    Pagination token from a previous response's 'nextPageToken' or 'prevPageToken', used to retrieve a specific page of results.

  • maxResultsinteger

    Maximum number of items to return per page.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Subscribe to channelYOUTUBE_SUBSCRIBE_CHANNELAcción

Subscribes the authenticated user to a specified youtube channel, identified by its unique `channelid` which must be valid and existing.

Parámetros de entrada

  • channelIdstringObligatorio

    Unique identifier (ID) of the YouTube channel to subscribe to (typically starts with 'UC').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update thumbnailYOUTUBE_UPDATE_THUMBNAILAcción

Sets the custom thumbnail for a youtube video using an image from thumbnailurl; the authenticated user must have permission to edit the video.

Parámetros de entrada

  • videoIdstringObligatorio

    Identifier of the YouTube video for which to update the thumbnail.

  • thumbnailUrlstringObligatoriouri

    Publicly accessible URL of the new thumbnail image. Must be JPG, GIF, or PNG; under 2MB. Recommended: 16:9 aspect ratio, 1280x720 resolution (minimum 640px width).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update videoYOUTUBE_UPDATE_VIDEOAcción

Updates metadata for a youtube video identified by videoid, which must exist; an empty list for tags removes all existing tags.

Parámetros de entrada

  • tagsstring[]

    New tags, replacing all existing. An empty list removes all. No change if omitted or `None`.

  • titlestring

    New video title. No change if omitted or `None`.

  • videoIdstringObligatorio

    The video's unique YouTube ID, typically found in its URL.

  • categoryIdstring

    New YouTube category ID. No change if omitted or `None`.

  • descriptionstring

    New video description. No change if omitted or `None`.

  • privacyStatusstring

    New privacy status ('public', 'private', or 'unlisted'). No change if omitted or `None`.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Upload videoYOUTUBE_UPLOAD_VIDEOAcción

Uploads a video from a local file path to a youtube channel; the video file must be in a youtube-supported format.

Parámetros de entrada

  • tagsarrayObligatorio

    List of keyword tags (strings) for the video, used to improve discoverability.

  • titlestringObligatorio

    The title for the video.

  • categoryIdstringObligatorio

    YouTube category ID (e.g., '22' for People & Blogs). See YouTube Data API docs for a full list of category IDs.

  • descriptionstringObligatorio

    Detailed description of the video content, optionally including keywords and context.

  • privacyStatusstringObligatorio

    Privacy status: 'public', 'private' (uploader/specified users only), or 'unlisted' (link accessible, not publicly listed).

  • videoFilePathstringObligatorio

    Local file path (absolute or relative) of the video to be uploaded.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Video detailsYOUTUBE_VIDEO_DETAILSAcción

Retrieves specified information parts (e.g., snippet, contentdetails, statistics) for a youtube video, identified by its id.

Parámetros de entrada

  • idstringObligatorio

    The YouTube video ID (typically an 11-character string) for which details are to be retrieved.

  • partstring

    Comma-separated list of video resource parts that the API response will include. Valid parts: 'snippet' (title, description, thumbnails), 'contentDetails' (duration, definition, dimension), 'statistics' (view count, like count, comment count), 'status' (upload status, privacy status), 'player' (embed HTML), 'topicDetails' (associated topics), 'recordingDetails' (recording location and date), 'liveStreamingDetails' (live broadcast details), and 'localizations' (localized metadata).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Triggers (4)

Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).

New YouTube ActivityYOUTUBE_NEW_ACTIVITY_TRIGGERTrigger

Triggers when a new activity is detected on a YouTube channel.

Configuración

  • channel_idstringObligatorio

    The ID of the YouTube channel

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

  • activityobjectObligatorio

    Activity details

  • event_typestring

    Type of YouTube activity event

Instrucciones

**Instructions for Setting Up the Trigger:** - Make sure you have authorized access to the YouTube Data API.

New Item in YouTube PlaylistYOUTUBE_NEW_PLAYLIST_ITEM_TRIGGERTrigger

Triggers when a new item is added to a YouTube playlist.

Configuración

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • playlist_idstringObligatorio

    The ID of the YouTube playlist

Payload del evento

  • event_typestring

    Type of YouTube playlist item event

  • itemobjectObligatorio

    Playlist item details

Instrucciones

**Instructions for Setting Up the Trigger:** - Make sure you have authorized access to the YouTube Data API.

New Playlist in YouTube ChannelYOUTUBE_NEW_PLAYLIST_TRIGGERTrigger

Triggers when a new playlist is added to a YouTube channel.

Configuración

  • channel_idstringObligatorio

    The ID of the YouTube channel

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

  • event_typestring

    Type of YouTube playlist event

  • playlistobjectObligatorio

    Playlist details

Instrucciones

**Instructions for Setting Up the Trigger:** - Make sure you have authorized access to the YouTube Data API.

New YouTube Channel SubscriptionYOUTUBE_NEW_SUBSCRIPTION_TRIGGERTrigger

Triggers when a new channel is subscribed.

Configuración

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

  • event_typestring

    Type of YouTube subscription event

  • subscriptionobjectObligatorio

    Subscription details

Instrucciones

**Instructions for Setting Up the Trigger:** - Make sure you have authorized access to the YouTube Data API.