YouTube

YouTube allows billions of people to discover, watch and share videos.

 

Status: Production

Tier: Standard

Version: 1.2

 

Actions:

Name	Summary
ListSubscriptions ()	List channels

 

Triggers:

Name	Summary
OnNewVideoInChannel (string channelId)	When a video is uploaded by a channel
OnMyNewVideo ()	When I upload a video
OnNewVideoMatchingSearch (string q)	When a new video matches a search

 

Objects:

Name	Summary
Subscription	Subscription
SubscriptionList	Subscriptions List
Video	Video
VideoList	Video List
VideoSnippet	Video Summary

 

Actions:

ListSubscriptions

Summary: List channels

Description: This operation returns a list of all channels that the authenticated user subscribes to.

 

Syntax:

 

Returns:

          Type:SubscriptionList

          Summary: Subscriptions List

          Description: A list of YouTube subscriptions.

 

Triggers:

Trigger OnNewVideoInChannel

Summary: When a video is uploaded by a channel

Description: This operation triggers when a new video is uploaded by a channel.

 

Syntax:

 

Parameters:

Name	Type	Summary	Required	Related Action
channelId	string (Channel Id)	Pick a channel.	True	ListSubscriptions

 

Returns:

          Type:VideoList

          Summary: Video List

          Description: A list of YouTube videos.

 

Trigger OnMyNewVideo

Summary: When I upload a video

Description: This operation triggers when you upload a public or scheduled video to your channel.

 

Syntax:

 

Returns:

          Type:VideoList

          Summary: Video List

          Description: A list of YouTube videos.

 

Trigger OnNewVideoMatchingSearch

Summary: When a new video matches a search

Description: This operation triggers when a new video matches a search.

 

Syntax:

 

Parameters:

Name	Type	Summary	Required	Related Action
q	string (Query)	The search query.	True

 

Returns:

          Type:VideoList

          Summary: Video List

          Description: A list of YouTube videos.

 

 

Subscription

Summary: Subscription

Description: Details of a specific subscription.

 

          Properties:

Name	Type	Summary
channelId	string Channel Id	Unique id of the channel.
title	string Channel Title	Title of the channel.

 

SubscriptionList

Summary: Subscriptions List

Description: A list of YouTube subscriptions.

 

          Properties:

Name	Type	Summary
items	array of (Subscription) Subscriptions	List of all subscriptions.

 

Video

Summary: Video

Description: Details about a specific video.

 

          Properties:

Name	Type	Summary
id	string Video Id	Unique identifier of the video.
htmlLink	string Web Link	Hyperlink to the video.
snippet	VideoSnippet Video Summary	A short summary of a given YouTube video.

 

VideoList

Summary: Video List

Description: A list of YouTube videos.

 

          Properties:

Name	Type	Summary
items	array of (Video) Videos	List of all videos.

 

VideoSnippet

Summary: Video Summary

Description: A short summary of a given YouTube video.

 

          Properties:

Name	Type	Summary
title	string Title	The video's title.
description	string Description	The video's description.
channelTitle	string Channel Title	Title of the channel.
channelId	string Channel Id	Unique identifier of the channel.
publishedAt	string(date-time) Published Date-Time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)