YouTube
Stay organized with collections
Save and categorize content based on your preferences.
Update video's details
function
updateYouTubeVideo
()
{
//
1.
Fetch
all
the
channels
owned
by
active
user
.
var
myChannels
=
YouTube
.
Channels
.
list
(
'contentDetails'
,
{
mine
:
true
});
//
2.
Iterate
through
the
channels
and
get
the
uploads
playlist
ID
.
for
(
var
i
=
0
;
i
<
myChannels
.
items
.
length
;
i
++
)
{
var
item
=
myChannels
.
items
[
i
];
var
uploadsPlaylistId
=
item
.
contentDetails
.
relatedPlaylists
.
uploads
;
var
playlistResponse
=
YouTube
.
PlaylistItems
.
list
(
'snippet'
,
{
playlistId
:
uploadsPlaylistId
,
maxResults
:
1
});
//
Get
the
ID
of
the
first
video
in
the
list
.
var
video
=
playlistResponse
.
items
[
0
];
var
originalDescription
=
video
.
snippet
.
description
;
var
updatedDescription
=
originalDescription
+
' Description updated via Google Apps Script'
;
video
.
snippet
.
description
=
updatedDescription
;
var
resource
=
{
snippet
:
{
title
:
video
.
snippet
.
title
,
description
:
updatedDescription
,
categoryId
:
'22'
},
id
:
video
.
snippet
.
resourceId
.
videoId
};
YouTube
.
Videos
.
update
(
resource
,
'id,snippet'
);
console
.
log
(
'Video with ID =
%s
and Title =
%s
was successfully updated.'
,
video
.
snippet
.
resourceId
.
videoId
,
video
.
snippet
.
title
);
}
}
Create a channel bulletin
function
postChannelBulletin
()
{
var
message
=
'Thanks for subscribing to my channel! This posting is '
+
'from Google Apps Script'
;
var
videoId
=
'INSERT_VIDEO_ID_HERE'
;
var
resource
=
{
snippet
:
{
description
:
message
},
contentDetails
:
{
bulletin
:
{
resourceId
:
{
kind
:
'youtube#video'
,
videoId
:
videoId
}
}
}
};
var
response
=
YouTube
.
Activities
.
insert
(
resource
,
'snippet,contentDetails'
);
console
.
log
(
'Posted to channel bulletin successfully.'
);
}
Retrieve video uploads
function
retrieveVideoUploads
()
{
var
results
=
YouTube
.
Channels
.
list
(
'contentDetails'
,
{
mine
:
true
});
for
(
var
i
in
results
.
items
)
{
var
item
=
results
.
items
[
i
];
//
Get
the
playlist
ID
,
which
is
nested
in
contentDetails
,
as
described
in
//
the
Channel
resource
:
//
https
:
//
developers
.
google
.
com
/
youtube
/
v3
/
docs
/
channels
var
playlistId
=
item
.
contentDetails
.
relatedPlaylists
.
uploads
;
var
nextPageToken
=
''
;
//
This
loop
retrieves
a
set
of
playlist
items
and
checks
the
nextPageToken
//
in
the
response
to
determine
whether
the
list
contains
additional
items
.
//
It
repeats
that
process
until
it
has
retrieved
all
of
the
items
in
the
//
list
.
while
(
nextPageToken
!=
null
)
{
var
playlistResponse
=
YouTube
.
PlaylistItems
.
list
(
'snippet'
,
{
playlistId
:
playlistId
,
maxResults
:
25
,
pageToken
:
nextPageToken
});
for
(
var
j
=
0
;
j
<
playlistResponse
.
items
.
length
;
j
++
)
{
var
playlistItem
=
playlistResponse
.
items
[
j
];
console
.
log
(
'[
%s
] Title:
%s
'
,
playlistItem
.
snippet
.
resourceId
.
videoId
,
playlistItem
.
snippet
.
title
);
}
nextPageToken
=
playlistResponse
.
nextPageToken
;
}
}
}
Search videos by keyword
function
searchVideosByKeyword
()
{
var
results
=
YouTube
.
Search
.
list
(
'id,snippet'
,
{
q
:
'dogs'
,
maxResults
:
25
}
);
for
(
var
i
in
results
.
items
)
{
var
item
=
results
.
items
[
i
]
;
console
.
log
(
'[%s] Title: %s'
,
item
.
id
.
videoId
,
item
.
snippet
.
title
);
}
}
Search videos by topics
function
searchVideosByFreebaseTopic
()
{
//
See
https
:
//
developers
.
google
.
com
/
youtube
/
v3
/
guides
/
searching_by_topic
//
for
more
details
.
//
Insert
Your
Freebase
topic
ID
here
.
The
Freebase
ID
used
in
this
example
//
corresponds
to
the
Freebase
entry
for
Google
.
See
//
http
:
//
www
.
freebase
.
com
/
m
/
045
c7b
for
more
details
.
var
mid
=
'/m/045c7b'
;
var
results
=
YouTube
.
Search
.
list
(
'id,snippet'
,
{
topicId
:
mid
,
maxResults
:
25
}
);
for
(
var
i
in
results
.
items
)
{
var
item
=
results
.
items
[
i
]
;
console
.
log
(
'[%s] Title: %s'
,
item
.
id
.
videoId
,
item
.
snippet
.
title
);
}
}
Subscribe to a channel
function
subscribeToChannel
()
{
//
Replace
this
channel
ID
with
the
channel
ID
you
want
to
subscribe
to
.
var
channelId
=
'INSERT_YOUTUBE_CHANNEL_ID_HERE'
;
var
resource
=
{
snippet
:
{
resourceId
:
{
kind
:
'youtube#channel'
,
channelId
:
channelId
}
}
};
try
{
var
response
=
YouTube
.
Subscriptions
.
insert
(
resource
,
'snippet'
);
console
.
log
(
'Subscribed to channel ID
%s
successfully.'
,
channelId
);
}
catch
(
e
)
{
if
(
e
.
message
.
match
(
'subscriptionDuplicate'
))
{
console
.
log
(
'Cannot subscribe; already subscribed to channel: '
+
channelId
);
}
else
{
console
.
log
(
'Error adding subscription: '
+
e
.
message
);
}
}
}
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThis script provides functionalities for managing YouTube channels and videos, such as updating video details, posting channel bulletins, and retrieving video uploads.\u003c/p\u003e\n"],["\u003cp\u003eUsers can leverage the provided functions to find videos based on keywords or Freebase topics.\u003c/p\u003e\n"],["\u003cp\u003eThe script allows for subscribing to channels and managing channel subscriptions, handling potential duplicate subscriptions.\u003c/p\u003e\n"],["\u003cp\u003eIt demonstrates the usage of Google Apps Script to interact with the YouTube API for automating channel and video management tasks.\u003c/p\u003e\n"]]],[],null,["# YouTube\n\nUpdate video's details\n----------------------\n\n```gdscript\nfunction updateYouTubeVideo() {\n // 1. Fetch all the channels owned by active user.\n var myChannels = YouTube.Channels.list('contentDetails', {mine: true});\n\n // 2. Iterate through the channels and get the uploads playlist ID.\n for (var i = 0; i \u003c myChannels.items.length; i++) {\n var item = myChannels.items[i];\n var uploadsPlaylistId = item.contentDetails.relatedPlaylists.uploads;\n\n var playlistResponse = YouTube.PlaylistItems.list('snippet', {\n playlistId: uploadsPlaylistId,\n maxResults: 1\n });\n\n // Get the ID of the first video in the list.\n var video = playlistResponse.items[0];\n var originalDescription = video.snippet.description;\n var updatedDescription = originalDescription +\n ' Description updated via Google Apps Script';\n\n video.snippet.description = updatedDescription;\n\n var resource = {\n snippet: {\n title: video.snippet.title,\n description: updatedDescription,\n categoryId: '22'\n },\n id: video.snippet.resourceId.videoId\n };\n YouTube.Videos.update(resource, 'id,snippet');\n\n console.log('Video with ID = %s and Title = %s was successfully updated.',\n video.snippet.resourceId.videoId, video.snippet.title);\n }\n}\n```\n\nCreate a channel bulletin\n-------------------------\n\n```gdscript\nfunction postChannelBulletin() {\n var message = 'Thanks for subscribing to my channel! This posting is ' +\n 'from Google Apps Script';\n\n var videoId = 'INSERT_VIDEO_ID_HERE';\n var resource = {\n snippet: {\n description: message\n },\n contentDetails: {\n bulletin: {\n resourceId: {\n kind: 'youtube#video',\n videoId: videoId\n }\n }\n }\n };\n\n var response = YouTube.Activities.insert(resource, 'snippet,contentDetails');\n console.log('Posted to channel bulletin successfully.');\n}\n```\n\nRetrieve video uploads\n----------------------\n\n```gdscript\nfunction retrieveVideoUploads() {\n var results = YouTube.Channels.list('contentDetails', {mine: true});\n for (var i in results.items) {\n var item = results.items[i];\n // Get the playlist ID, which is nested in contentDetails, as described in\n // the Channel resource:\n // https://developers.google.com/youtube/v3/docs/channels\n var playlistId = item.contentDetails.relatedPlaylists.uploads;\n\n var nextPageToken = '';\n\n // This loop retrieves a set of playlist items and checks the nextPageToken\n // in the response to determine whether the list contains additional items.\n // It repeats that process until it has retrieved all of the items in the\n // list.\n while (nextPageToken != null) {\n var playlistResponse = YouTube.PlaylistItems.list('snippet', {\n playlistId: playlistId,\n maxResults: 25,\n pageToken: nextPageToken\n });\n\n for (var j = 0; j \u003c playlistResponse.items.length; j++) {\n var playlistItem = playlistResponse.items[j];\n console.log('[%s] Title: %s',\n playlistItem.snippet.resourceId.videoId,\n playlistItem.snippet.title);\n\n }\n nextPageToken = playlistResponse.nextPageToken;\n }\n }\n}\n```\n\nSearch videos by keyword\n------------------------\n\n```transact-sql\nfunction searchVideosByKeyword() {\n var results = YouTube.Search.list('id,snippet', {q: 'dogs', maxResults: 25});\n for (var i in results.items) {\n var item = results.items[i];\n console.log('[%s] Title: %s', item.id.videoId, item.snippet.title);\n }\n}\n```\n\nSearch videos by topics\n-----------------------\n\n```transact-sql\nfunction searchVideosByFreebaseTopic() {\n // See https://developers.google.com/youtube/v3/guides/searching_by_topic\n // for more details.\n\n // Insert Your Freebase topic ID here. The Freebase ID used in this example\n // corresponds to the Freebase entry for Google. See\n // http://www.freebase.com/m/045c7b for more details.\n var mid = '/m/045c7b';\n var results = YouTube.Search.list('id,snippet',\n {topicId: mid, maxResults: 25});\n for (var i in results.items) {\n var item = results.items[i];\n console.log('[%s] Title: %s', item.id.videoId, item.snippet.title);\n }\n}\n```\n\nSubscribe to a channel\n----------------------\n\n```gdscript\nfunction subscribeToChannel() {\n // Replace this channel ID with the channel ID you want to subscribe to.\n\n var channelId = 'INSERT_YOUTUBE_CHANNEL_ID_HERE';\n var resource = {\n snippet: {\n resourceId: {\n kind: 'youtube#channel',\n channelId: channelId\n }\n }\n };\n\n try {\n var response = YouTube.Subscriptions.insert(resource, 'snippet');\n\n console.log('Subscribed to channel ID %s successfully.', channelId);\n } catch (e) {\n if (e.message.match('subscriptionDuplicate')) {\n console.log('Cannot subscribe; already subscribed to channel: ' +\n channelId);\n } else {\n console.log('Error adding subscription: ' + e.message);\n }\n }\n}\n```"]]
