Exemples de code Apps Script

Pour exécuter des exemples de code, vous devez activer l'API YouTube Data et l'API YouTube Analytics (v2) dans Apps Script. Le guide de démarrage rapide de l'API Data explique comment ajouter un service.

Exporter des données YouTube Analytics vers Google Sheets

Cette fonction utilise l'API YouTube Analytics pour extraire des données sur la chaîne de l'utilisateur authentifié, puis crée une feuille de calcul Google Sheets dans Drive avec ces données.

La première partie de cet exemple illustre un appel d'API YouTube Analytics simple. Cette fonction récupère d'abord l'ID de chaîne de l'utilisateur actif. À l'aide de cet ID, la fonction effectue un appel d'API YouTube Analytics pour récupérer les vues, les "J'aime", les "Je n'aime pas" et les partages des 30 derniers jours. L'API renvoie les données dans un objet de réponse contenant un tableau 2D.

La deuxième partie de l'exemple crée une feuille de calcul. Cette feuille de calcul est placée dans Google Drive de l'utilisateur authentifié, avec le nom "Rapport YouTube" et la période dans le titre. La fonction renseigne la feuille de calcul avec la réponse de l'API, puis verrouille les colonnes et les lignes qui définiront les axes du graphique. Un histogramme empilé est ajouté à la feuille de calcul.

  function spreadsheetAnalytics() {
    // Get the channel ID
    var myChannels = YouTube.Channels.list('id', {mine: true});
    var channel = myChannels.items[0];
    var channelId = channel.id;
  
    // Set the dates for our report
    var today = new Date();
    var oneMonthAgo = new Date();
    oneMonthAgo.setMonth(today.getMonth() - 1);
    var todayFormatted = Utilities.formatDate(today, 'UTC', 'yyyy-MM-dd')
    var oneMonthAgoFormatted = Utilities.formatDate(oneMonthAgo, 'UTC', 'yyyy-MM-dd');
  
    // The YouTubeAnalytics.Reports.query() function has four required parameters and one optional
    // parameter. The first parameter identifies the channel or content owner for which you are
    // retrieving data. The second and third parameters specify the start and end dates for the
    // report, respectively. The fourth parameter identifies the metrics that you are retrieving.
    // The fifth parameter is an object that contains any additional optional parameters
    // (dimensions, filters, sort, etc.) that you want to set.
    var analyticsResponse = YouTubeAnalytics.Reports.query({
      "startDate": oneMonthAgoFormatted,
      "endDate": todayFormatted,
      "ids": "channel==" + channelId,
      "dimensions": "day",
      "sort": "-day",
      "metrics": "views,likes,dislikes,shares"
    });
  
    // Create a new Spreadsheet with rows and columns corresponding to our dates
    var ssName = 'YouTube channel report ' + oneMonthAgoFormatted + ' - ' + todayFormatted;
    var numRows = analyticsResponse.rows.length;
    var numCols = analyticsResponse.columnHeaders.length;
  
    // Add an extra row for column headers
    var ssNew = SpreadsheetApp.create(ssName, numRows + 1, numCols);
  
    // Get the first sheet
    var sheet = ssNew.getSheets()[0];
  
    // Get the range for the title columns
    // Remember, spreadsheets are 1-indexed, whereas arrays are 0-indexed
    var headersRange = sheet.getRange(1, 1, 1, numCols);
    var headers = [];
  
    // These column headers will correspond with the metrics requested
    // in the initial call: views, likes, dislikes, shares
    for(var i in analyticsResponse.columnHeaders) {
      var columnHeader = analyticsResponse.columnHeaders[i];
      var columnName = columnHeader.name;
      headers[i] = columnName;
    }
    // This takes a 2 dimensional array
    headersRange.setValues([headers]);
  
    // Bold and freeze the column names
    headersRange.setFontWeight('bold');
    sheet.setFrozenRows(1);
  
    // Get the data range and set the values
    var dataRange = sheet.getRange(2, 1, numRows, numCols);
    dataRange.setValues(analyticsResponse.rows);
  
    // Bold and freeze the dates
    var dateHeaders = sheet.getRange(1, 1, numRows, 1);
    dateHeaders.setFontWeight('bold');
    sheet.setFrozenColumns(1);
  
    // Include the headers in our range. The headers are used
    // to label the axes
    var range = sheet.getRange(1, 1, numRows, numCols);
    var chart = sheet.newChart()
                     .asColumnChart()
                     .setStacked()
                     .addRange(range)
                     .setPosition(4, 2, 10, 10)
                     .build();
    sheet.insertChart(chart);
  
  }