YouTube Analytics सेवा

YouTube Analytics सेवा की मदद से, Apps Script में YouTube Analytics API का इस्तेमाल किया जा सकता है. इस एपीआई की मदद से उपयोगकर्ता, YouTube वीडियो और चैनल देखने के आंकड़े, लोकप्रियता की मेट्रिक, और डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह) से जुड़ी जानकारी पा सकते हैं.

ध्यान दें: यह एक बेहतर सेवा है, जिसे इस्तेमाल करने से पहले चालू करना ज़रूरी है.

रेफ़रंस

इस सेवा के बारे में ज़्यादा जानकारी के लिए, YouTube Analytics API के रेफ़रंस दस्तावेज़ देखें. Apps Script की सभी बेहतर सेवाओं की तरह, YouTube Analytics सेवा में भी उन ही ऑब्जेक्ट, तरीकों, और पैरामीटर का इस्तेमाल किया जाता है जिनका इस्तेमाल सार्वजनिक एपीआई के लिए किया जाता है. ज़्यादा जानकारी के लिए, हस्ताक्षर तय करने का तरीका लेख पढ़ें.

नमूना कोड

नीचे दिए गए सैंपल कोड में, YouTube Analytics API के वर्शन 2 के साथ-साथ, YouTube डेटा एपीआई के वर्शन 3 का इस्तेमाल किया गया है. इसे Apps Script में YouTube की सेवा से ऐक्सेस किया जा सकता है.

समस्याओं की शिकायत करने और दूसरी मदद पाने के लिए, YouTube API की सहायता गाइड देखें.

रिपोर्ट बनाएं

यह फ़ंक्शन एक स्प्रेडशीट बनाता है, जिसमें किसी चैनल के वीडियो पर हर दिन मिले व्यू, देखने के कुल समय की मेट्रिक, और चैनल के नए सदस्यों की संख्या शामिल होती है.

advanced/youtubeAnalytics.gs

GitHub पर देखें

/**
 * Creates a spreadsheet containing daily view counts, watch-time metrics,
 * and new-subscriber counts for a channel's videos.
 */
function createReport() {
  // Retrieve info about the user's YouTube channel.
  const channels = YouTube.Channels.list('id,contentDetails', {
    mine: true
  });
  const channelId = channels.items[0].id;

  // Retrieve analytics report for the channel.
  const oneMonthInMillis = 1000 * 60 * 60 * 24 * 30;
  const today = new Date();
  const lastMonth = new Date(today.getTime() - oneMonthInMillis);

  const metrics = [
    'views',
    'estimatedMinutesWatched',
    'averageViewDuration',
    'subscribersGained'
  ];
  const result = YouTubeAnalytics.Reports.query({
    ids: 'channel==' + channelId,
    startDate: formatDateString(lastMonth),
    endDate: formatDateString(today),
    metrics: metrics.join(','),
    dimensions: 'day',
    sort: 'day'
  });

  if (!result.rows) {
    console.log('No rows returned.');
    return;
  }
  const spreadsheet = SpreadsheetApp.create('YouTube Analytics Report');
  const sheet = spreadsheet.getActiveSheet();

  // Append the headers.
  const headers = result.columnHeaders.map((columnHeader)=> {
    return formatColumnName(columnHeader.name);
  });
  sheet.appendRow(headers);

  // Append the results.
  sheet.getRange(2, 1, result.rows.length, headers.length)
      .setValues(result.rows);

  console.log('Report spreadsheet created: %s',
      spreadsheet.getUrl());
}

/**
 * Converts a Date object into a YYYY-MM-DD string.
 * @param {Date} date The date to convert to a string.
 * @return {string} The formatted date.
 */
function formatDateString(date) {
  return Utilities.formatDate(date, Session.getScriptTimeZone(), 'yyyy-MM-dd');
}

/**
 * Formats a column name into a more human-friendly name.
 * @param {string} columnName The unprocessed name of the column.
 * @return {string} The formatted column name.
 * @example "averageViewPercentage" becomes "Average View Percentage".
 */
function formatColumnName(columnName) {
  let name = columnName.replace(/([a-z])([A-Z])/g, '$1 $2');
  name = name.slice(0, 1).toUpperCase() + name.slice(1);
  return name;
}