نمونه‌های کد Apps Script

نمونه‌های کد Apps Script زیر برای YouTube Data API دردسترس است. می‌توانید این نمونه کدها را از پوشه apps-script در مخزن نمونه کد YouTube APIs در GitHub بارگیری کنید.

بازیابی بارگذاری‌های من

این تابع ویدیوهای بارگذاری‌شده کاربر فعلی نوشتار را بازیابی می‌کند. برای اجرا، به دامنه خواندن/نوشتن OAuth برای YouTube و همچنین مجوز کاربر نیاز دارد. در محیط زمان اجرای Apps Script، اولین‌باری که کاربر یک دستورگان را اجرا می‌کند، Apps Script از کاربر می‌خواهد که اجازه دسترسی به سرویس‌های فراخوانده‌شده توسط دستورگان را بدهد. پس‌از اعطای اجازه‌ها، آن‌ها برای مدتی در حافظه نهان ذخیره می‌شوند. وقتی مجوزهای موردنیاز تغییر کند یا وقتی با عملکرد ScriptApp.invalidateAuth() باطل شود، از کاربری که اسکریپت را اجرا می‌کند دوباره درخواست مجوز می‌شود.

این دستورگان مراحل زیر را برای بازیابی ویدیوهای بارگذاری‌شده کاربر فعال انجام می‌دهد:

1. کانال‌های کاربر را واکشی می‌کند.
2. فهرست پخش «بارگذاری‌های» کاربر را واکشی می‌کند.
3. این فهرست پخش را تکرار می‌کند و شناسه‌ها و عنوان‌های ویدیو را ثبت می‌کند.
4. درصورت وجود، کد صفحه بعدی را واکشی می‌کند. اگر وجود داشته باشد، صفحه بعدی را واکشی می‌کند. مرحله ۳ را تکرار کنید.

/**
 * 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;
    }
  }
}

جستجو براساس کلیدواژه

این تابع ویدیوهای مرتبط با کلیدواژه 'dogs' را جستجو می‌کند. شناسه‌ها و عنوان‌های ویدیوهای نتایج جستجو در گزارش Apps Script ثبت می‌شوند.

توجه داشته باشید که این نمونه نتایج را به ۲۵ محدود می‌کند. برای برگرداندن نتایج بیشتر، پارامترهای اضافی را همان‌طور که در Search:list مستند شده است ارسال کنید.

/**
 * 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);
  }
}

جستجو براساس موضوع

این تابع ویدیوهایی را که با موضوع خاصی در Freebase مرتبط هستند جستجو می‌کند و شناسه و عنوان آن‌ها را در گزارش Apps Script ثبت می‌کند. این مثال از شناسه موضوع برای Google Apps Script استفاده می‌کند.

توجه داشته باشید که این نمونه نتایج را به ۲۵ محدود می‌کند. برای برگرداندن نتایج بیشتر، پارامترهای اضافی را همان‌طور که در Search:list مستند شده است ارسال کنید.

/**
 * 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);
  }
}

مشترک شدن در کانال

این نمونه کاربر فعال را در کانال YouTube توسعه‌دهندگان Google که با channelId مشخص شده است مشترک می‌کند.

/**
 * 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);
    }
  }
}

به‌روزرسانی ویدیو

این نمونه بارگذاری‌های کاربر فعال را پیدا می‌کند، سپس شرح جدیدترین بارگذاری را با افزودن یک رشته به‌روز می‌کند.

/**
 * 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');
  }
}