Die folgenden Apps Script-Codebeispiele sind für YouTube Analytics API verfügbar. Sie können diese Codebeispiele aus dem Ordner apps-script des Beispiel-Repositorys für YouTube APIs auf GitHub herunterladen.
YouTube Analytics-Daten in Google Tabellen exportieren
Diese Funktion verwendet die YouTube Analytics API, um Daten zum Kanal des authentifizierten Nutzers abzurufen. Dabei wird eine neue Google-Tabelle mit den Daten im Drive des Nutzers erstellt.
Der erste Teil dieses Beispiels zeigt einen einfachen Aufruf der YouTube Analytics API. Diese Funktion ruft zuerst die Kanal-ID des aktiven Nutzers ab. Mithilfe dieser ID führt die Funktion einen YouTube Analytics API-Aufruf aus, um Aufrufe, „Mag ich“- bzw. „Mag ich nicht“-Bewertungen und geteilte Inhalte der letzten 30 Tage abzurufen. Die API gibt die Daten in einem Antwortobjekt zurück, das ein 2D-Array enthält.
Im zweiten Teil des Beispiels wird eine Tabelle erstellt. Diese Tabelle wird im Google Drive-Konto des authentifizierten Nutzers mit dem Namen „YouTube-Bericht“ und dem Zeitraum im Titel platziert. Die Funktion füllt die API mit der API-Antwort aus und sperrt dann Spalten und Zeilen, die eine Diagrammachse definieren. Für die Tabelle wird ein gestapeltes Säulendiagramm hinzugefügt.
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(
'channel==' + channelId,
oneMonthAgoFormatted,
todayFormatted,
'views,likes,dislikes,shares',
{
dimensions: 'day',
sort: '-day'
});
// 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);
}