YouTube Data API için aşağıdaki Apps Komut Dosyası kod örnekleri kullanılabilir. Bu kod örneklerini, GitHub'daki YouTube API'leri kod örneği deposunun apps-script
klasöründen indirebilirsiniz.
Yüklemelerimi alma
Bu işlev, mevcut komut dosyası kullanıcısının yüklediği videoları alır. Bu işlemin yürütülebilmesi için YouTube için OAuth okuma/yazma kapsamının yanı sıra kullanıcı yetkilendirmesi gerekir. Apps Komut Dosyası'nın çalışma ortamında, bir kullanıcı bir komut dosyasını ilk kez çalıştırdığında Apps Komut Dosyası, kullanıcıdan komut dosyası tarafından çağrılan hizmetlere erişme izni ister. İzinler verildikten sonra bir süre için önbelleğe alınır. Gerekli izinler değiştiğinde veyaScriptApp.invalidateAuth()
işlevi tarafından geçersiz kılındığında, komut dosyasını çalıştıran kullanıcıdan tekrar izin istenir.Bu komut dosyası, etkin kullanıcının yüklediği videoları almak için aşağıdaki adımları uygular:
- Kullanıcının kanallarını getirir.
- Kullanıcının "yüklemeler" oynatma listesini getirir.
- Bu oynatma listesinde iterasyon gerçekleştirir ve video kimliklerini ve başlıklarını günlüğe kaydeder.
- Varsa bir sonraki sayfa jetonunu getirir. Varsa sonraki sayfayı getirir. 3. adımı tekrarlayın.
/** * This function retrieves the current script user's uploaded videos. To execute, * it requires the OAuth read/write scope for YouTube as well as user authorization. * In Apps Script's runtime environment, the first time a user runs a script, Apps * Script will prompt the user for permission to access the services called by the * script. After permissions are granted, they are cached for some periodF of time. * The user running the script will be prompted for permission again once the * permissions required change, or when they are invalidated by the * ScriptApp.invalidateAuth() function. * * This script takes the following steps to retrieve the active user's uploaded videos: * 1. Fetches the user's channels * 2. Fetches the user's 'uploads' playlist * 3. Iterates through this playlist and logs the video IDs and titles * 4. Fetches a next page token (if any). If there is one, fetches the next page. GOTO Step 3 */ function retrieveMyUploads() { 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]; Logger.log('[%s] Title: %s', playlistItem.snippet.resourceId.videoId, playlistItem.snippet.title); } nextPageToken = playlistResponse.nextPageToken; } } }
Anahtar kelimeye göre arama
Bu işlev,'dogs'
anahtar kelimesiyle ilgili videoları arar. Arama sonuçlarının video kimlikleri ve başlıkları, Apps Script'in günlüğüne kaydedilir.Bu örnekte sonuçların 25 ile sınırlı olduğunu unutmayın. Daha fazla sonuç döndürmek için Search:list bölümünde açıklandığı şekilde ek parametreler iletin.
/** * This function searches for videos related to the keyword 'dogs'. The video IDs and titles * of the search results are logged to Apps Script's log. * * Note that this sample limits the results to 25. To return more results, pass * additional parameters as documented here: * https://developers.google.com/youtube/v3/docs/search/list */ function searchByKeyword() { var results = YouTube.Search.list('id,snippet', {q: 'dogs', maxResults: 25}); for(var i in results.items) { var item = results.items[i]; Logger.log('[%s] Title: %s', item.id.videoId, item.snippet.title); } }
Konuya göre arama yapma
Bu işlev, belirli bir Freebase konusuyla ilişkili videoları arar ve video kimliklerini ve başlıklarını Apps Komut Dosyası günlüğüne kaydeder. Bu örnekte, Google Apps Komut Dosyası için konu kimliği kullanılmaktadır.Bu örnekte sonuçların 25 ile sınırlı olduğunu unutmayın. Daha fazla sonuç döndürmek için Search:list bölümünde açıklandığı şekilde ek parametreler iletin.
/** * This function searches for videos that are associated with a particular Freebase * topic, logging their video IDs and titles to the Apps Script log. This example uses * the topic ID for Google Apps Script. * * Note that this sample limits the results to 25. To return more results, pass * additional parameters as documented here: * https://developers.google.com/youtube/v3/docs/search/list */ function searchByTopic() { var mid = '/m/0gjf126'; var results = YouTube.Search.list('id,snippet', {topicId: mid, maxResults: 25}); for(var i in results.items) { var item = results.items[i]; Logger.log('[%s] Title: %s', item.id.videoId, item.snippet.title); } }
Kanala abone ol
Bu örnek, etkin kullanıcıyı channelId ile belirtilen Google Developers YouTube kanalına abone eder./** * This sample subscribes the active user to the Google Developers * YouTube channel, specified by the channelId. */ function addSubscription() { // Replace this channel ID with the channel ID you want to subscribe to var channelId = 'UC_x5XG1OV2P6uZZ5FSM9Ttw'; var resource = { snippet: { resourceId: { kind: 'youtube#channel', channelId: channelId } } }; try { var response = YouTube.Subscriptions.insert(resource, 'snippet'); Logger.log(response); } catch (e) { if(e.message.match('subscriptionDuplicate')) { Logger.log('Cannot subscribe; already subscribed to channel: ' + channelId); } else { Logger.log('Error adding subscription: ' + e.message); } } }
Videoyu güncelle
Bu örnek, etkin kullanıcının yüklemelerini bulur ve ardından bir dize ekleyerek en son yüklemenin açıklamasını günceller./** * This sample finds the active user's uploads, then updates the most recent * upload's description by appending a string. */ function updateVideo() { // 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 videoID 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'); } }